- Un accesso amministratore Keycloak (per creare un client) e amministratore DGTLMS.
- L'URL del tuo realm Keycloak.
In Keycloak
Creare un client
Nel tuo realm, crea un client OpenID Connect (tipo confidenziale).
Indicare l'URL di reindirizzamento
Aggiungi l'URL di ritorno di DGTLMS (indicato da DGTLMS al momento della configurazione).
Recuperare le credenziali
Annota il Client ID e il Client secret.
In DGTLMS
Aprire la configurazione
Amministrazione → Configurazione dell'autenticazione → Aggiungi un metodo di autenticazione → OAuth2 / OpenID Connect.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.Inserire le credenziali del client
Indica il Client ID e il Client secret ottenuti in Keycloak.
Verificare il mapping degli attributi
Assicurati che l'e-mail, il cognome e il nome siano associati ai campi Keycloak corrispondenti.
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:
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.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 (spessopreferred_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.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.