Sincronização e integrações

A sincronização espelha automaticamente as pessoas dos seus outros sistemas em Users, para que o acesso às portas acompanhe os dados das fontes externas sem entrada manual. Esta página aborda as três fontes de sincronização, a sincronização da equipe do Performance Hub, os identificadores, as Access Time Windows de propriedade da fonte, a atualidade e o mapeamento de escopos, as remoções, a resolução de duplicatas, o painel de atividade de sincronização, os convites e a exclusão em massa. Configure tudo em Settings → Sync settings.

A sincronização da Performance Hub staff vem ativada por padrão. A sincronização das integrações e do Computer Vision vem desativada por padrão, para que as instalações existentes mantenham a lista gerenciada manualmente; nada é sincronizado a partir delas até que você habilite a fonte.

Fontes de sincronização

Figura 1: Sync settings

Cada bloco tem o próprio interruptor de habilitação e mostra o horário da última execução e as contagens (ou Never run).

Na fonte Integrations, você também pode incluir ou excluir integrações individuais em Sync from these integrations — "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations expande a lista completa.

Exigir identificador

As pessoas entram no aplicativo móvel com um código de uso único enviado para o telefone ou o e-mail delas, portanto um registro sem nenhum dos dois é inútil para o acesso às portas. A lista suspensa Require identifier controla quais registros são sincronizados:

Os registros que não atendem ao requisito são ignorados (e aparecem no painel de atividade de sincronização como ignorados por falta de identificador).

Mapeamento de Access Time Windows e atualidade da fonte

Cada integração que fornece Access Time Windows tem as próprias configurações:

• Access Time Window mapping — "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Cada integração pode ter até 50 mapeamentos, incluindo a chave default. Adicione uma chave em Add partner scope key.
• Source freshness policy — uma configuração de segurança: "Choose how old a partner snapshot may be before all of its windows fail closed." Defina-a de acordo com a frequência com que a integração promete enviar atualizações, para que as janelas de uma integração que parou de se atualizar não continuem concedendo acesso.

Consulte Snapshots de Access Time Windows para saber como as janelas das integrações são atualizadas.

Equipe do Performance Hub

Figura 2: A 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." Por exemplo, a equipe das lojas de uma rede de varejo recebe acesso à porta da área interna sem que ninguém precise adicioná-la manualmente.

• A equipe (usuários do Performance Hub) é sincronizada com as marcações Performance Hub staff, Role: … (uma por função) e, para os administradores da organização, Organisation admin.
• Uma Access Policy editável Performance Hub staff é criada uma vez por instalação e permite a passagem dessa marcação por todas as portas, a qualquer momento. O cartão mostra se a política está ativa, com Edit policy. Edite-a ou desative-a como qualquer Access Policy.
• Funções mostra quais funções estão incluídas. As funções a incluir ou excluir são definidas por um administrador da organização em Organisation Settings; os outros administradores veem "Ask an organisation admin to change this in Organisation Settings."
• Desativar a sincronização pede uma confirmação ("Turn off Performance Hub staff sync?").

Os dados da equipe são gerenciados no IAM do Performance Hub e são somente leitura em Users. Para encerrar o acesso de um membro da equipe às portas, consulte Users → Performance Hub staff.

Quando a sincronização é executada

O que a sincronização atualiza — e o que ela nunca altera

A cada passagem, as linhas sincronizadas são atualizadas a partir da fonte:

Assim, você pode desativar um usuário sincronizado, dar concessões a ele ou marcá-lo com segurança — a sincronização não desfaz isso.

Desacoplamento: desativar Track source updates no painel de um usuário faz com que a sincronização ignore totalmente essa linha — as edições de nome e dados de contato permanecem, e as remoções na fonte deixam de afetá-lo. Consulte Users.

Para uma fonte que fornece Access Time Windows, o desacoplamento também limpa as janelas dessa fonte após uma confirmação explícita. O reacoplamento as restaura no próximo snapshot completo bem-sucedido; ele não restaura janelas em cache de uma busca que falhou.

Remoções

Quando um membro é excluído na integração, o acesso dele às portas é removido (Removed by integration). A linha dele em Users não é excluída, para que o histórico seja mantido.

