Synchronisierung und Integrationen

Die Synchronisierung spiegelt Personen aus Ihren anderen Systemen automatisch in Users, sodass der Türzugriff den Daten externer Quellen folgt, ohne dass etwas manuell erfasst werden muss. Diese Seite behandelt die drei Synchronisierungsquellen, die Synchronisierung von Performance Hub-Mitarbeitenden, Kennungen, quellenverwaltete Access Time Windows, Aktualität und Bereichszuordnung, Entfernungen, die Auflösung von Duplikaten, den Bereich für Synchronisierungsaktivitäten, Einladungen und das Massenlöschen. Alles wird unter Settings → Sync settings konfiguriert.

Die Synchronisierung von Performance Hub staff ist standardmäßig aktiviert. Die Synchronisierung über Integrationen und Computer Vision ist standardmäßig deaktiviert, damit bestehende Einrichtungen ihre manuell gepflegte Liste behalten; aus diesen Quellen wird nichts synchronisiert, bis Sie die Quelle aktivieren.

Synchronisierungsquellen

Abbildung 1: Sync settings

Jeder Block hat einen eigenen Schalter zum Aktivieren und zeigt den Zeitpunkt der letzten Ausführung sowie die Anzahlen an (oder Never run).

Für die Quelle Integrations können Sie außerdem einzelne Integrationen unter Sync from these integrations ein- oder ausschließen – "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Mit Show all integrations wird die vollständige Liste eingeblendet.

Kennung erforderlich

Personen melden sich bei der mobilen App mit einem Einmalcode an, der an ihr Telefon oder ihre E-Mail-Adresse gesendet wird. Ein Datensatz ohne beides ist für den Türzugriff daher nutzlos. Das Dropdown Require identifier steuert, welche Datensätze synchronisiert werden:

Datensätze, die die Anforderung nicht erfüllen, werden übersprungen (und erscheinen im Bereich für Synchronisierungsaktivitäten als wegen fehlender Kennung übersprungen).

Zuordnung von Access Time Windows und Aktualität der Quelle

Jede Integration, die Access Time Windows liefert, hat eigene Einstellungen:

• Access Time Window mapping – "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Jede Integration kann bis zu 50 Zuordnungen haben, einschließlich des Schlüssels default. Fügen Sie einen Schlüssel unter Add partner scope key hinzu.
• Source freshness policy – eine Sicherheitseinstellung: "Choose how old a partner snapshot may be before all of its windows fail closed." Legen Sie sie entsprechend der Häufigkeit fest, mit der die Integration Updates zu senden verspricht, damit Zeitfenster einer Integration, die keine Updates mehr sendet, nicht weiterhin Zugriff gewähren.

Unter Snapshots von Access Time Windows erfahren Sie, wie Zeitfenster aus Integrationen aktualisiert werden.

Performance Hub-Mitarbeitende

Abbildung 2: Die Quelle Performance Hub staff

"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." So erhalten beispielsweise die Filialmitarbeitenden einer Einzelhandelskette Zugang zur Tür des Lagerbereichs, ohne dass jemand sie manuell hinzufügen muss.

• Mitarbeitende (Performance Hub-Benutzer) werden mit den Tags Performance Hub staff, Role: … (eines pro Rolle) und, bei Organisationsadministratoren, Organisation admin synchronisiert.
• Pro Einrichtung wird einmalig eine bearbeitbare Access Policy Performance Hub staff erstellt, die dieses Tag jederzeit durch jede Tür lässt. Die Karte zeigt an, ob die Richtlinie aktiv ist, und bietet Edit policy. Bearbeiten oder deaktivieren Sie sie wie jede andere Access Policy.
• Roles zeigt an, welche Rollen eingeschlossen sind. Ein- oder auszuschließende Rollen legt ein Organisationsadministrator in den Organisation Settings fest; andere Administratoren sehen "Ask an organisation admin to change this in Organisation Settings."
• Das Deaktivieren der Synchronisierung erfordert eine Bestätigung ("Turn off Performance Hub staff sync?").

Die Daten der Mitarbeitenden werden in Performance Hub IAM verwaltet und sind in Users schreibgeschützt. Wie Sie den Türzugriff einer mitarbeitenden Person beenden, erfahren Sie unter Users → Performance Hub staff.

Wann die Synchronisierung läuft

Was die Synchronisierung aktualisiert – und was sie nie verändert

Bei jedem Durchlauf werden synchronisierte Zeilen aus der Quelle aktualisiert:

Sie können einen synchronisierten Benutzer also bedenkenlos deaktivieren, ihm Berechtigungen erteilen oder ihn taggen – die Synchronisierung macht das nicht rückgängig.

Entkoppeln: Wenn Sie im Bereich eines Benutzers Track source updates deaktivieren, überspringt die Synchronisierung diese Zeile vollständig – Änderungen an Name und Kontaktdaten bleiben erhalten, und Entfernungen in der Quelle wirken sich nicht mehr auf ihn aus. Siehe Users.

Bei einer Quelle, die Access Time Windows liefert, entfernt das Entkoppeln nach einer ausdrücklichen Bestätigung auch die Zeitfenster dieser Quelle. Durch erneutes Koppeln werden sie beim nächsten erfolgreichen vollständigen Snapshot wiederhergestellt; zwischengespeicherte Zeitfenster aus einem fehlgeschlagenen Abruf werden dabei nicht wiederhergestellt.

Entfernungen

Wenn ein Mitglied in der Integration gelöscht wird, wird sein Türzugriff entfernt (Removed by integration). Seine Zeile in Users wird nicht gelöscht, sodass sein Verlauf erhalten bleibt.

