Sincronizzazione e integrazioni

La sincronizzazione replica automaticamente in Users le persone presenti negli altri tuoi sistemi, così l'accesso alle porte segue i dati delle fonti esterne senza inserimento manuale. Questa pagina tratta le tre fonti di sincronizzazione, la sincronizzazione del personale del Performance Hub, gli identificativi, le Access Time Windows di proprietà della fonte, l'aggiornamento dei dati e la mappatura degli ambiti, le rimozioni, la risoluzione dei duplicati, il pannello delle attività di sincronizzazione, gli inviti e l'eliminazione in blocco. Configura tutto in Settings → Sync settings.

La sincronizzazione di Performance Hub staff è attiva per impostazione predefinita. La sincronizzazione da integrazioni e da Computer Vision è disattivata per impostazione predefinita, in modo che le strutture esistenti mantengano il proprio elenco gestito manualmente: da queste fonti non viene sincronizzato nulla finché non attivi la fonte.

Fonti di sincronizzazione

Figura 1: Sync settings

Ogni blocco ha un proprio interruttore di attivazione e mostra l'ora dell'ultima esecuzione e i conteggi (oppure Never run).

Per la fonte Integrations puoi anche includere o escludere singole integrazioni in Sync from these integrations: "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations espande l'elenco completo.

Identificativo obbligatorio

Le persone accedono all'app mobile con un codice monouso inviato al loro telefono o indirizzo email, quindi un record privo di entrambi è inutile per l'accesso alle porte. Il menu a discesa Require identifier stabilisce quali record vengono sincronizzati:

I record che non soddisfano il requisito vengono ignorati (e compaiono nel pannello delle attività di sincronizzazione come ignorati per identificativo mancante).

Mappatura delle Access Time Windows e aggiornamento della fonte

Ogni integrazione che fornisce Access Time Windows ha le proprie impostazioni:

• Access Time Window mapping: "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Ogni integrazione può avere fino a 50 mappature, inclusa la chiave default. Aggiungi una chiave in Add partner scope key.
• Source freshness policy: un'impostazione di sicurezza: "Choose how old a partner snapshot may be before all of its windows fail closed." Impostala in base alla frequenza con cui l'integrazione si impegna a inviare aggiornamenti, così le finestre di un'integrazione che ha smesso di aggiornarsi non continuano a concedere l'accesso.

Vedi Snapshot delle Access Time Windows per sapere come vengono aggiornate le finestre delle integrazioni.

Personale di Performance Hub

Figura 2: la fonte Performance Hub staff

"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Ad esempio, il personale dei punti vendita di una catena retail ottiene l'accesso alla porta del retro senza che nessuno debba aggiungerlo a mano.

• Il personale (utenti del Performance Hub) viene sincronizzato con i tag Performance Hub staff, Role: … (uno per ruolo) e, per gli amministratori dell'organizzazione, Organisation admin.
• Una Access Policy modificabile Performance Hub staff viene creata una sola volta per struttura e consente a quel tag di passare da ogni porta in qualsiasi momento. La scheda indica se la policy è attiva, con Edit policy. Modificala o disattivala come qualsiasi Access Policy.
• Ruoli mostra quali ruoli sono inclusi. I ruoli da includere o escludere vengono impostati da un amministratore dell'organizzazione in Organisation Settings; gli altri amministratori vedono "Ask an organisation admin to change this in Organisation Settings."
• La disattivazione della sincronizzazione richiede una conferma ("Turn off Performance Hub staff sync?").

I dati del personale sono gestiti in Performance Hub IAM e in Users sono di sola lettura. Per revocare l'accesso alle porte a un membro del personale, vedi Users → Performance Hub staff.

Quando viene eseguita la sincronizzazione

Cosa aggiorna la sincronizzazione e cosa non tocca mai

A ogni passaggio, le righe sincronizzate vengono aggiornate dalla fonte:

Puoi quindi disattivare tranquillamente un utente sincronizzato, assegnargli autorizzazioni o aggiungergli tag: la sincronizzazione non annullerà queste modifiche.

Disaccoppiamento: disattivando Track source updates nel pannello di un utente, la sincronizzazione ignora completamente quella riga: le modifiche a nome e recapiti vengono mantenute e le rimozioni nella fonte non hanno più effetto su di essa. Vedi Users.

Per una fonte che fornisce Access Time Windows, il disaccoppiamento cancella anche le finestre di quella fonte dopo una conferma esplicita. Il riaccoppiamento le ripristina al successivo snapshot completo riuscito; non ripristina le finestre memorizzate nella cache da un recupero non riuscito.

Rimozioni

Quando un membro viene eliminato nell'integrazione, il suo accesso alle porte viene rimosso (Removed by integration). La sua riga in Users non viene eliminata, quindi il suo storico viene conservato.

