Registros de acesso
Nesta página
A guia Registros de acesso é a trilha de auditoria: cada tentativa de desbloqueio — bem-sucedida, negada ou com falha; pelo aplicativo móvel ou por um administrador — é registrada com quem, qual porta, quando, de onde e o resultado. Esta página aborda como ler o registro, filtrar, a visualização No visit recorded, exportar para CSV e a visualização de detalhes do evento.
Figura 1: A guia Registros de acesso
Os eventos são mantidos por aproximadamente 13 meses e depois removidos automaticamente. Excluir um usuário não exclui os eventos dele — o histórico é mantido para a trilha de auditoria.
Os Registros de acesso são diferentes dos Registros de auditoria, que registram as solicitações feitas em todo o Performance Hub.
Filtragem e pesquisa
Figura 2: Pesquisa, filtros, colunas, exportação, atualização ao vivo e intervalo
| Controle | O que faz |
|---|---|
| Search | "Search door, person, event ID…" — encontra correspondências por porta, pessoa, ID do evento, ID do comando, estado e motivo da negação |
| View | Door events (a trilha de auditoria) ou No visit recorded (consulte abaixo) |
| State, Result, Door, Source, Partner, Reason | Filtros que restringem a lista por estado do evento, resultado, porta, origem da solicitação, parceiro de integração e motivo da negação |
| Columns | Escolha quais colunas a tabela mostra; o botão mostra quantas estão ativadas |
| Exportar CSV | Baixa os eventos filtrados no momento (consulte Exportar para CSV) |
| Live | Atualiza a lista automaticamente, com uma contagem regressiva até a próxima atualização; o botão ao lado atualiza agora |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days ou datas personalizadas |
O cabeçalho mostra a contagem de eventos do intervalo e dos filtros atuais. Cada intervalo carrega até os 500 eventos mais recentes.
Estados dos eventos
| Indicador de estado | Significado |
|---|---|
| Confirmed unlocked | O controlador da porta confirmou que o relé foi liberado — a porta realmente foi desbloqueada |
| Unlocked | O desbloqueio foi informado como bem-sucedido |
| Admin Unlocked | Um administrador acionou o desbloqueio pelo Performance Hub (substituição do administrador). Registrado assim que o comando é enviado |
| Denied | A solicitação foi rejeitada — consulte a coluna Reason (todos os motivos) |
| Pending / Request received | A solicitação ainda está sendo processada (transitório — normalmente se resolve em segundos) |
| Timed out | O comando de desbloqueio foi enviado, mas o controlador não confirmou a tempo — geralmente um problema de conectividade na porta |
| Failed | Não foi possível concluir o desbloqueio devido a um erro |
| Locked by staff | A equipe usou Lock now enquanto a programação de desbloqueio automático mantinha a porta aberta. Um evento da programação, não uma tentativa de desbloqueio |
| Schedule resumed | A programação de desbloqueio automático voltou a assumir o controle, seja na próxima alteração dela ou porque a equipe pressionou Resume schedule. Um evento da programação, não uma tentativa de desbloqueio |
Cada linha mostra o carimbo de data/hora, o estado, a porta, a pessoa, a distância até a porta e a latência do comando (quando disponível), além do motivo da negação para eventos negados.
Nenhuma visita registrada
Figura 3: A visualização No visit recorded
Defina View como No visit recorded para listar Access Time Windows avulsas, adicionadas por um administrador ou por uma integração, em que a pessoa nunca desbloqueou uma porta durante a janela (incluindo qualquer período de tolerância). Colunas: Person, Scheduled period, Source / partner, Status. Os registros são mantidos por cerca de 13 meses.
Por exemplo, um escritório pode ver quais prestadores de serviço com uma janela avulsa nunca compareceram.
Atribuição de Access Policy
Os eventos autorizados por política identificam a política nomeada e o público, o destino e a programação correspondentes. As correspondências programadas também podem incluir o início e o fim concretos ativos.
As Access Time Windows de responsabilidade do administrador e de integrações mantêm caminhos de atribuição próprios (admin_time_window e source_time_window); elas não são rotuladas novamente como Access Policies. As negações de política distinguem divergências de destino, de público e de programação inativa. Uma ocorrência futura usa outside_access_time_window com disponibilidade estruturada, quando conhecida.
Detalhes do evento
Clique em qualquer linha para abrir a caixa de diálogo Access Details.
Figura 4: A caixa de diálogo Access Details de um desbloqueio de membro
O cabeçalho mostra a porta, a localização dela, o resultado, um selo Admin override quando aplicável e o motivo da negação, se houver. Campos exibidos quando disponíveis:
| Campo | Observações |
|---|---|
| Date / Time | Quando a tentativa ocorreu |
| Coordinates | A localização informada pelo telefone, com a precisão do GPS (±N m); pode ser copiada |
| Door / Gate | Nome e localização da porta |
| Person ou Admin | Quem tentou — os desbloqueios de administrador mostram a conta do administrador |
| Device | O telefone/dispositivo usado |
| IP Address | O IP da solicitação; pode ser copiado |
| Hold time | Por quanto tempo a porta permaneceu desbloqueada |
| Distance from door | Distância calculada a partir do centro da geofence |
| Event ID / Command ID | Identificadores que podem ser copiados para encaminhamento ao suporte |
| Latency | Quanto tempo o controlador levou para responder ao comando |
| Authorization source | Access Policy, concessão permanente, janela de administrador ou janela de integração |
| Policy | ID/nome da política, além do público correspondente, do destino de porta/Escopo de acesso e do modo Anytime/Scheduled |
| Window / Source ID | Atribuição delimitada para janelas programadas ou de origem ativas |
| Active from / to | Ocorrência concreta em segundos Unix usada para uma decisão de janela; o fim não é incluído |
Unlock Location marca as coordenadas informadas em um mapa com um link Open in Google Maps. Quando não há coordenadas, você verá "No location captured — unlocked from the Performance Hub." (substituições do administrador) ou "No location data was reported for this unlock attempt."
Exportar para CSV
Clique em Exportar CSV para baixar os eventos filtrados no momento. O arquivo inclui campos de identidade, porta, resultado, negação, controlador, integração e atribuição de política/janela. O botão fica desativado quando a lista filtrada está vazia. Na visualização No visit recorded, Exportar CSV baixa essa lista.
Dicas
- O cartão Recent activity da guia Doors é um atalho de 24 horas para este registro — clicar em um evento ali leva diretamente a ele aqui.
- Está investigando a reclamação de um membro? Use o filtro State ou Result para mostrar as tentativas negadas, pesquise o nome da pessoa e leia o motivo — depois consulte Solução de problemas para ver a solução de cada motivo.
- Para reclamações sobre políticas, confirme o nome da política e os respectivos Who/Where/When. Para janelas de integração, verifique também a idade da origem e o mapeamento
scope_key. - Uma sequência de eventos Timed out em uma porta geralmente significa que o controlador dessa porta tem problemas de rede — verifique o status dele na guia Doors.
- Seu Agente de IA pode ler os eventos de porta por meio do MCP, por exemplo para uma mensagem de boas-vindas no saguão do escritório para cada visitante. Os eventos de porta trazem um ID de usuário, não um nome nem uma data de nascimento.
Páginas relacionadas
- Referência — todos os estados e motivos de negação
- Programações das Access Policies
- Solução de problemas
- Doors