DGTLMS & LMSDISPATCHER Guide

Autenticazione e SSO

Collegare Keycloak (OpenID Connect)

Consenti ai tuoi utenti di accedere a DGTLMS con il loro account Keycloak, tramite OpenID Connect — con importazione automatica della configurazione.

Amministratore~10 minutiIntermedio
  • Un accesso amministratore Keycloak (per creare un client) e amministratore DGTLMS.
  • L'URL del tuo realm Keycloak.

In Keycloak

  1. Creare un client

    Nel tuo realm, crea un client OpenID Connect (tipo confidenziale).

  2. Indicare l'URL di reindirizzamento

    Aggiungi l'URL di ritorno di DGTLMS (indicato da DGTLMS al momento della configurazione).

  3. Recuperare le credenziali

    Annota il Client ID e il Client secret.

In DGTLMS

  1. Aprire la configurazione

    Amministrazione → Configurazione dell'autenticazione → Aggiungi un metodo di autenticazione → OAuth2 / OpenID Connect.

  2. Importare la configurazione

    Incolla l'URL di discovery del tuo realm — https://<keycloak>/realms/<realm>/.well-known/openid-configuration — poi Importa. Gli endpoint (autorizzazione, token, userinfo, disconnessione) si compilano automaticamente.

  3. Inserire le credenziali del client

    Indica il Client ID e il Client secret ottenuti in Keycloak.

  4. Verificare il mapping degli attributi

    Assicurati che l'e-mail, il cognome e il nome siano associati ai campi Keycloak corrispondenti.

  5. Salvare e testare

    Convalida, poi testa l'accesso dalla pagina di login.

Utenti multiprofilo (studente e formatore…)

Una stessa persona può avere più ruoli in DGTLMS (studente, formatore, livello personalizzato). Con Keycloak funziona senza sviluppo — è una questione di configurazione:

  1. Attivare le due opzioni

    in Amministrazione → Configurazione: «Attivare gli utenti con profili multipli» (scelta del profilo all'accesso) e «Visualizzare il selettore di profilo» (cambio durante la sessione, in alto a destra). Lascia «Connessione automatica degli utenti multi-profilo come discenti» disattivata, altrimenti la scelta viene scavalcata.

  2. Allineare l'identificativo inviato da Keycloak

    DGTLMS collega una persona ai suoi diversi profili tramite la radice dell'identificativo (l'identificativo senza il suffisso di ruolo _APP/_FOR…). Il claim che Keycloak trasmette come login deve quindi corrispondere a questa radice (spesso preferred_username), non necessariamente all'e-mail. Se necessario, aggiungi un mapper Keycloak che emetta esattamente questo identificativo. È l'unico punto davvero specifico da verificare — in particolare per i tuoi account già esistenti in _FOR/_APP.

  3. Creare i ruoli aggiuntivi

    un nuovo utente sconosciuto viene creato automaticamente come studente. Per assegnargli un secondo ruolo (es. formatore), un amministratore aggiunge il profilo dalla sua scheda: DGTLMS aggiunge allora automaticamente il suffisso agli account (_APP, _FOR…). La persona vedrà poi la scelta all'accesso e il selettore durante la sessione.

> Il collegamento all'identità Keycloak si basa sull'identificativo stabile del provider (claim sub): resiste ai cambi di e-mail e sopravvive all'aggiunta di un ruolo.

  • L'URL di discovery deve essere in HTTPS.
  • Keycloak può essere collegato anche in SAML, ma l'OIDC è più semplice grazie all'importazione automatica.
  • L'account deve esistere in DGTLMS (o essere creato tramite provisioning) perché l'accesso vada a buon fine.

Vedi anche