Controllo accessi tramite QR Code

La funzione QR Code Keypad consente di utilizzare Thinknx Up come tastiera per il controllo accessi. Scansionando il QR Code associato a un varco, Thinknx Up apre automaticamente la tastiera relativa al progetto e al checker configurato. L'utente può quindi inserire il proprio PIN per richiedere l'accesso.

Il QR Code identifica il progetto e il punto di accesso da utilizzare, mentre l'autorizzazione viene determinata dal PIN inserito e dalle relative impostazioni: abilitazione dell'utente, ruolo, aree consentite, periodo di validità e fascia oraria settimanale.

1. Nel Configurator viene creato e configurato l'oggetto Access Control.
2. Viene creato un prototipo con tecnologia QR Code Keypad, associato alla chiave API dell'Integration Kit.
3. Viene configurato un checker, cioè il punto di accesso fisico, specificando i comandi da eseguire in caso di codice valido o non valido.
4. Dal checker viene generato ed esportato il relativo QR Code.
5. L'utente(con app e progetto scaricato) scansiona il QR Code con il proprio dispositivo mobile e apre la tastiera in Thinknx Up.
6. Thinknx verifica il PIN inserito ed esegue il comando configurato se la richiesta è autorizzata.

Prima di procedere, verificare che siano disponibili:

• un progetto Thinknx contenente un oggetto di sistema Access Control;
• un server Thinknx correttamente configurato e associato al progetto;
• l'Integration Kit abilitato nella pagina del server e una chiave API valida;
• l'applicazione Thinknx Up installata sul dispositivo mobile utilizzato per la scansione;
• almeno un utente di accesso abilitato, con un PIN valido e autorizzato per l'area interessata;
• una connessione dati disponibile sul dispositivo quando richiesta dal collegamento utilizzato dal QR Code.

Aprire il progetto nel Thinknx Configurator e accedere a:

Sistema > Sicurezza > Access Control

Creare un nuovo oggetto oppure selezionare l'oggetto Access Control già presente nel progetto. Configurare quindi i parametri che definiscono il comportamento della tastiera e le regole dei PIN.

Impostare inoltre gli eventuali parametri temporali e le altre opzioni di controllo accessi richieste dall'impianto.

All'interno dell'oggetto Access Control, aprire la raccolta Keypad Prototypes e aggiungere un nuovo prototipo.

1. Assegnare al prototipo un nome chiaro e riconoscibile.
2. Nel parametro Technology, selezionare QR Code Keypad.
3. Inserire nel relativo campo la chiave API generata dopo aver abilitato l'Integration Kit nella pagina del server del progetto.
4. Salvare la configurazione.

Il prototipo definisce il collegamento tra la tastiera QR Code e l'integrazione utilizzata per identificare e autorizzare la richiesta. Lo stesso prototipo può essere utilizzato da uno o più checker.

Il checker rappresenta il punto di accesso concreto, ad esempio una porta, un cancello o un ingresso. Ogni checker utilizza il prototipo configurato e determina quale comando deve essere eseguito in base all'esito della verifica.

Aprire la raccolta Checkers e aggiungere un nuovo elemento:

1. assegnare un nome identificativo al checker;
2. selezionare il prototipo QR Code Keypad creato in precedenza;
3. configurare Command if success, cioè il comando da eseguire quando il PIN viene accettato;
4. se necessario, configurare Command if fail, cioè il comando da eseguire quando la richiesta viene rifiutata;
5. salvare la configurazione.

Quando previsto dalla struttura del progetto, associare successivamente il checker o la porta d'ingresso alle aree pertinenti.

Dalla configurazione del checker, selezionare Show QR code per aprire la finestra contenente il QR Code specifico del punto di accesso.

Sono disponibili le seguenti opzioni:

Posizionare il QR Code esportato in prossimità del varco corrispondente, assicurandosi che sia sufficientemente grande, ben contrastato, protetto e facilmente leggibile dalla fotocamera del dispositivo mobile.

Gli utenti del controllo accessi vengono gestiti tramite l'Access Control Manager. È possibile utilizzare un codice già esistente oppure creare un nuovo utente con un PIN dedicato.

In Thinknx Up:

1. aprire le Proprietà progetto;
2. selezionare Manage Access Control;
3. individuare nell'elenco il codice che si desidera utilizzare;
4. verificare che l'utente sia abilitato;
5. controllare che ruolo e aree autorizzate siano coerenti con il checker configurato.

Il PIN associato all'utente potrà essere inserito nella tastiera visualizzata dopo la scansione del QR Code.

Se non è presente un codice adatto, aprire l'Access Control Manager e selezionare il pulsante +.

Configurare i seguenti dati:

1. nome dell'utente;
2. stato Enabled;
3. ruolo assegnato;
4. aree nelle quali l'utente è autorizzato;
5. PIN numerico;
6. eventuale utilizzo del codice tessera;
7. eventuale intervallo di validità;
8. eventuale calendario settimanale.

Confermare con il segno di spunta per salvare l'utente.

