Référence
Sur cette page
Tableaux exhaustifs pour Door & Gate Access : chaque état d'événement, motif de refus, paramètre, valeur par défaut, limite et valeur d'option, regroupés en un seul endroit. Utilisez cette page pour vérifier la signification exacte d'une valeur ; les pages de guide associées expliquent comment utiliser chaque fonctionnalité.
États des événements d'accès
Affichés dans les Journaux d'accès :
| État | Signification |
|---|---|
| Request received | La demande de déverrouillage est arrivée et est en cours d'évaluation (transitoire) |
| Pending | La demande a passé les vérifications et attend d'être transmise (transitoire) |
| Unlocked | Le déverrouillage a été signalé comme réussi |
| Confirmed unlocked | Le contrôleur de porte a confirmé la libération du relais |
| Admin Unlocked | Un administrateur a déclenché le déverrouillage depuis Performance Hub (remplacement administrateur) ; enregistré au moment où la commande est transmise |
| Denied | La demande a été rejetée : consultez le motif de refus dans l'événement |
| Timed out | La commande a été envoyée, mais le contrôleur ne l'a pas confirmée à temps |
| Failed | Le déverrouillage n'a pas pu aboutir en raison d'une erreur |
| Locked by staff | Le personnel a utilisé Lock now pendant que le planning de déverrouillage automatique maintenait la porte ouverte (événement de planning, et non tentative de déverrouillage) |
| Schedule resumed | Le planning de déverrouillage automatique a repris la main (événement de planning, et non tentative de déverrouillage) |
Cycle de vie d'un événement : reçu → transmis → déverrouillage confirmé / refusé / délai dépassé / échec.
Motifs de refus
Chaque déverrouillage refusé ou en échec enregistre un motif. Le tableau associe chaque motif au message vu par le membre et à la manière de résoudre le problème :
| Motif (tel qu'enregistré) | Message vu par le membre | Cause | Solution |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Le commutateur Access enabled de l'utilisateur est désactivé | Réactivez-le dans le panneau de l'utilisateur dans Users |
no_matching_policy_or_grant | "You don't have access to this door" | Aucune Access Policy ne correspondait à Who ET Where ET When, et aucune voie d'autorisation cumulative n'a accordé l'accès | Vérifiez les Access Policies, les attributs de l'utilisateur, les cibles et exclusions, le planning et les autorisations |
no_matching_policy_target | "You don't have access to this door" | Aucune Access Policy activée ne cible cette porte pour la demande | Ajoutez la porte ou son Access Scope à une politique, ou utilisez une cible portant sur toutes les portes |
no_matching_policy_audience | "You don't have access to this door" | Des politiques ciblent la porte, mais aucune ne correspond au type, au statut ou aux tags de la personne | Vérifiez la section Who de la politique et la fiche Users |
outside_policy_schedule | "Outside allowed access hours" | Who et Where correspondent, mais tous les plannings des politiques correspondantes sont inactifs ou expirés | Vérifiez la section When de la politique et le fuseau horaire de l'installation |
outside_geofence | "Move closer — you're outside the location's geofence." | La position signalée se trouve au-delà de rayon + précision GPS + marge par rapport au centre de la geofence | Le membre se rapproche ; ou vérifiez le rayon et le repère de la geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | La précision GPS du téléphone est moins bonne que le seuil Require GPS accuracy better than | Le membre réessaie à l'extérieur ou à l'écart des interférences ; ou augmentez le seuil |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Le téléphone n'a pas signalé de position exploitable | Le membre active la localisation (Precise) pour l'application |
geofence_misconfigured | Déverrouillage refusé | La geofence est activée mais son centre ou son repère est absent : le système se met en position de sécurité fermée | Placez le repère de la geofence dans Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Le contrôleur de porte ne s'est pas signalé (aucun signal de présence depuis 5 minutes) | Rétablissez l'alimentation ou la connexion réseau du contrôleur : consultez Dépannage |
user_deleted | "You don't have access…" | La fiche Users a été supprimée | Recréez ou restaurez l'utilisateur |
outside_access_time_window | Porte désactivée, avec sa prochaine disponibilité lorsqu'elle est connue | Une fenêtre future est la seule voie d'autorisation possible pour l'utilisateur et n'est pas encore active | Vérifiez la disponibilité fournie, le fuseau horaire, la fraîcheur de la source et le mappage ; les Access Policies et les autorisations continuent de s'appliquer indépendamment |
Certaines versions de l'application affichent le message plus général « You don't have access to this door » ou « Outside allowed access hours » pour les refus liés à une politique. Les Journaux d'accès conservent le motif détaillé pour les administrateurs.
Politiques d'accès
| Propriété | Signification |
|---|---|
| Structure d'une politique | Nom unique, description facultative, indicateur d'activation, destinataires Who, cibles et exclusions Where, planning When |
| Correspondance d'une politique | Who ET Where ET When |
| Plusieurs politiques | OU ; toute politique activée correspondante autorise l'accès |
| Who | Type de personne avec statuts facultatifs, OU tags synchronisés ou personnalisés ; aucun statut = n'importe quel statut |
| Where | Toutes les portes de l'installation, des Access Scopes, des portes individuelles ou des combinaisons ; les exclusions l'emportent au sein de cette politique |
| When | Anytime, ou fenêtres Weekly/One-time combinées par un OU |
| Autres voies d'autorisation | Les autorisations permanentes et les fenêtres d'administrateur ou d'intégration restent distinctes et cumulatives |
| Sécurité | Les utilisateurs supprimés, désactivés ou bloqués par la synchronisation, la suppression ou le blocage de la porte, la maintenance, la geofence, les limites de fréquence et les vérifications du contrôleur s'appliquent toujours |
| Configuration existante | Importée automatiquement dans des politiques nommées équivalentes avec des valeurs Who, Where et When explicites |
Attribution des politiques
Les Journaux d'accès identifient une politique correspondante par son nom et peuvent afficher ses destinataires, sa cible et son planning. Les correspondances planifiées peuvent également inclure le début et la fin concrets actifs.
Référence des Access Time Windows
| Propriété | Signification |
|---|---|
| Autorisation | Les fenêtres de planning d'une politique constituent son When ; les fenêtres d'administrateur ou d'intégration sont des voies d'autorisation distinctes et cumulatives |
| Borne absolue | Instants UTC entiers en secondes Unix, [from, to) |
| Fuseau horaire absolu | Métadonnée d'affichage et d'audit ; ne décale pas les horodatages |
| Borne hebdomadaire | Plages locales HH:mm avec fin exclue |
| Fuseau horaire hebdomadaire | Fuseau horaire IANA valide qui détermine le jour et l'heure murale ainsi que l'heure d'été |
| Bornes hebdomadaires | Dates de début et de fin d'activité facultatives en secondes Unix ; fin exclue |
| Nuit / chevauchement | Non acceptés ; répartissez les périodes nocturnes sur plusieurs jours et évitez tout chevauchement des plages |
| Propriété des fenêtres utilisateur | L'administrateur et chaque source d'intégration sont isolés ; l'un ne peut pas effacer les fenêtres d'un autre |
| Portée d'intégration | scope_key source stable, default par défaut, mappée à des cibles PH ; une clé inconnue ou non mappée est refusée par défaut |
| Fraîcheur de la source | Configurée selon la cadence de chaque intégration ; le comportement en cas de source obsolète doit être explicite |
| Sécurité | Ne contourne jamais les utilisateurs désactivés, supprimés ou en conflit, blockAllAccess, la maintenance, la geofence, les limites de fréquence ni les vérifications du contrôleur |
Limites initiales : 50 fenêtres par conteneur de politique, d'autorisation ou de source ; durée absolue maximale de 90 jours ; 120 caractères pour les identifiants, libellés et clés de portée ; huit plages hebdomadaires par jour ; les nouvelles entrées ne peuvent pas être déjà expirées depuis plus d'une heure.
Paramètres, valeurs par défaut et plages
Paramètres de porte
| Paramètre | Valeur par défaut | Plage / options |
|---|---|---|
| Hold time | 10 secondes | 1 à 30 secondes |
| Maintenance mode | Normal | Normal / Force open / Force closed |
| Door open sound | Désactivé | Activé / Désactivé |
| Étiquette Door location | — | Texte libre, 64 caractères maximum |
| Icon | Door | 10 options (ci-dessous) |
| Planning de déverrouillage automatique | Désactivé | Heures de présence du personnel de l'installation ou Custom schedule, fuseau horaire de l'installation |
| Heure de déverrouillage / verrouillage automatique | At opening / At closing | At opening / At closing, ou 5, 10, 15, 30, 45, 60, 90 ou 120 minutes avant ou après |
| Déverrouillage automatique les jours fériés | Ignore holidays | Suivre les horaires des jours fériés de l'installation / Stay locked all day / Ignore holidays |
| Autorisation d'accès (par porte) | Access Policies | Répertorie les politiques correspondantes et permet blockAllAccess |
| Geofence (par porte) | Hériter de l'installation | Hériter de l'installation / Override for this door / Disable geofence for this door |
| Seuil de connexion | — | Le contrôleur est considéré comme en ligne s'il a envoyé un signal de présence au cours des 5 dernières minutes |
Icônes de porte
| Icône | Usage prévu |
|---|---|
| Door | Porte simple standard (par défaut) |
| Sliding door | Porte coulissante ou automatique |
| Double door | Porte double ou porte-fenêtre |
| Garage | Porte de garage ou porte enroulable |
| Boom gate | Barrière levante |
| Pedestrian | Entrée piétonne ou du personnel |
| Security | Porte à accès restreint ou de sécurité |
| Office | Bureau ou local réservé au personnel |
| Delivery | Quai de chargement ou zone de livraison |
| Locker | Casier ou rangement |
Paramètres de geofence
| Paramètre | Valeur par défaut | Plage |
|---|---|---|
| Geofence activée | Activée (pour une nouvelle configuration d'installation) | Activée / Désactivée |
| Radius | 200 m | 50–5000 m (pas de 10 m ; préréglages 50 / 200 / 500 / 1000 m) |
| Accuracy buffer | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Formule de tolérance | — | rayon + précision GPS signalée + marge de précision |
Périodes de tolérance d'accès
Sous Settings → Access Time Windows :
| Paramètre | Options |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 minutes |
| Allow access after end | Off / 5 / 10 / 15 / 30 minutes |
Paramètres de verrouillage de l'application
| Paramètre | Valeur par défaut | Options |
|---|---|---|
| Imposer le verrouillage de l'application pour cette installation | Désactivé | Activé / Désactivé |
| Délai de grâce avant une nouvelle demande | 5 minutes | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Comportement multi-installations | — | Imposé si l'une des installations associées l'impose ; le délai de grâce le plus court parmi les installations qui l'imposent l'emporte |
Contacts d'assistance
| Mode | Comportement |
|---|---|
| Smart (default) | Affichés automatiquement lorsqu'une porte est hors ligne ou que les informations sont limitées dans l'interface |
| Always show | Toujours affichés sur le tableau de bord de l'application |
| Never show | Jamais affichés |
Messages de l'application
| Champ | Limite / options |
|---|---|
| Notification type | Information / Notice / Urgent |
| Title | 120 caractères |
| Body | 2000 caractères (avertissement non bloquant à 500) |
| Link URL | http(s) uniquement, 2000 caractères |
| Link label | 80 caractères, « More info » par défaut |
| Schedule | Starts at / Ends at facultatifs |
| Espaces réservés (règles automatiques) | {firstName}, {lastName} |
| Champs de correspondance des règles automatiques | Membership status / Person type / Tag (les tags correspondent aux tags synchronisés et personnalisés, sans distinction de casse) / Door visibility |
| Priorité des règles | La première règle activée correspondante l'emporte (ordre de la liste) |
Champs utilisateur
| Champ | Limite / remarques |
|---|---|
| Prénom / nom | 80 caractères chacun |
| Téléphone mobile / e-mail | Au moins l'un des deux est obligatoire (utilisé pour la connexion par code à usage unique) ; les numéros de téléphone sont normalisés au format international |
| Tags | 80 caractères par tag ; les tags synchronisés sont écrasés par la synchronisation, les tags personnalisés sont gérés par les administrateurs |
| Notes | 2000 caractères |
| Access enabled | Activé par défaut ; désactivé = tous les déverrouillages sont refusés |
| Autorisations | À l'échelle de l'installation, liste de portes, liste de portées, horaires d'ouverture facultatifs |
| Access Policies | Un utilisateur peut être couvert par une ou plusieurs politiques nommées ; la liste et l'accès effectif utilisent Access granted via policy |
| Access Time Windows | Fenêtres modifiables gérées par l'administrateur, et fenêtres en lecture seule gérées par la source ; distinctes des plannings des politiques |
Sources, statuts et autres énumérations
| Énumération | Valeurs |
|---|---|
| Source de l'utilisateur | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Vignettes utilisateurs | All users / Has access / No access / Not synced |
| Statut d'invitation | Not invited / Invited / Send failed |
| Destinataires des invitations | Only users with door access / All eligible synced users |
| Champs des règles d'invitation | Membership status / Person type / Tag / Sync source / Integration ; opérateurs is any of / is not any of |
| Vues des Journaux d'accès | Door events / No visit recorded |
| App adoption | Active (a utilisé l'application) / Not yet active |
| Identifiant requis (synchronisation) | Email OR phone (par défaut) / Email required / Phone required / Both required |
| Résultats du journal de synchronisation | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| États des fenêtres | Active / Upcoming / Expired / Stale / Unmapped |
| Libellés de statut d'adhésion | Active, Current, Expired, On hold, Cancelled, Pending (ainsi que toute valeur provenant de votre système source) |
| Modèles d'Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Modèles de messages automatiques | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Motifs d'ignorance lors de la synchronisation
| Motif affiché dans le journal de synchronisation | Signification |
|---|---|
| La synchronisation de l'intégration est désactivée pour cette installation | Le commutateur principal de la source est désactivé |
| Cette intégration est désactivée dans les paramètres de synchronisation | L'intégration concernée est exclue |
| Aucun téléphone ni e-mail dans la fiche (un téléphone ou un e-mail est requis pour se connecter) | La fiche ne respecte pas la règle Require identifier |
| La fiche est dissociée et gérée manuellement | Track source updates est désactivé pour cet utilisateur |
| Aucune installation dans la fiche source | La fiche source n'est pas associée à cette installation |
| Aucune fiche utilisateur correspondante | La modification concernait une personne sans ligne ici |
Limites opérationnelles
| Limite | Valeur |
|---|---|
| Import CSV | 200 utilisateurs par import |
| Invitations en masse | Envoyées par lots de 50 |
| Échantillon de l'aperçu de suppression en masse | 50 premiers utilisateurs affichés |
| Requête des Journaux d'accès | Jusqu'aux 500 événements les plus récents par fenêtre |
| Conservation des événements d'accès | ~13 mois, puis suppression automatique |
| Validité d'une commande de déverrouillage administrateur | 30 secondes (la commande expire si elle n'est pas transmise) |
| Signal de présence du contrôleur de porte | Toutes les ~30 secondes ; hors ligne après 5 minutes de silence |
| Demandes de code de connexion | 5 par heure par téléphone ou e-mail (limite de sécurité, ne peut pas être levée) |
| Propagation de la déconnexion de l'application | Révocation immédiate ; jusqu'à 15 minutes pour qu'une session active prenne totalement fin |
| Enregistrement des paramètres de porte | Recharge le contrôleur, généralement 10 à 15 secondes |
| Conservation de No visit recorded | ~13 mois |
| Mappages d'Access Time Windows | 50 par intégration |
| Access Time Windows par conteneur | 50 |
| Durée d'une fenêtre One-time | 90 jours |
| Plages Weekly | 8 par jour de la semaine |
| Identifiant de fenêtre ou de source, libellé, clé de portée | 120 caractères |
| Access Policies par installation | 100 |
| Total des fenêtres de politiques | 500 |
| Nom / identifiant d'une Access Policy | 120 caractères |
| Description d'une Access Policy | 500 caractères |
| Configuration des Access Policies | 300 KiB UTF-8 |