Usuários

Nesta página

A guia Users lista todas as pessoas que podem (ou poderiam) usar o aplicativo móvel para desbloquear portas nesta instalação. Esta página aborda a adição de usuários, a importação e a exportação de CSV, a atribuição de Access Policies, as concessões permanentes, as Access Time Windows separadas de administrador/integração, o interruptor de bloqueio de acesso, a atividade no aplicativo, as sessões e a exclusão.

Guia Users: blocos, pesquisa, filtros e a lista de usuáriosGuia Users: blocos, pesquisa, filtros e a lista de usuários

Figura 1: A guia Users

De onde vêm os usuários

Cada linha tem uma fonte que informa como ela foi criada:

FonteSeloComo as linhas aparecemQuem mantém os dados
Manually addedManualUm administrador clicou em Add user ou usou Import (CSV)Administradores
External IntegrationIntegration (ou o nome do parceiro)Sincronizadas automaticamente a partir de uma integração de gestão de membrosA sincronização — os campos sincronizados são sobrescritos a cada passagem
CCTV/Computer VisionCCTV/Computer VisionSincronizadas a partir de pessoas identificadas no módulo de CFTVA sincronização
Performance Hub staffPerformance Hub staffSincronizadas automaticamente a partir do IAM do Performance Hub para a equipe cujas funções incluem esta instalaçãoIAM do Performance Hub

A sincronização da equipe do Performance Hub vem ativada por padrão; a sincronização das integrações e do Computer Vision vem desativada por padrão. Configure-as em Settings → Sync settings — consulte Sincronização e integrações.

Uma linha precisa de pelo menos um celular ou um endereço de e-mail — é o que a pessoa usa para entrar no aplicativo móvel com um código de uso único.

Estatísticas e filtros

Blocos de usuários: All users, Has access, No access e Not syncedBlocos de usuários: All users, Has access, No access e Not synced

Figura 2: Os blocos de estatísticas

BlocoMostra
All usersTodos os usuários desta instalação
Has accessUsuários que atualmente podem desbloquear pelo menos uma porta
No accessUsuários que atualmente não podem desbloquear nenhuma porta
Not syncedRegistros retidos por uma sincronização, por exemplo, uma duplicata

Clique em um bloco para filtrar a lista. (Selecionar um bloco também redefine o filtro Source.)

Barra de ferramentas de Users: pesquisa, Exportar CSV, Import, Add user, filtros, incluindo Sync status, e ordenaçãoBarra de ferramentas de Users: pesquisa, Exportar CSV, Import, Add user, filtros, incluindo Sync status, e ordenação

Figura 3: Pesquisa, Exportar CSV, Import, Add user, os chips de filtro e a ordenação

  • Search — corresponde ao nome, telefone ou e-mail.
  • Exportar CSV — baixa a lista filtrada atual. Por exemplo, uma academia pode exportar os usuários No access antes de uma campanha de reconquista.
  • Import e Add user — veja abaixo.
  • Chips de filtro:
ChipOpções
SourceAll sources, Manually added, External Integration, CCTV/Computer Vision, Performance Hub staff
AccessAny status, Has access, No access, Disabled, Without grants
Membership statusAny membership + os status presentes nos seus dados
Person typeAny type + os tipos presentes nos seus dados
TagAny tag + as marcações presentes nos seus dados
InvitationAny invitation, Invited, Not invited, Send failed
App adoptionAny adoption, Active (já usou o aplicativo), Not yet active
Sync statusAny status, ou somente os registros que uma sincronização reteve (por exemplo, duplicatas)
  • Sort by — Name, Recently added, Recently updated, Last used, Last synced; com um interruptor crescente/decrescente.
  • Clear filters aparece sempre que uma pesquisa ou um filtro está ativo.

Como ler uma linha de usuário

Linhas de usuários com chips de fonte, mensagem, sincronização e associaçãoLinhas de usuários com chips de fonte, mensagem, sincronização e associação