1. Aprire l'applicazione Fotocamera del dispositivo mobile.
2. Inquadrare il QR Code esportato dal checker.
3. Attendere la comparsa del collegamento all'applicazione.
4. Selezionare Apri in Thinknx Up.
5. Thinknx Up apre la tastiera associata al progetto e al checker identificati dal QR Code.

Digitare il PIN completo utilizzando la tastiera visualizzata. Quando il codice viene riconosciuto come valido, gli indicatori diventano verdi. Se richiesto, premere il pulsante verde > per confermare.

Il checker esegue quindi il comando configurato in Command if success.

La validità della richiesta può dipendere da tutti i seguenti elementi:

• stato abilitato dell'utente;
• correttezza e lunghezza del PIN;
• ruolo assegnato;
• autorizzazione per l'area del checker;
• intervallo di validità;
• calendario settimanale.

Se il codice inserito non è corretto o non è autorizzato in quel momento, gli indicatori diventano rossi e il comando di apertura non viene eseguito.

In questo caso:

1. verificare il PIN e il numero di cifre richiesto;
2. controllare che l'utente sia abilitato;
3. verificare ruolo e aree assegnate;
4. controllare l'intervallo di validità e il calendario settimanale;
5. verificare, se configurato, il comportamento di Command if fail.

Thinknx Up può memorizzare localmente il codice del progetto, evitando all'utente di inserirlo manualmente a ogni utilizzo.

Quando l'applicazione segnala che il codice del progetto non è stato salvato:

• selezionare YES per memorizzarlo;
• selezionare NO per continuare senza salvarlo.

Il codice memorizzato è associato al progetto corrente.

Per gestire il codice salvato localmente:

1. aprire le Proprietà progetto;
2. selezionare Predefined ViaVai Code;
3. utilizzare la tastiera visualizzata per sostituire o cancellare il codice.

Per sostituire il codice, inserire il nuovo valore e confermare con la freccia verde.

Per eliminare il codice, cancellare tutte le cifre mediante il pulsante C, lasciare il campo vuoto e confermare.

L'opzione Predefined ViaVai Code può risultare disabilitata fino a quando il progetto e la configurazione del controllo accessi non supportano l'utilizzo di un codice predefinito.

Al termine della configurazione, eseguire una prova completa direttamente sul varco.

• L'oggetto Access Control è presente in Sistema > Sicurezza.
• Lunghezza, cifre disponibili e utilizzo dello zero sono configurati correttamente.
• L'Integration Kit è abilitato e la chiave API è valida.
• È presente un prototipo QR Code Keypad.
• Il checker è associato al prototipo corretto.
• Command if success e, se necessario, Command if fail sono configurati.
• Il QR Code è stato esportato in PNG o SVG ed è conservato in modo sicuro.

• L'utente e il PIN sono abilitati e autorizzati per l'area corretta.
• La scansione del QR Code propone l'apertura di Thinknx Up.
• La scansione apre la tastiera relativa al checker previsto.
• Un PIN valido produce la conferma verde e il comando di successo.
• Un PIN non valido viene rifiutato e, se previsto, attiva il comando di errore.
• La richiesta di memorizzazione del codice è stata verificata su un dispositivo affidabile.
• Il codice predefinito può essere modificato e rimosso dalle Proprietà progetto.

Verificare:

• che l'Integration Kit sia abilitato;
• che la chiave API sia valida e inserita nel prototipo corretto;
• che il checker utilizzi il prototipo QR Code Keypad previsto;
• che Command if success sia configurato correttamente;
• che l'utente sia autorizzato per l'area associata al checker.

Controllare i parametri Code numbers e Zero included nell'oggetto Access Control. Verificare inoltre Code length se la tastiera non accetta il numero di cifre previsto.

Controllare:

• la lunghezza del PIN;
• lo stato abilitato dell'utente;
• il ruolo assegnato;
• le aree autorizzate;
• l'intervallo di validità;
• il calendario settimanale.

Se tutti i PIN validi vengono rifiutati, verificare anche la chiave API dell'Integration Kit, il prototipo selezionato dal checker e la configurazione dell'utente sul server.

• Utilizzare il file PNG o SVG originale esportato dal Configurator.
• Verificare che il QR Code abbia dimensioni e contrasto sufficienti.
• Evitare riflessi, deformazioni o stampe di bassa qualità.
• Non utilizzare immagini oscurate, ritagliate o modificate.
• Verificare che il dispositivo riconosca i collegamenti applicativi associati a Thinknx Up.

• Non inserire chiavi API, URL di configurazione o QR Code operativi in documenti pubblici.
• Esporre il QR Code solamente nel punto di accesso previsto.
• Disabilitare tempestivamente gli utenti che non devono più accedere all'impianto.
• Utilizzare ruoli, aree, periodi di validità e calendari per limitare ogni PIN al solo ambito necessario.
• In caso di diffusione non autorizzata del materiale di configurazione, sostituire le credenziali coinvolte e rigenerare gli elementi necessari.