Come funzionano le decisioni di accesso

In questa pagina

Questa pagina spiega il modello alla base di ogni sblocco: chi può passare da una porta, in quale ordine vengono eseguiti i controlli e come interagiscono Access Policies, autorizzazioni e controlli di sicurezza. Leggila per prima: tutte le altre pagine si basano su questi concetti.

I percorsi di autorizzazione cumulativi

Un utente può essere autorizzato a passare da una porta tramite qualsiasi percorso di policy o di autorizzazione. Superare un percorso è sufficiente; un percorso non sottrae mai l'accesso fornito da un altro.

Percorso	Che cos'è	Dove si configura
Access Policies	Più policy denominate che si limitano a consentire. Ogni policy definisce Who, Where e When.	Settings → Access Policies
Autorizzazioni permanenti	Autorizzazioni esplicite per una persona: per l'intera struttura, per porte selezionate o per Access Scopes selezionati, facoltativamente con orari propri.	Users → apri un utente → Access Control → Additional permanent access
Access Time Windows	Accesso temporaneo gestito da un amministratore per una persona e per destinazioni selezionate (struttura/porta/ambito).	Users → apri un utente → Access Time Windows
Access Time Windows delle integrazioni	Finestre di sola lettura provenienti dall'origine per una persona sincronizzata, mappate a partire da chiavi logiche degli ambiti di origine.	Dati di origine più le mappature in Settings → Sync settings

Una policy corrisponde solo quando Who E Where E When corrispondono. Le policy sono combinate in OR. All'interno di Who, le condizioni su tipo di persona/stato e i tag sono alternativi; all'interno di When, le finestre Weekly e One-time sono alternative. Where può includere tutte le porte della struttura, Access Scopes, singole porte ed esclusioni.

Esempio: una policy "Active members" può coprire l'ambito Front entrances con Anytime, mentre una policy separata "Staff" copre tutte le porte della struttura tranne il Plant room. Un addetto alle pulizie che non corrisponde a nessuna delle due può comunque ricevere un'autorizzazione permanente per l'ambito Service entries.

Le autorizzazioni permanenti e le finestre di amministratori/integrazioni restano separate e cumulative. Le modifiche alle policy e l'importazione automatica non le assorbono né le rimuovono.

Il personale del Performance Hub sincronizzato in Users ottiene l'accesso alle porte tramite la policy modificabile Performance Hub staff, come qualsiasi altra policy. Vedi Sincronizzazione e integrazioni.

La sequenza decisionale completa

Quando un utente tocca Unlock nell'app mobile, il server verifica quanto segue, in quest'ordine. Il primo controllo non superato nega lo sblocco e registra il motivo nei Registri di accesso.

L'accesso dell'utente è attivato? L'interruttore Access enabled nella riga dell'utente in Users è un interruttore di disattivazione per gli amministratori. Gli utenti eliminati, disattivati o bloccati dalla sincronizzazione non possono sbloccare, indipendentemente da policy o autorizzazioni. (Ad esempio: access_disabled.)
La porta è bloccata o in manutenzione? Un blockAllAccess esplicito nega ogni percorso dei membri. La modalità di manutenzione Force closed mantiene la porta bloccata e fuori servizio per i membri; Force open mantiene la porta sbloccata. Gli amministratori possono sbloccare una porta da remoto; ogni sblocco da amministratore viene registrato nei Registri di accesso.
Viene superato almeno un percorso di autorizzazione cumulativo?
- Percorso delle policy: qualsiasi policy denominata attivata i cui Who, Where e When corrispondono tutti consente l'accesso.
- Percorso delle autorizzazioni permanenti: un'autorizzazione per struttura, porta o Access Scope che la contiene consente l'accesso quando corrispondono i relativi orari facoltativi.
- Percorso delle finestre utente: una Access Time Window gestita da un amministratore è attiva e ha come destinazione questa porta, la struttura o un Access Scope che la contiene.
- Percorso delle finestre di integrazione: una finestra di origine aggiornata è attiva e la mappatura scope_key configurata ha come destinazione questa porta. Le finestre di origine non aggiornate o non mappate adottano un comportamento fail-closed.
- Se nessuno viene superato → negato (no_matching_policy_or_grant)
Controllo del geofence (se attivato). In base alla posizione segnalata dal telefono:
- Se il telefono non è riuscito a fornire una posizione → negato (location_unavailable)
- Se la lettura GPS è meno precisa dell'impostazione Require GPS accuracy better than → negato (gps_too_imprecise)
- Se la distanza dell'utente dal centro del geofence supera raggio + precisione GPS + margine di precisione → negato (outside_geofence)
- Il server ha l'ultima parola: una posizione falsificata sul telefono viene comunque rifiutata lato server.
Il controller della porta è online? Se il controller non ha inviato segnali (heartbeat negli ultimi 5 minuti), lo sblocco non può essere recapitato (device_offline). Se il comando viene inviato ma il controller non lo conferma, l'evento viene registrato come Timed out.
Sblocco. Il relè si rilascia per il Hold time della porta (1–30 secondi, valore predefinito 10), poi la porta si blocca di nuovo automaticamente. L'evento viene registrato come Confirmed unlocked quando il controller lo conferma.