Figura 4: Linhas de usuários com selos

SeloSignificado
Manual / Integration / CCTV/Computer Vision (ou o nome do parceiro)A fonte da linha
Performance Hub staffA linha é sincronizada a partir do IAM do Performance Hub
MessageO usuário tem uma mensagem ativa no aplicativo (colorida conforme a gravidade)
DisabledAccess enabled está desativado — o usuário não consegue desbloquear nada; a linha fica esmaecida
Access granted via policyPelo menos uma Access Policy habilitada pode corresponder a este usuário e a uma porta configurada agora ou em uma janela futura da política
Access via time windowsO usuário tem Access Time Windows de propriedade do administrador ou da integração; abra a linha para ver se elas estão ativas, futuras, expiradas, desatualizadas ou não mapeadas
GrantsO usuário tem concessões permanentes separadas por usuário
Not synced – duplicateOutro registro com o mesmo e-mail ou telefone ficou com a vaga; este não é sincronizado. Consulte Resolução de duplicatas
InvitedUm e-mail de convite foi enviado e o usuário ainda não usou o aplicativo
Status da associação (por exemplo, Current, Expired)O status da associação do usuário no sistema de origem

As linhas sincronizadas também mostram o External ID ou o Computer Vision ID abaixo do nome. As linhas da equipe mostram, em vez disso, as funções no Performance Hub.

Listas grandes são carregadas progressivamente: enquanto o restante da lista é carregado, a parte inferior da lista mostra N more users loading….

Como adicionar um usuário manualmente

  1. Clique em Add user.

Caixa de diálogo Add userCaixa de diálogo Add user

Figura 5: A caixa de diálogo Add user

  1. Preencha First name, Last name e pelo menos um entre Mobile phone ou Email — "At least one of mobile phone or email is required for OTP login." Os números de telefone são normalizados para o formato internacional.
  2. Opcionalmente, defina um Person type (por exemplo, Gold, Trial, Staff), Custom tags (separadas por vírgula; as marcações existentes são listadas abaixo do campo) e Notes.
  3. Marque Send email invitation para enviar imediatamente à pessoa, por e-mail, os links de download do aplicativo (requer um endereço de e-mail; sem ele, a caixa de seleção fica desabilitada).
  4. Clique em Add user.

Se já existir um usuário com o mesmo telefone/e-mail nesta instalação, a caixa de diálogo informa isso e oferece Open existing user, em vez de criar uma duplicata.

Adicionar um usuário, por si só, não permite que ele passe por nenhuma porta. Ele ainda precisa de uma Access Policy correspondente, de uma concessão permanente ou de uma Access Time Window separada de administrador/integração.

Como importar usuários de um CSV

Clique em Import para criar usuários em massa a partir de uma planilha. Máximo de 200 usuários por importação.

Caixa de diálogo Import usersCaixa de diálogo Import users

Figura 6: O assistente de importação de CSV

Etapa 1 — Carregue um CSV. Arraste um arquivo .csv ou clique para procurar. Download template fornece um arquivo inicial com os cabeçalhos corretos.

Etapa 2 — Mapeie os campos. Cada coluna do CSV é mapeada para um campo: First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants — ou Do not import. Nomes de cabeçalho comuns (por exemplo, mobile, phone, groups) são mapeados automaticamente. Você deve mapear pelo menos uma coluna de celular ou de e-mail.

  • Access enabled aceita true/yes/enabled/1/on/y/active e false/no/disabled/0/off/n/inactive.
  • Door grants / Scope grants recebem nomes de portas ou de Access Scopes; nomes sem correspondência são sinalizados na pré-visualização.

Etapa 3 — Pré-visualize e importe. Revise as primeiras linhas, escolha se deseja Send invitation email to imported users (somente os usuários com e-mail são convidados) e clique em Import. Os resultados mostram as contagens Imported, Skipped (already exist) e Errors.