Se uma sincronização for remover um número excepcionalmente grande de pessoas de uma só vez, essas remoções ficam retidas para revisão (N removals held back for review). As remoções causadas por integrações acima de um limite de segurança aguardam a revisão de um administrador antes de serem aplicadas, para que uma busca com defeito em uma integração não remova o acesso de todos de uma só vez.

Snapshots de Access Time Windows

Cada integração atualiza apenas a própria partição de fonte. A atualização de membros dela é um snapshot completo de janelas, com revisões monotonicamente crescentes:

• Dados de janelas omitidos deixam o snapshot atual da fonte inalterado.
• Um snapshot mais recente substitui a lista completa dessa fonte.
• A mesma revisão com o mesmo payload normalizado é uma repetição idempotente.
• A mesma revisão com dados diferentes é um conflito; uma revisão mais antiga é ignorada por estar desatualizada.
• Um snapshot vazio mais recente revoga explicitamente as janelas dessa fonte.
• Uma busca upstream com falha ou incompleta não deve enviar nenhum snapshot, nunca um vazio ou parcial.

Cada scope_key estável da fonte (incluindo default) é mapeada para destinos de toda a instalação, de portas ou de Access Scopes em Mapeamento de Access Time Windows. Mapeamentos desconhecidos ou desabilitados falham fechados. As configurações também mostram a idade da fonte e a política de atualidade da fonte da integração.

Resolução de duplicatas

Figura 3: Resolução de duplicatas

"Quando duas pessoas compartilham um endereço de e-mail ou número de telefone, apenas uma pode ser sincronizada em Usuários. Escolha quem mantém a vaga; a outra é sinalizada como conflito e não é sincronizada."

• 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 — usado quando o status não define um vencedor, por exemplo, Oldest By Date Of Birth, Then Earliest Start Date.

O outro registro mostra Not synced – duplicate em Users e é contado no bloco Not synced. Por exemplo, uma clínica de saúde pode manter um único registro quando um profissional de saúde é ao mesmo tempo membro da equipe e paciente associado.

Convites automáticos para o aplicativo

Em App invitations, Auto-send app invitations envia e-mails aos usuários sincronizados qualificados que ainda não receberam um convite, e Advanced recipient rules pode limitar quem os recebe. Send invitations… envia em massa para os usuários existentes depois que você revisa a lista de destinatários. Detalhes completos em Convites.

Atividade de sincronização e solução de problemas

Expanda Sync activity & troubleshooting para "see why recent records did or did not sync." Você pode pesquisar por nome, ID ou motivo e atualizar a lista com Refresh. Cada entrada tem um selo de resultado:

Motivos de exclusão que você pode ver:

Clicar em uma entrada abre Sync activity detail com o registro completo: nome, ID externo, fonte, integração, motivo e IDs para escalonamento ao suporte.

Exclusão em massa de usuários sincronizados

Para remover os usuários vindos de uma integração (por exemplo, depois de desconectá-la), use Bulk delete synced users. Você revisa a lista exata antes que qualquer coisa seja excluída.

1. Em Bulk delete synced users, clique em Bulk delete…
2. Escolha o escopo: All integration-synced users ou uma única integração. Clique em Preview.
3. Revise: a caixa de diálogo mostra exatamente quantos usuários serão removidos (com uma lista de amostra). Observe o aviso — This cannot be undone, e todas as personalizações feitas pelo administrador nessas linhas (concessões, marcações personalizadas, anotações) são perdidas. O histórico de registros de acesso dos usuários é mantido.
4. Also turn off syncing from this integration (recommended) vem marcado por padrão — mantenha-o marcado; caso contrário, os mesmos usuários serão recriados na próxima passagem de sincronização (sem as personalizações antigas).
5. Marque I understand this is permanent and customisations will be lost e clique em Delete N.

Se o conjunto de usuários subjacente mudar entre a pré-visualização e a confirmação, será solicitado que você execute a pré-visualização novamente — isso garante que você exclua exatamente o que revisou.

Páginas relacionadas

• Usuários — fontes, desacoplamento, o painel do usuário
• Programações das Access Policies — as programações e as configurações de Access Time Windows
• Convites
• Solução de problemas — passo a passo para "usuário ausente / desatualizado"