Synchronisation et intégrations

La synchronisation reproduit automatiquement dans Users les personnes issues de vos autres systèmes, afin que l'accès aux portes suive les données des sources externes sans saisie manuelle. Cette page présente les trois sources de synchronisation, la synchronisation du personnel Performance Hub, les identifiants, les Access Time Windows détenues par la source, la fraîcheur et le mappage des portées, les suppressions, la résolution des doublons, le panneau d'activité de synchronisation, les invitations et la suppression en masse. Tout se configure sous Settings → Sync settings.

La synchronisation Performance Hub staff est activée par défaut. Les synchronisations des intégrations et de Computer Vision sont désactivées par défaut afin que les installations existantes conservent leur liste gérée manuellement ; rien n'est synchronisé depuis ces sources tant que vous ne les activez pas.

Sources de synchronisation

Figure 1 : Sync settings

Chaque bloc dispose de son propre interrupteur d'activation et affiche l'heure de sa dernière exécution et ses compteurs (ou Never run).

Pour la source Integrations, vous pouvez également inclure ou exclure chaque intégration sous Sync from these integrations : « Désactivez une intégration pour cesser de reproduire ses personnes. Les personnes déjà synchronisées restent jusqu'à ce que vous les supprimiez. » Show all integrations affiche la liste complète.

Identifiant obligatoire

Les personnes se connectent à l'application mobile avec un code à usage unique envoyé sur leur téléphone ou par e-mail : un enregistrement sans l'un ni l'autre est donc inutile pour l'accès aux portes. La liste déroulante Require identifier détermine quels enregistrements sont synchronisés :

Les enregistrements qui ne remplissent pas la condition sont ignorés (et apparaissent dans le panneau d'activité de synchronisation comme ignorés en raison d'un identifiant manquant).

Mappage des Access Time Windows et fraîcheur de la source

Chaque intégration qui fournit des Access Time Windows dispose de ses propres paramètres :

• Access Time Window mapping : « Associez chaque clé de portée du partenaire à des portes de l'installation ou à des Access Scopes. Les clés inconnues et non mappées échouent en mode fermé. » Chaque intégration peut avoir jusqu'à 50 mappages, y compris la clé default. Ajoutez une clé sous Add partner scope key.
• Source freshness policy : un paramètre de sécurité : « Choisissez l'ancienneté maximale d'un instantané du partenaire avant que toutes ses fenêtres n'échouent en mode fermé. » Réglez-le en fonction de la fréquence à laquelle l'intégration s'engage à envoyer des mises à jour, afin que les fenêtres d'une intégration qui ne se met plus à jour ne continuent pas d'accorder l'accès.

Consultez Instantanés des Access Time Windows pour savoir comment les fenêtres des intégrations sont mises à jour.

Personnel Performance Hub

Figure 2 : La source Performance Hub staff

« Toute personne dont les rôles Performance Hub couvrent cette installation est ajoutée automatiquement à Users et maintenue à jour avec Performance Hub IAM. » Par exemple, le personnel des magasins d'une chaîne de distribution obtient l'accès à la porte de l'arrière-boutique sans que personne ait à l'ajouter manuellement.

• Le personnel (les utilisateurs Performance Hub) est synchronisé avec les étiquettes Performance Hub staff, Role: … (une par rôle) et, pour les administrateurs de l'organisation, Organisation admin.
• Une Access Policy modifiable Performance Hub staff est créée une fois par installation et laisse passer cette étiquette par toutes les portes à tout moment. La carte indique si la politique est active, avec Edit policy. Modifiez-la ou désactivez-la comme n'importe quelle Access Policy.
• Rôles indique les rôles inclus. Les rôles à inclure ou à exclure sont définis par un administrateur de l'organisation dans Organisation Settings ; les autres administrateurs voient « Ask an organisation admin to change this in Organisation Settings. »
• La désactivation de la synchronisation demande une confirmation (« Turn off Performance Hub staff sync? »).

Les informations du personnel sont gérées dans Performance Hub IAM et sont en lecture seule dans Users. Pour mettre fin à l'accès aux portes d'un membre du personnel, consultez Users → Personnel Performance Hub.

Quand la synchronisation s'exécute

Ce que la synchronisation met à jour, et ce qu'elle ne touche jamais

À chaque passage, les lignes synchronisées sont actualisées à partir de la source :

Vous pouvez donc sans risque désactiver un utilisateur synchronisé, lui accorder des autorisations ou lui ajouter des étiquettes : la synchronisation ne l'annulera pas.

Découplage : la désactivation de Track source updates dans le panneau d'un utilisateur fait que la synchronisation ignore entièrement cette ligne : les modifications du nom et des coordonnées sont conservées, et les suppressions dans la source ne l'affectent plus. Consultez Users.

Pour une source qui fournit des Access Time Windows, le découplage efface également les fenêtres de cette source après une confirmation explicite. Le recouplage les rétablit lors du prochain instantané complet réussi ; il ne rétablit pas les fenêtres mises en cache issues d'une récupération ayant échoué.

Suppressions