Le finestre One-time e le finestre Weekly delimitate usano limiti interi in secondi Unix e intervalli semiaperti [from, to): l'inizio è incluso e la fine no. I blocchi Weekly usano il fuso orario IANA dichiarato e le regole locali dell'ora civile/ora legale. Vedi Pianificazioni delle Access Policies.

I client nuovi ricevono il dettaglio outside_access_time_window più la disponibilità successiva strutturata per una porta con sole finestre future. Durante l'introduzione graduale per la compatibilità, i client meno recenti continuano a ricevere outside_access_hours come motivo principale, in modo che la porta resti disattivata in sicurezza e visibile.

Configurazione esistente

La configurazione di accesso esistente viene importata automaticamente nelle Access Policies. L'importazione conserva chi aveva accesso, le porte o gli Access Scopes che poteva usare e gli orari applicabili come valori Who, Where e When delle policy. Gli amministratori gestiscono direttamente le policy risultanti; non esiste alcuna modalità di implementazione né alcuna procedura di conversione manuale.

L'ereditarietà del geofence resta indipendente dalle Access Policies. Le corrispondenze delle policy passano comunque attraverso il geofence effettivo e tutti gli altri controlli di sicurezza e del dispositivo.

L'accesso all'app mobile (codice monouso via SMS o email) è solo autenticazione: dimostra chi è l'utente. Non concede da solo l'accesso alle porte. Ogni sblocco viene autorizzato singolarmente con la sequenza decisionale descritta sopra. Un utente può aver effettuato l'accesso all'app e vedere comunque "You don't have access to this door."

Glossario

