MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Autenticazione esterna tramite connettore API

Questa pagina illustra l’autenticazione tramite schede di identificazione o PIN attraverso un servizio personalizzato via API. Ciò risulta utile quando il servizio di autenticazione non è supportato in modo nativo da MyQ. Per autenticare le credenziali degli utenti tramite server LDAP o RADIUS, consultare Autenticazione degli utenti da LDAP o RADIUS.

L’autenticazione esterna viene utilizzata per l’accesso al terminale integrato MyQ e al MyQ Desktop Client. L’interfaccia web di MyQ e il MyQ X Mobile Client richiedono credenziali configurate in MyQ.


Come funziona

Viene configurato un connettore API tra MyQ e il servizio di autenticazione. MyQ richiede l’autenticazione tramite questo connettore, mentre dall’altra parte si trova il servizio di autenticazione stesso, in cui sono memorizzati gli utenti e le relative credenziali.

  1. L’utente tenta di effettuare l’accesso al terminale integrato MyQ con uno dei seguenti metodi:

    • Strisciando la propria scheda di identificazione

    • Inserendo il proprio PIN

  2. La richiesta viene inviata al connettore API, contenente il tipo di metodo di accesso e il valore corrispondente.

  3. Il connettore gestisce la comunicazione con il servizio di autenticazione e restituisce a MyQ l’utente corrispondente.

Esistono due modalità operative per l’autenticazione esterna. Essa può costituire il metodo principale di autenticazione degli utenti oppure può essere configurata come autenticazione di riserva nel caso in cui l’autenticazione tramite il database MyQ fallisca. A tal fine, è possibile selezionare l’opzione Utilizza solo se l’autenticazione tramite il database MyQ fallisce.


Richiesta di autenticazione

Metodi di accesso supportati

Questa impostazione definisce il metodo di accesso per il quale viene utilizzata l’autenticazione esterna. L’altro metodo di accesso, non selezionato, autentica l’utente in base alle credenziali presenti in MyQ.

  • Scheda ID

  • PIN

MyQ invia il tipo di metodo di accesso insieme al valore effettivo del PIN o della scheda di identificazione, in modo che il connettore API possa riconoscere quale proprietà utente debba essere utilizzata per individuare l’utente corretto.

Ad esempio, se viene selezionata una scheda di identificazione e l’utente effettua l’autenticazione sul terminale integrato tramite una scheda di identificazione, MyQ invia il messaggio loginType=1&loginValue=1234. Ciò può essere interpretato come il numero della scheda di identificazione 1234.

Se al dispositivo è collegato un lettore di tessere che emula la digitazione dei tasti e un utente striscia la propria scheda, MyQ non è in grado di riconoscere se il valore ricevuto sia un PIN o il numero di una scheda di identificazione. MyQ segnala questa situazione al connettore API (loginType=7). Il connettore deve essere configurato per gestire tali richieste, ad esempio tentando l’autenticazione in base a entrambe le proprietà utente.

Risposta di autenticazione

Identificatori utenti supportati

Il connettore API deve rispondere a MyQ in formato JSON con uno dei valori indicati per associare l’utente corretto ed effettuare il suo accesso al client.

  • Numero personale di un utente esistente in MyQ

  • Nome utente di un utente esistente in MyQ

Esempi di risposte:

  • {"result":0,"personalNumber":"123456"} significa che l’utente è stato identificato con successo dal servizio di autenticazione e che il suo numero personale è 123456. L’utente con questo numero personale in MyQ è stato autenticato.

  • {"result":0,"username":"JohnDoe"} significa che l’utente è stato identificato e che il suo nome utente è JohnDoe. L’utente con questo nome utente in MyQ è stato autenticato.

Stati di errore

  • Utente non valido ({"result":1}) – l’utente è stato individuato, ma il suo account non è valido (ad es. è stato disattivato)

  • Utente non trovato ({"result":2}) – non esiste alcun utente associato alle credenziali

Casi d’uso comuni

Il connettore API esterno può essere utilizzato nella sua forma più semplice per “tradurre” le richieste. Tuttavia, consente anche flussi di lavoro di autenticazione più avanzati, poiché il connettore stesso è in grado di eseguire una serie di operazioni prima di restituire l’utente corrispondente a MyQ.

Esempio 1: è richiesto un servizio di autenticazione non supportato da MyQ

Un connettore che traduce le chiamate API tra MyQ e il servizio di autenticazione remoto.

Esempio 2: Flusso di lavoro di autenticazione avanzato – identità multiple

L’autenticazione esterna può essere utilizzata nei casi in cui sia necessario che avvenga un’operazione tra MyQ e il server di autenticazione. Può trattarsi di una trasformazione, di un riconoscimento avanzato degli utenti in ambienti multidominio e altro ancora.

Configurazione dell’autenticazione esterna

La destinazione dell’autenticazione esterna può essere abilitata e configurata in MyQ > Impostazioni > Autenticazione utente.

users-settings-authentication-external.png
  • URL: digitare l’URL in cui è in esecuzione il connettore API

  • Nome utente: digitare il nome utente richiesto per la connessione al server esterno tramite API

  • Password: digitare la password necessaria per la connessione al server esterno tramite API

  • Metodo di accesso: selezionare il metodo di accesso degli utenti – Scheda ID o PIN

  • Utilizzare solo se l’autenticazione tramite il database MyQ non va a buon fine: questa opzione definisce se l’autenticazione esterna sarà il metodo primario o secondario per l’autenticazione

    • Se abilitata, l’utente viene prima autenticato sul MyQ Print Server e, solo in caso di esito negativo, il tentativo successivo viene effettuato tramite il servizio di autenticazione remota

    • Se disabilitata, non viene eseguita alcuna autenticazione nei confronti del MyQ Print Server; viene sempre utilizzato il servizio di autenticazione esterna