Lorsqu'un membre est supprimé dans l'intégration, son accès aux portes est retiré (Removed by integration). Sa ligne dans Users n'est pas supprimée, ce qui permet de conserver son historique.

Si une synchronisation devait supprimer un nombre inhabituellement élevé de personnes en une seule fois, ces suppressions sont mises en attente pour examen (N removals held back for review). Les suppressions provenant d'une intégration qui dépassent un seuil de sécurité attendent qu'un administrateur les examine avant d'être appliquées, afin qu'une récupération défectueuse depuis une intégration ne puisse pas retirer l'accès à tout le monde en même temps.

Instantanés des Access Time Windows

Chaque intégration ne met à jour que sa propre partition de source. Sa mise à jour des membres est un instantané complet des fenêtres, à révisions monotones :

• L'omission des données de fenêtre laisse l'instantané actuel de la source inchangé.
• Un instantané plus récent remplace la liste complète de cette source.
• La même révision avec la même charge utile normalisée constitue une relecture idempotente.
• La même révision avec des données différentes constitue un conflit ; une révision plus ancienne est ignorée car obsolète.
• Un instantané vide plus récent révoque explicitement les fenêtres de cette source.
• Une récupération en amont ayant échoué ou incomplète ne doit envoyer aucun instantané, jamais un instantané vide ou partiel.

Chaque scope_key stable de la source (y compris default) est associée à des cibles à l'échelle de l'installation, à des portes ou à des Access Scopes sous Mappage des Access Time Windows. Les mappages inconnus ou désactivés échouent en mode fermé. Les paramètres indiquent également l'ancienneté de la source et la politique de fraîcheur de la source de l'intégration.

Résolution des doublons

Figure 3 : Résolution des doublons

« Lorsque deux personnes partagent une adresse e-mail ou un numéro de téléphone, une seule peut être synchronisée dans Users. Choisissez qui conserve la place ; l'autre est signalée comme un conflit et n'est pas synchronisée. »

• Prefer the active person : « Une personne ayant un statut actif l'emporte toujours sur une personne dont le statut a expiré. Désactivez cette option pour appliquer le critère de départage quel que soit le statut. »
• Tiebreaker : utilisé lorsque le statut ne permet pas de désigner un gagnant, par exemple Oldest By Date Of Birth, Then Earliest Start Date.

L'autre enregistrement affiche Not synced – duplicate dans Users et est comptabilisé dans la vignette Not synced. Par exemple, une clinique peut conserver un seul enregistrement lorsqu'un praticien est à la fois membre du personnel et patient membre.

Invitations automatiques à l'application

Sous App invitations, Auto-send app invitations envoie un e-mail aux utilisateurs synchronisés éligibles qui n'ont pas encore reçu d'invitation, et Advanced recipient rules permet de limiter les destinataires. Send invitations… envoie des invitations en masse aux utilisateurs existants après que vous avez examiné la liste des destinataires. Tous les détails figurent dans Invitations.

Activité de synchronisation et dépannage

Développez Sync activity & troubleshooting pour « voir pourquoi des enregistrements récents ont été synchronisés ou non. » Vous pouvez rechercher par nom, ID ou motif, et actualiser la liste avec Refresh. Chaque entrée comporte un badge de résultat :

Motifs d'exclusion que vous pouvez rencontrer :

Cliquer sur une entrée ouvre Sync activity detail avec l'enregistrement complet : nom, ID externe, source, intégration, motif et ID utiles pour une escalade auprès de l'assistance.

Suppression en masse des utilisateurs synchronisés

Pour supprimer les utilisateurs issus d'une intégration (par exemple après l'avoir déconnectée), utilisez Bulk delete synced users. Vous examinez la liste exacte avant toute suppression.

1. Sous Bulk delete synced users, cliquez sur Bulk delete…
2. Choisissez la portée : All integration-synced users ou une seule intégration. Cliquez sur Preview.
3. Vérifiez : la boîte de dialogue indique exactement combien d'utilisateurs seront supprimés (avec un échantillon de la liste). Tenez compte de l'avertissement : This cannot be undone, et toutes les personnalisations apportées par l'administrateur à ces lignes (autorisations, étiquettes personnalisées, notes) sont perdues. L'historique des journaux d'accès des utilisateurs est conservé.
4. Also turn off syncing from this integration (recommended) est cochée par défaut ; laissez-la cochée, sinon les mêmes utilisateurs seront recréés lors du prochain passage de synchronisation (sans leurs anciennes personnalisations).
5. Cochez I understand this is permanent and customisations will be lost, puis cliquez sur Delete N.

Si l'ensemble d'utilisateurs concerné a changé entre l'aperçu et la confirmation, il vous sera demandé de relancer l'aperçu : vous avez ainsi la garantie de supprimer exactement ce que vous avez examiné.

Pages associées

• Users : sources, découplage, panneau de l'utilisateur
• Plannings des Access Policies : plannings et paramètres Access Time Windows
• Invitations
• Dépannage : procédures pour les cas « utilisateur manquant / non à jour »