Termine	Definizione
Controller della porta	Il dispositivo hardware associato a una porta/cancello che aziona il relè della serratura. Compare come "porta" in questo modulo e come dispositivo in Gestione dei dispositivi.
Porta	Un controller della porta registrato nella tua struttura, con nome, etichetta di posizione, icona e impostazioni.
Riga utente	Il record di una persona in questa struttura nella scheda Users. Creato manualmente, tramite importazione CSV o tramite sincronizzazione. Contiene identificativi di contatto, tipo/stato/tag, autorizzazioni e stato dell'app.
Origine	La provenienza di una riga utente: Manually added, External Integration, CCTV/Computer Vision o Performance Hub staff.
Access Policy	Una policy denominata che si limita a consentire e contiene Who, Where e When. Tutti e tre devono corrispondere; le policy si combinano in OR.
Condizione sul tipo di persona	Una condizione Who di una policy che contiene un tipo di persona e stati di iscrizione facoltativi. Nessuno stato indicato significa qualsiasi stato.
Tag	Un'etichetta su un utente. I tag sincronizzati provengono dall'integrazione e vengono sovrascritti a ogni sincronizzazione; i tag personalizzati sono gestiti dagli amministratori e non vengono mai sovrascritti. Entrambi possono soddisfare le condizioni Who delle policy.
Orari di apertura / blocco orario	Finestre orarie per giorno della settimana (ad es. lun 06:00–22:00) che limitano quando policy o autorizzazioni consentono l'accesso. Vuoto = sempre consentito. Gli orari usano il fuso orario della struttura.
Access Time Window	Un periodo Weekly o One-time usato nella pianificazione di una policy o in un percorso di autorizzazione separato di amministratori/integrazioni.
Autorizzazione per singolo utente	Accesso esplicito concesso a un utente: Facility-wide (ogni porta), porte specifiche o Access Scopes specifici, facoltativamente con orari di apertura propri.
Ambito di accesso	Un insieme denominato di porte (ad es. "Main entrances", "Staff-only") usato come destinazione di policy o autorizzazioni e per le impostazioni del geofence a livello di ambito. Internamente è chiamato anche door group.
Esclusione della policy	Una porta o un Access Scope rimosso dalla corrispondenza Where di una policy. Non nega un'altra policy né un altro percorso di autorizzazione.
Geofence	Un cerchio attorno alla struttura (centro + raggio). Quando è attivato, gli utenti devono trovarsi fisicamente al suo interno (tenendo conto di precisione GPS e margine) per sbloccare.
Margine di precisione	Metri aggiuntivi sommati al raggio del geofence per compensare il normale rumore del GPS. Valore predefinito 25 m.
Modalità di manutenzione	Impostazione per singola porta che esclude una porta dal normale funzionamento: Normal, Force open (mantenuta sbloccata) o Force closed (mantenuta bloccata e fuori servizio per i membri).
Block all access	Un blocco di sicurezza per singola porta che prevale su policy e autorizzazioni per singolo utente in quella porta, senza usare la modalità di manutenzione. Lo sblocco da amministratore resta disponibile.
Tempo di apertura	Per quanto tempo il relè resta rilasciato dopo uno sblocco prima di bloccarsi di nuovo. Intervallo 1–30 secondi, valore predefinito 10.
Pianificazione dello sblocco automatico	Una pianificazione per singola porta che mantiene la porta sbloccata durante gli orari con personale della struttura o secondo una pianificazione personalizzata. Indipendente dalle Access Policies.
Lock now	Blocca una porta che la pianificazione dello sblocco automatico mantiene aperta, fino alla successiva variazione della pianificazione. Resume schedule annulla l'operazione.
Access enabled	L'interruttore di disattivazione per singolo utente. Disattivato = l'utente non può sbloccare nulla.
Disaccoppiato	Un utente sincronizzato il cui interruttore Track source updates è disattivato. Le sincronizzazioni saltano la riga, quindi le modifiche degli amministratori vengono conservate.
Invito	L'email inviata a un utente con i link per scaricare l'app mobile. Monitorato per singolo utente (Not invited / Invited / Send failed).
Accesso con OTP	L'accesso senza password dell'app mobile: un codice monouso inviato al telefono o all'email dell'utente.
Deroga dell'amministratore / Sblocco da amministratore	Uno sblocco attivato dal Performance Hub da un amministratore (scheda Doors → Open, oppure Unlock door nel pannello della porta). Ogni sblocco da amministratore viene registrato nei Registri di accesso con l'account dell'amministratore.
Blocco dell'app	Nuova autenticazione sul dispositivo imposta dalla struttura (Face ID / Touch ID / biometria Android / codice) prima di poter usare l'app.
Messaggio nell'app	Una scheda di annuncio nella dashboard dell'app: per l'intera struttura, per singolo utente o impostata automaticamente da una regola di App Messaging.
Evento di accesso	Un record nei Registri di accesso: un tentativo di sblocco e il relativo esito.

Access Policies: Who, Where, When e importazione automatica
Pianificazioni delle Access Policies: Anytime, Weekly e One-time
Access Scopes: insiemi di porte riutilizzabili
Geofencing: controlli della posizione
Users: autorizzazioni per singolo utente e interruttore di disattivazione
Riferimento: ogni motivo di diniego e valore predefinito in un'unica tabella
Le porte possono essere incluse anche nelle risposte di Duress. Vedi Azioni di risposta in Duress.