Se una sincronizzazione dovesse rimuovere un numero insolitamente elevato di persone in una sola volta, quelle rimozioni vengono invece trattenute per la revisione (N removals held back for review). Le rimozioni provenienti da un'integrazione che superano un limite di sicurezza attendono la revisione di un amministratore prima di essere applicate, così un recupero difettoso da un'integrazione non può revocare l'accesso a tutti in una volta.

Snapshot delle Access Time Windows

Ogni integrazione aggiorna solo la propria partizione della fonte. Il suo aggiornamento dei membri è uno snapshot completo delle finestre, con revisioni monotonamente crescenti:

• L'omissione dei dati delle finestre lascia invariato lo snapshot corrente della fonte.
• Uno snapshot più recente sostituisce l'elenco completo di quella fonte.
• La stessa revisione con lo stesso payload normalizzato è una riesecuzione idempotente.
• La stessa revisione con dati diversi è un conflitto; una revisione precedente viene ignorata in quanto obsoleta.
• Uno snapshot vuoto più recente revoca esplicitamente le finestre di quella fonte.
• Un recupero a monte non riuscito o incompleto non deve inviare alcuno snapshot, mai uno vuoto o parziale.

Ogni scope_key stabile della fonte (incluso default) viene mappato su destinazioni a livello di struttura, di porta o di Access Scope in Mappatura delle Access Time Windows. Le mappature sconosciute o disattivate falliscono in modalità chiusa. Le impostazioni mostrano anche l'età della fonte e la policy di aggiornamento della fonte dell'integrazione.

Risoluzione dei duplicati

Figura 3: risoluzione dei duplicati

"Quando due persone condividono un indirizzo email o un numero di telefono, solo una può essere sincronizzata in Utenti. Scegli chi mantiene lo slot; l'altra viene contrassegnata come conflitto e non sincronizzata."

• 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: usato quando lo stato non determina un vincitore, ad esempio Oldest By Date Of Birth, Then Earliest Start Date.

L'altro record mostra Not synced – duplicate in Users e viene conteggiato nel riquadro Not synced. Ad esempio, una clinica sanitaria può mantenere un solo record quando un medico è sia membro del personale sia membro paziente.

Inviti automatici all'app

In App invitations, Auto-send app invitations invia un'email agli utenti sincronizzati idonei che non hanno ancora ricevuto un invito, e Advanced recipient rules può limitare chi li riceve. Send invitations… invia gli inviti in blocco agli utenti esistenti dopo che hai verificato l'elenco dei destinatari. Tutti i dettagli in Inviti.

Attività di sincronizzazione e risoluzione dei problemi

Espandi Sync activity & troubleshooting per "see why recent records did or did not sync." Puoi cercare per nome, ID o motivo e aggiornare l'elenco con Refresh. Ogni voce ha un badge con l'esito:

Motivi di esclusione che potresti vedere:

Facendo clic su una voce si apre Sync activity detail con il record completo: nome, ID esterno, fonte, integrazione, motivo e ID per l'escalation all'assistenza.

Eliminazione in blocco degli utenti sincronizzati

Per eliminare gli utenti provenienti da un'integrazione (ad es. dopo averla scollegata), usa Bulk delete synced users. Verifichi l'elenco esatto prima che venga eliminato qualsiasi elemento.

1. In Bulk delete synced users, fai clic su Bulk delete…
2. Scegli l'ambito: All integration-synced users oppure una singola integrazione. Fai clic su Preview.
3. Verifica: la finestra di dialogo mostra esattamente quanti utenti verranno rimossi (con un elenco di esempio). Presta attenzione all'avviso: This cannot be undone e qualsiasi personalizzazione dell'amministratore su quelle righe (autorizzazioni, tag personalizzati, note) va persa. Lo storico dei registri di accesso degli utenti viene conservato.
4. Also turn off syncing from this integration (recommended) è selezionata per impostazione predefinita: lasciala attiva, altrimenti gli stessi utenti vengono ricreati al passaggio di sincronizzazione successivo (senza le loro personalizzazioni precedenti).
5. Seleziona I understand this is permanent and customisations will be lost, quindi fai clic su Delete N.

Se l'insieme di utenti sottostante è cambiato tra l'anteprima e la conferma, ti verrà chiesto di rieseguire l'anteprima: in questo modo hai la garanzia di eliminare esattamente ciò che hai verificato.

Pagine correlate

• Users: fonti, disaccoppiamento, il pannello dell'utente
• Pianificazioni delle Access Policies: pianificazioni e impostazioni delle Access Time Windows
• Inviti
• Risoluzione dei problemi: procedure per "utente mancante / non aggiornato"