O painel de detalhes do usuário

Clique em qualquer linha para abrir o painel do usuário.

Painel de um membro sincronizado: perfil, mensagens, controle de acesso, convite e fontePainel de um membro sincronizado: perfil, mensagens, controle de acesso, convite e fonte

Figura 7: O painel de um membro sincronizado

Perfil e identidade

O cabeçalho mostra a fonte, o status da associação, o External ID e se o usuário é permitido por uma política.

  • First name / Last name / Mobile phone / Email — para usuários sincronizados, esses campos são sobrescritos a cada passagem de sincronização, a menos que a linha esteja desacoplada (veja abaixo).
  • Person type e Membership status — usados pelas condições Who das Access Policies.
  • Synced tags (somente leitura, do sistema de origem) e Custom tags (de propriedade do administrador, nunca sobrescritas pela sincronização). Os dois tipos podem satisfazer as marcações das políticas.
  • Notes — texto livre, com até 2000 caracteres.

Mensagem no aplicativo

App messaging define uma mensagem pessoal exibida no painel do aplicativo deste usuário, empilhada acima do banner de toda a instalação quando os dois estão ativos. Quando uma mensagem automática se aplica, o painel a mostra com controles para desativar a automação para este usuário. Consulte Mensagens no aplicativo.

Track source updates (somente usuários sincronizados)

Para usuários de Integration/CCTV, o interruptor Track source updates controla se a sincronização continua sobrescrevendo a linha:

  • Ativado (padrão): nome, telefone, e-mail, tipo, status, marcações sincronizadas e Access Time Windows de propriedade da fonte são atualizados nas sincronizações bem-sucedidas.
  • Desativado (desacoplado): após uma confirmação explícita, as Access Time Windows de propriedade da fonte são limpas e a sincronização ignora totalmente esta linha. As suas edições manuais e as janelas de propriedade do administrador são preservadas, e as remoções na fonte deixam de afetá-la. A linha mostra um selo Decoupled.

Ative novamente para reacoplar. O snapshot atual das janelas da fonte é restaurado na próxima sincronização completa bem-sucedida, e não a partir de uma busca na fonte com falha ou parcial.

Os painéis de usuários sincronizados também incluem links para o registro de origem (o registro da integração ou a pessoa no Computer Vision).

Removido pela integração

Quando um membro é excluído na integração, o acesso dele às portas é removido e o painel mostra Removed by integration. A linha permanece na lista para que o histórico seja mantido. Consulte Sincronização e integrações.

Controle de Acesso

Access Control: acesso habilitado, cobertura de políticas e acesso permanente adicionalAccess Control: acesso habilitado, cobertura de políticas e acesso permanente adicional

Figura 8: A seção Access Control

A seção Access Control reúne as configurações de autorização do usuário: o interruptor de bloqueio de acesso, a cobertura de políticas, o acesso permanente adicional e as Access Time Windows de administrador/integração.

Access enabled (o interruptor de bloqueio)

O interruptor Access enabled bloqueia ou restaura instantaneamente todo o acesso deste usuário às portas. Quando desativado:

  • Todas as tentativas de desbloqueio do membro são negadas (motivo: acesso desativado), independentemente de políticas, concessões ou Access Time Windows.
  • A linha mostra um selo Disabled e fica esmaecida na lista.

Use isso para suspender alguém imediatamente sem excluir o registro nem alterar a política.

Acesso permanente adicional

As concessões dão a esta pessoa específica acesso além do que as Access Policies da instalação permitem. Quando uma política já cobre o usuário, a seção mostra Allowed by policy e "This user's door access is set by policy — no manual grants are needed." Clique em Show para abrir o editor de concessões:

ConcessãoEfeito
Facility-wideTodas as portas da instalação (substitui as listas de portas/escopos enquanto ativada)
Door grantsMarque portas individuais
Scope grantsMarque Access Scopes — o usuário recebe todas as portas do escopo, incluindo as portas adicionadas ao escopo posteriormente

