Registri di accesso
In questa pagina
La scheda Registri di accesso è la traccia di controllo: ogni tentativo di sblocco (riuscito, negato o non andato a buon fine; dall'app mobile o da un amministratore) viene registrato con chi, quale porta, quando, da dove e l'esito. Questa pagina spiega come leggere il registro, filtrare, usare la vista No visit recorded, esportare in CSV e consultare la vista dei dettagli di un evento.
Figura 1: la scheda Registri di accesso
Gli eventi vengono conservati per circa 13 mesi, poi vengono rimossi automaticamente. L'eliminazione di un utente non elimina i suoi eventi: lo storico viene conservato per la traccia di controllo.
I Registri di accesso sono distinti dai Registri di controllo, che registrano le richieste effettuate in tutto il Performance Hub.
Filtrare e cercare
Figura 2: ricerca, filtri, colonne, esportazione, aggiornamento in tempo reale e intervallo
| Controllo | Cosa fa |
|---|---|
| Search | "Search door, person, event ID…": cerca per porta, persona, ID evento, ID comando, stato e motivo del diniego |
| View | Door events (la traccia di controllo) o No visit recorded (vedi più avanti) |
| State, Result, Door, Source, Partner, Reason | Filtri che restringono l'elenco per stato dell'evento, esito, porta, provenienza della richiesta, partner di integrazione e motivo del diniego |
| Columns | Scegli quali colonne mostra la tabella; il pulsante indica quante sono attive |
| Esporta CSV | Scarica gli eventi attualmente filtrati (vedi Esportare in CSV) |
| Live | Aggiorna automaticamente l'elenco, con un conto alla rovescia fino al prossimo aggiornamento; il pulsante accanto aggiorna subito |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days o date personalizzate |
L'intestazione mostra il numero di eventi per l'intervallo e i filtri correnti. Ogni intervallo carica fino ai 500 eventi più recenti.
Stati degli eventi
| Indicatore di stato | Significato |
|---|---|
| Confirmed unlocked | Il controller della porta ha confermato il rilascio del relè: la porta si è effettivamente sbloccata |
| Unlocked | Lo sblocco è stato segnalato come riuscito |
| Admin Unlocked | Un amministratore ha attivato lo sblocco dal Performance Hub (override dell'amministratore). Viene registrato non appena il comando viene inviato |
| Denied | La richiesta è stata rifiutata: vedi la colonna Reason (tutti i motivi) |
| Pending / Request received | La richiesta è ancora in elaborazione (stato temporaneo, di norma si risolve in pochi secondi) |
| Timed out | Il comando di sblocco è stato inviato ma il controller non ha confermato in tempo: di solito si tratta di problemi di connettività presso la porta |
| Failed | Non è stato possibile completare lo sblocco a causa di un errore |
| Locked by staff | Il personale ha usato Lock now mentre la pianificazione dello sblocco automatico teneva aperta la porta. È un evento della pianificazione, non un tentativo di sblocco |
| Schedule resumed | La pianificazione dello sblocco automatico è tornata attiva, alla sua modifica successiva oppure perché il personale ha premuto Resume schedule. È un evento della pianificazione, non un tentativo di sblocco |
Ogni riga mostra data e ora, stato, porta, persona, distanza dalla porta e latenza del comando (se disponibile), e il motivo del diniego per gli eventi negati.
Nessuna visita registrata
Figura 3: la vista No visit recorded
Imposta View su No visit recorded per elencare le Access Time Windows una tantum, aggiunte da un amministratore o da un'integrazione, in cui la persona non ha mai sbloccato una porta durante la finestra (compreso un eventuale periodo di tolleranza). Colonne: Person, Scheduled period, Source / partner, Status. I record vengono conservati per circa 13 mesi.
Ad esempio, un ufficio può vedere quali appaltatori con una finestra una tantum non si sono mai presentati.
Attribuzione alle Access Policies
Gli eventi autorizzati da una policy identificano la policy con il suo nome e il pubblico, la destinazione e la pianificazione corrispondenti. Le corrispondenze pianificate possono includere anche l'inizio e la fine effettivi attivi.
Le Access Time Windows di proprietà di un amministratore o di un'integrazione mantengono i propri percorsi di attribuzione (admin_time_window e source_time_window); non vengono rietichettate come Access Policies. I dinieghi delle policy distinguono tra mancata corrispondenza della destinazione, del pubblico e della pianificazione inattiva. Un'occorrenza futura usa outside_access_time_window con una disponibilità strutturata, quando nota.
Dettagli dell'evento
Fai clic su qualsiasi riga per aprire la finestra di dialogo Access Details.
Figura 4: la finestra di dialogo Access Details per lo sblocco di un membro
L'intestazione mostra la porta, la sua posizione, l'esito, un badge Admin override quando applicabile e il motivo del diniego in caso di rifiuto. Campi mostrati quando disponibili:
| Campo | Note |
|---|---|
| Date / Time | Quando è avvenuto il tentativo |
| Coordinates | La posizione segnalata dal telefono, con la precisione GPS (±N m); copiabile |
| Door / Gate | Nome e posizione della porta |
| Person o Admin | Chi ha effettuato il tentativo: gli sblocchi da amministratore mostrano l'account dell'amministratore |
| Device | Il telefono o il dispositivo usato |
| IP Address | L'IP della richiesta; copiabile |
| Hold time | Per quanto tempo la porta è rimasta sbloccata |
| Distance from door | Distanza calcolata dal centro del geofence |
| Event ID / Command ID | Identificativi copiabili per l'escalation all'assistenza |
| Latency | Quanto tempo ha impiegato il controller a rispondere al comando |
| Authorization source | Access Policy, autorizzazione permanente, finestra dell'amministratore o finestra dell'integrazione |
| Policy | ID o nome della policy più il pubblico corrispondente, la destinazione (porta o Access Scope) e la modalità Anytime/Scheduled |
| Window / Source ID | Attribuzione delimitata per le finestre pianificate o di origine attive |
| Active from / to | Occorrenza effettiva in secondi Unix usata per una decisione basata su una finestra; la fine è esclusa |
Unlock Location mostra le coordinate segnalate su una mappa con un link Open in Google Maps. Quando non ci sono coordinate, vedrai "No location captured — unlocked from the Performance Hub." (override dell'amministratore) oppure "No location data was reported for this unlock attempt."
Esportare in CSV
Fai clic su Esporta CSV per scaricare gli eventi attualmente filtrati. Il file include i campi relativi a identità, porta, esito, diniego, controller, integrazione e attribuzione a policy o finestra. Il pulsante è disattivato quando l'elenco filtrato è vuoto. Nella vista No visit recorded, Esporta CSV scarica invece quell'elenco.
Suggerimenti
- La scheda Recent activity nella scheda Doors è una scorciatoia di 24 ore a questo registro: facendo clic su un evento lì, vieni portato direttamente all'evento qui.
- Stai indagando sul reclamo di un membro? Usa il filtro State o Result per mostrare i tentativi negati, cerca il suo nome e leggi il motivo, poi consulta Risoluzione dei problemi per la soluzione relativa a ciascun motivo.
- Per i reclami relativi alle policy, verifica il nome della policy e i suoi criteri Who/Where/When. Per le finestre delle integrazioni, controlla anche l'età dell'origine e la mappatura di
scope_key. - Una serie di eventi Timed out su una porta di solito indica che il controller di quella porta ha problemi di rete: controllane lo stato nella scheda Doors.
- Il tuo Agente AI può leggere gli eventi delle porte tramite MCP, ad esempio per un benvenuto nella hall dell'ufficio per ogni visitatore. Gli eventi delle porte contengono un ID utente, non un nome o una data di nascita.
Pagine correlate
- Riferimento: ogni stato e motivo di diniego
- Pianificazioni delle Access Policies
- Risoluzione dei problemi
- Doors