Würde eine Synchronisierung ungewöhnlich viele Personen auf einmal entfernen, werden diese Entfernungen stattdessen zur Prüfung zurückgehalten (N removals held back for review). Von Integrationen ausgelöste Entfernungen oberhalb eines Sicherheitslimits warten auf die Prüfung durch einen Administrator, bevor sie wirksam werden. So kann ein fehlerhafter Abruf aus einer Integration nicht allen auf einmal den Zugriff entziehen.

Snapshots von Access Time Windows

Jede Integration aktualisiert nur ihre eigene Quellpartition. Ihr Mitglieder-Update ist ein vollständiger, monoton revisionierter Snapshot der Zeitfenster:

• Fehlen die Zeitfensterdaten, bleibt der aktuelle Snapshot der Quelle unverändert.
• Ein neuerer Snapshot ersetzt die vollständige Liste dieser Quelle.
• Dieselbe Revision mit derselben normalisierten Nutzlast ist eine idempotente Wiederholung.
• Dieselbe Revision mit anderen Daten ist ein Konflikt; eine ältere Revision wird als veraltet übersprungen.
• Ein neuerer leerer Snapshot widerruft ausdrücklich die Zeitfenster dieser Quelle.
• Ein fehlgeschlagener oder unvollständiger Abruf aus dem Quellsystem darf keinen Snapshot senden, niemals einen leeren oder teilweisen.

Jeder stabile Quell-scope_key (einschließlich default) wird unter Zuordnung von Access Time Windows einrichtungsweiten Zielen, Türen oder Access Scopes zugeordnet. Unbekannte oder deaktivierte Zuordnungen schlagen geschlossen fehl. Die Einstellungen zeigen außerdem das Alter der Quelle und die Aktualitätsrichtlinie der Integration an.

Auflösung von Duplikaten

Abbildung 3: Auflösung von Duplikaten

"Wenn sich zwei Personen eine E-Mail-Adresse oder Telefonnummer teilen, kann nur eine davon in Benutzer synchronisiert werden. Legen Sie fest, wer den Platz behält; die andere Person wird als Konflikt markiert und nicht synchronisiert."

• Prefer the active person – "A person with an active status always wins over an expired one. Turn off to apply the tiebreaker regardless of status."
• Tiebreaker – wird verwendet, wenn der Status nicht über den Vorrang entscheidet, zum Beispiel Oldest By Date Of Birth, Then Earliest Start Date.

Der andere Datensatz zeigt in Users Not synced – duplicate an und wird in der Kachel Not synced mitgezählt. So kann beispielsweise eine Arztpraxis einen einzigen Datensatz behalten, wenn eine medizinische Fachkraft zugleich Mitarbeitende und Mitglied als Patient ist.

Automatische App-Einladungen

Unter App invitations sendet Auto-send app invitations berechtigten synchronisierten Benutzern, die noch keine Einladung erhalten haben, eine E-Mail, und mit Advanced recipient rules lässt sich einschränken, wer sie erhält. Send invitations… versendet Einladungen gesammelt an bestehende Benutzer, nachdem Sie die Empfängerliste geprüft haben. Alle Details finden Sie unter Einladungen.

Synchronisierungsaktivität und Fehlerbehebung

Erweitern Sie Sync activity & troubleshooting, um "see why recent records did or did not sync." Sie können nach Name, ID oder Grund suchen und die Liste mit Refresh aktualisieren. Jeder Eintrag hat ein Ergebnis-Badge:

Mögliche Gründe für das Überspringen:

Durch Klicken auf einen Eintrag wird Sync activity detail mit dem vollständigen Datensatz geöffnet: Name, externe ID, Quelle, Integration, Grund und IDs für die Eskalation an den Support.

Synchronisierte Benutzer gesammelt löschen

Um Benutzer zu entfernen, die aus einer Integration stammen (z. B. nachdem Sie sie getrennt haben), verwenden Sie Bulk delete synced users. Sie prüfen die genaue Liste, bevor etwas gelöscht wird.

1. Klicken Sie unter Bulk delete synced users auf Bulk delete…
2. Wählen Sie den Umfang: All integration-synced users oder eine einzelne Integration. Klicken Sie auf Preview.
3. Prüfen: Der Dialog zeigt genau an, wie viele Benutzer entfernt werden (mit einer Beispielliste). Beachten Sie die Warnung – This cannot be undone, und alle Anpassungen durch Administratoren an diesen Zeilen (Berechtigungen, benutzerdefinierte Tags, Notizen) gehen verloren. Der Verlauf der Zugriffsprotokolle der Benutzer bleibt erhalten.
4. Also turn off syncing from this integration (recommended) ist standardmäßig aktiviert – lassen Sie die Option aktiviert, da sonst dieselben Benutzer beim nächsten Synchronisierungsdurchlauf erneut angelegt werden (ohne ihre bisherigen Anpassungen).
5. Aktivieren Sie I understand this is permanent and customisations will be lost und klicken Sie dann auf Delete N.

Hat sich die zugrunde liegende Benutzermenge zwischen Vorschau und Bestätigung geändert, werden Sie aufgefordert, die Vorschau erneut auszuführen – so ist sichergestellt, dass Sie genau das löschen, was Sie geprüft haben.

Verwandte Seiten

• Users – Quellen, Entkoppeln, der Benutzerbereich
• Zeitpläne für Access Policies – Zeitpläne und die Einstellungen für Access Time Windows
• Einladungen
• Fehlerbehebung – Anleitungen zu "Benutzer fehlt / ist veraltet"