Utenti

La scheda Users elenca ogni persona che può (o potrebbe) usare l'app mobile per sbloccare le porte in questa struttura. Questa pagina tratta l'aggiunta di utenti, l'importazione e l'esportazione CSV, l'attribuzione delle Access Policy, le autorizzazioni permanenti, le Access Time Windows separate dell'amministratore o dell'integrazione, l'interruttore di disattivazione dell'accesso, l'attività nell'app, le sessioni e l'eliminazione.

Figura 1: la scheda Users

Da dove provengono gli utenti

Ogni riga ha una fonte che indica come è stata creata:

La sincronizzazione del personale del Performance Hub è attiva per impostazione predefinita; la sincronizzazione da integrazioni e da Computer Vision è disattivata per impostazione predefinita. Configurale in Settings → Sync settings: vedi Sincronizzazione e integrazioni.

Una riga necessita di almeno un numero di cellulare o un indirizzo email: è ciò che la persona usa per accedere all'app mobile con un codice monouso.

Statistiche e filtri

Figura 2: i riquadri delle statistiche

Fai clic su un riquadro per filtrare l'elenco. (La selezione di un riquadro reimposta anche il filtro Source.)

Figura 3: ricerca, Esporta CSV, Import, Add user, i filtri e l'ordinamento

• Search: cerca per nome, telefono o email.
• Esporta CSV: scarica l'elenco filtrato corrente. Ad esempio, una palestra può esportare i propri utenti No access prima di una campagna di riconquista.
• Import e Add user: vedi sotto.
• Filtri:

• Sort by: Name, Recently added, Recently updated, Last used, Last synced; con un interruttore per l'ordine crescente/decrescente.
• Clear filters compare ogni volta che è attiva una ricerca o un filtro.

Lettura di una riga utente

Figura 4: righe degli utenti con i badge

Le righe sincronizzate mostrano anche il loro External ID o Computer Vision ID sotto il nome. Le righe del personale mostrano invece i ruoli nel Performance Hub.

Gli elenchi lunghi vengono caricati progressivamente: mentre il resto dell'elenco si carica, in fondo all'elenco compare N more users loading….

Aggiunta manuale di un utente

1. Fai clic su Add user.

Figura 5: la finestra di dialogo Add user

2. Compila First name, Last name e almeno uno tra Mobile phone ed Email: "At least one of mobile phone or email is required for OTP login." I numeri di telefono vengono normalizzati nel formato internazionale.
3. Facoltativamente, imposta un Person type (ad es. Gold, Trial, Staff), dei Custom tags (separati da virgole; i tag esistenti sono elencati sotto il campo) e delle Notes.
4. Seleziona Send email invitation per inviare subito alla persona via email i link per scaricare l'app (richiede un indirizzo email; senza di esso la casella è disattivata).
5. Fai clic su Add user.

Se in questa struttura esiste già un utente con lo stesso telefono o la stessa email, la finestra di dialogo te lo segnala e propone Open existing user invece di creare un duplicato.

L'aggiunta di un utente non gli consente, di per sé, di passare da alcuna porta. Ha comunque bisogno di una Access Policy corrispondente, di un'autorizzazione permanente o di una Access Time Window separata dell'amministratore o dell'integrazione.

Importazione di utenti da CSV

Fai clic su Import per creare utenti in blocco da un foglio di calcolo. Massimo 200 utenti per importazione.

Figura 6: la procedura guidata di importazione CSV

Passaggio 1: carica un CSV. Trascina un file .csv oppure fai clic per sfogliare. Download template ti fornisce un file iniziale con le intestazioni corrette.

Passaggio 2: mappa i campi. Ogni colonna del CSV viene mappata su un campo: First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants, oppure Do not import. I nomi di intestazione comuni (ad es. mobile, phone, groups) vengono mappati automaticamente. Devi mappare almeno una colonna di cellulare o email.

• Access enabled accetta true/yes/enabled/1/on/y/active e false/no/disabled/0/off/n/inactive.
• Door grants / Scope grants accettano i nomi delle porte o degli Access Scope; i nomi senza corrispondenza vengono segnalati nell'anteprima.