As portas que uma política já cobre são marcadas como Already covered by policy ou Set by policy, para que você veja onde uma concessão manual não é necessária. As concessões podem ter o próprio horário de funcionamento, limitando quando a concessão se aplica. Clear all remove todas as concessões de uma só vez. A importação automática de políticas e as edições posteriores das políticas não alteram as concessões permanentes.

Os indicadores de política e de concessão são aditivos. Remover uma concessão manual redundante não remove o acesso pela política, e editar uma política não remove a concessão.

Janelas de Tempo de Acesso

A seção Access Time Windows gerencia o acesso aditivo temporário desta pessoa, com Add one-time window e Add weekly window (até 50):

  • As janelas absolutas e semanais de propriedade do administrador são editáveis e podem ter como destino a instalação, portas selecionadas ou Access Scopes.
  • As janelas de propriedade da integração são somente leitura e mostram a fonte, o ID na fonte, o fuso horário declarado, o mapeamento lógico de escopo, a idade da fonte e o estado de atualidade.
  • Os estados ativo, futuro, expirado, desatualizado e não mapeado são mostrados separadamente. Uma janela desatualizada ou não mapeada não concede acesso, mas as Access Policies e as concessões permanentes continuam disponíveis como caminhos alternativos.
  • Os instantes exatos usam os limites [from, to). As janelas semanais usam o fuso horário IANA exibido e as regras de horário de verão dele.

O painel observa: "Time windows add access. They do not restrict existing rules or grants." Consulte Programações das Access Policies.

Convite

Mostra se um e-mail de convite para o aplicativo foi enviado, quando e se falhou; o botão exibe Send invitation email ou Resend invitation email. Os convites são enviados somente por e-mail. Detalhes completos em Convites.

Sessões e atividade no aplicativo

  • App activity — Last used the app com data e hora (ou "Hasn't used the app yet.") e os endereços IP recentes.
  • Sessions — Sign out of app revoga a sessão do usuário no aplicativo: "This revokes the user's app session. They'll need to sign in again to unlock doors." Observação: "Sessions are revoked immediately, but if the user is currently signed in it may take up to 15 minutes before they're fully signed out of the app." Como as sessões são vinculadas ao telefone/e-mail, uma pessoa que usa o mesmo telefone/e-mail em outra instalação também é desconectada lá.

Como excluir um usuário

Zona de perigo com o botão Delete userZona de perigo com o botão Delete user

Figura 9: A zona de perigo

Delete user remove a linha de Users. "Their access log history is kept for the audit trail." A exclusão também desativa o acesso da pessoa imediatamente. Para usuários sincronizados, observe que a pessoa pode reaparecer na próxima sincronização, a menos que você também desabilite a integração ou desacople a linha — para remover integrações inteiras, use Bulk delete synced users em Sincronização e integrações.

Equipe do Performance Hub

Painel de um membro da equipe do Performance Hub sincronizado a partir do IAMPainel de um membro da equipe do Performance Hub sincronizado a partir do IAM

Figura 10: O painel de um membro da equipe do Performance Hub

O painel de um membro da equipe tem o banner Synced from Performance Hub IAM. Os membros da equipe são adicionados automaticamente porque as funções deles no Performance Hub incluem esta instalação, e são removidos quando esse acesso termina. O banner lista as funções deles.

  • Nome, e-mail, telefone e tipo de pessoa são gerenciados no IAM do Performance Hub e são somente leitura aqui.
  • As Synced tags (como Performance Hub staff e Role: …) são sobrescritas a cada sincronização. Você ainda pode adicionar Custom tags e Notes.
  • Os membros da equipe não podem ser excluídos aqui. Remova o acesso deles à instalação no IAM do Performance Hub ou desative Access enabled para encerrar imediatamente o acesso deles às portas.

Consulte Sincronização da equipe do Performance Hub.