Passaggio 3: anteprima e importazione. Verifica le prime righe, scegli se Send invitation email to imported users (vengono invitati solo gli utenti con un'email), quindi fai clic su Import. I risultati mostrano i conteggi Imported, Skipped (already exist) ed Errors.

Il pannello dei dettagli dell'utente

Fai clic su una riga qualsiasi per aprire il pannello dell'utente.

Figura 7: il pannello di un membro sincronizzato

Profilo e identità

L'intestazione mostra la fonte, lo stato dell'iscrizione, l'External ID e se l'utente è consentito da una policy.

• First name / Last name / Mobile phone / Email: per gli utenti sincronizzati vengono sovrascritti a ogni passaggio di sincronizzazione, a meno che la riga non sia disaccoppiata (vedi sotto).
• Person type e Membership status: usati dalle condizioni Who delle Access Policy.
• Synced tags (di sola lettura, dal sistema di origine) e Custom tags (di proprietà dell'amministratore, mai sovrascritti dalla sincronizzazione). Entrambi i tipi possono soddisfare i tag delle policy.
• Notes: testo libero, fino a 2000 caratteri.

Messaggio nell'app

App messaging imposta un messaggio personale mostrato nella dashboard dell'app di questo utente, sopra il banner per l'intera struttura quando sono attivi entrambi. Quando si applica un messaggio automatico, il pannello lo mostra con i controlli per disattivare l'automazione per questo utente. Vedi Messaggi nell'app.

Track source updates (solo utenti sincronizzati)

Per gli utenti Integration/CCTV, l'interruttore Track source updates stabilisce se la sincronizzazione continua a sovrascrivere la riga:

• Attivo (predefinito): nome, telefono, email, tipo, stato, tag sincronizzati e Access Time Windows di proprietà della fonte vengono aggiornati a ogni sincronizzazione riuscita.
• Disattivato (disaccoppiato): dopo una conferma esplicita, le Access Time Windows di proprietà della fonte vengono cancellate e la sincronizzazione ignora completamente questa riga. Le tue modifiche manuali e le finestre di proprietà dell'amministratore vengono conservate e le rimozioni nella fonte non hanno più effetto su di essa. La riga mostra un badge Decoupled.

Riattiva l'interruttore per riaccoppiare. Lo snapshot corrente delle finestre della fonte viene ripristinato alla successiva sincronizzazione completa riuscita, non da un recupero dalla fonte non riuscito o parziale.

I pannelli degli utenti sincronizzati includono anche i link al record di origine (il record dell'integrazione o la persona in Computer Vision).

Rimosso dall'integrazione

Quando un membro viene eliminato nell'integrazione, il suo accesso alle porte viene rimosso e il pannello mostra Removed by integration. La riga resta nell'elenco, così il suo storico viene conservato. Vedi Sincronizzazione e integrazioni.

Controllo accessi

Figura 8: la sezione Access Control

La sezione Access Control raggruppa le impostazioni di autorizzazione dell'utente: l'interruttore di disattivazione dell'accesso, la copertura delle policy, l'accesso permanente aggiuntivo e le Access Time Windows dell'amministratore o dell'integrazione.

Access enabled (l'interruttore di disattivazione)

L'interruttore Access enabled blocca o ripristina immediatamente tutto l'accesso alle porte per questo utente. Quando è disattivato:

• Ogni tentativo di sblocco del membro viene negato (motivo: accesso disattivato), indipendentemente da policy, autorizzazioni o Access Time Windows.
• La riga mostra un badge Disabled e appare attenuata nell'elenco.

Usalo per sospendere immediatamente una persona senza eliminarne il record né modificare le policy.

Accesso permanente aggiuntivo

Le autorizzazioni danno a questa specifica persona l'accesso in aggiunta a quanto consentito dalle Access Policies della struttura. Quando una policy copre già l'utente, la sezione mostra Allowed by policy e "This user's door access is set by policy — no manual grants are needed." Fai clic su Show per aprire l'editor delle autorizzazioni:

Le porte già coperte da una policy sono contrassegnate con Already covered by policy o Set by policy, così puoi vedere dove un'autorizzazione manuale non è necessaria. Le autorizzazioni possono avere propri orari di validità, che limitano quando si applicano. Clear all rimuove tutte le autorizzazioni in una volta. L'importazione automatica delle policy e le successive modifiche alle policy non cambiano le autorizzazioni permanenti.

Gli indicatori di policy e di autorizzazione sono additivi. La rimozione di un'autorizzazione manuale ridondante non rimuove l'accesso tramite policy e la modifica di una policy non rimuove l'autorizzazione.

Finestre temporali di accesso

La sezione Access Time Windows gestisce l'accesso additivo temporaneo per questa persona, con Add one-time window e Add weekly window (fino a 50):

• Le finestre assolute e settimanali di proprietà dell'amministratore sono modificabili e possono riguardare la struttura, porte selezionate o Access Scopes.
• Le finestre di proprietà dell'integrazione sono di sola lettura e mostrano la fonte, l'ID della fonte, il fuso orario dichiarato, la mappatura logica degli ambiti, l'età della fonte e lo stato di aggiornamento.
• Gli stati attivo, imminente, scaduto, obsoleto e non mappato vengono mostrati separatamente. Una finestra obsoleta o non mappata non concede l'accesso, ma le Access Policies e le autorizzazioni permanenti restano disponibili come percorsi alternativi.
• Gli istanti esatti usano limiti [from, to). Le finestre settimanali usano il fuso orario IANA visualizzato e le relative regole sull'ora legale.

Il pannello riporta: "Time windows add access. They do not restrict existing rules or grants." Vedi Pianificazioni delle Access Policies.

Invito

Mostra se è stata inviata un'email di invito all'app, quando e se l'invio non è riuscito; il pulsante riporta Send invitation email o Resend invitation email. Gli inviti avvengono solo via email. Tutti i dettagli in Inviti.

Sessioni e attività nell'app

• App activity: Last used the app con data e ora (oppure "Hasn't used the app yet.") e gli indirizzi IP recenti.
• Sessions: Sign out of app revoca la sessione dell'utente nell'app: "This revokes the user's app session. They'll need to sign in again to unlock doors." Nota: "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." Poiché le sessioni sono associate al telefono o all'email, una persona che usa lo stesso telefono o la stessa email presso un'altra struttura viene disconnessa anche lì.

Eliminazione di un utente

Figura 9: la zona pericolosa

Delete user rimuove la riga da Users. "Their access log history is kept for the audit trail." L'eliminazione disattiva anche immediatamente il suo accesso. Per gli utenti sincronizzati, tieni presente che la persona può ricomparire alla sincronizzazione successiva, a meno che tu non disattivi anche l'integrazione o disaccoppi la riga; per eliminare intere integrazioni, usa Bulk delete synced users in Sincronizzazione e integrazioni.

Personale di Performance Hub

Figura 10: il pannello di un membro del personale del Performance Hub

Il pannello di un membro del personale ha il banner Synced from Performance Hub IAM. I membri del personale vengono aggiunti automaticamente perché i loro ruoli nel Performance Hub includono questa struttura e vengono rimossi quando tale accesso termina. Il banner elenca i loro ruoli.

• Nome, email, telefono e tipo di persona sono gestiti in Performance Hub IAM e qui sono di sola lettura.
• I Synced tags (come Performance Hub staff e Role: …) vengono sovrascritti a ogni sincronizzazione. Puoi comunque aggiungere Custom tags e Notes.
• I membri del personale non possono essere eliminati qui. Rimuovi il loro accesso alla struttura in Performance Hub IAM, oppure disattiva Access enabled per revocare immediatamente il loro accesso alle porte.

Vedi Sincronizzazione del personale del Performance Hub.

Pagine correlate

• Inviti
• Access Policies
• Pianificazioni delle Access Policies
• Access Scopes
• Sincronizzazione e integrazioni
• Come funzionano le decisioni di accesso