Assistenza La piattaforma Importazione e SSO
Collegare Keycloak
In questa pagina
Panoramica
Keycloak viene letto in sola lettura: utenti, gruppi (sottogruppi compresi) e membri di un realm. Questo articolo riguarda la preparazione in Keycloak e le sezioni Connessione e Accesso SSO; le altre impostazioni sono comuni a tutte le importazioni.
1Preparare un client in Keycloak
La sincronizzazione si autentica come client confidenziale con account di servizio (flusso client_credentials). Nel realm da leggere:
create un client OpenID Connect con autenticazione del client e account di servizio attivati;
assegnate al suo account di servizio i due ruoli qui sotto del client
realm-management;verificate che il realm risponda a
{URL di base}/realms/{realm}/protocol/openid-connect/token(token) e{URL di base}/admin/realms/{realm}/(letture).
Senza crittografia lato client, i nostri server si collegano a Keycloak da Internet: l’indirizzo deve essere in https:// e risolversi unicamente verso indirizzi pubblici. In un’organizzazione cifrata, l’agente Bexxo Protected legge Keycloak dalla vostra rete.
2Compilare la sezione Connessione
Inserite il realm, l’ID e il segreto del client e l’URL di base: l’indirizzo del server in https://, senza /realms, ad esempio https://sso.exemple.ch. Se il vostro server pubblica i suoi realm sotto un percorso (come /auth), includetelo.
Ciò che viene importato
- Un utente disattivato in Keycloak viene importato come inattivo.
- Ogni sottogruppo, a qualsiasi livello, diventa un gruppo. Vengono associati solo i membri diretti: un membro di un sottogruppo non è associato al gruppo padre.
- Proprietà utilizzabili nella corrispondenza dei campi e nei filtri, per una persona:
username,email,firstName,lastName,enablede ogni attributo personalizzato nella formaattributes.seguito dal suo nome (solo primo valore), ad esempioattributes.department. - Per un gruppo:
nameepath(percorso completo, ad esempio/Siège/Vente).
La corrispondenza precompilata copre solo il cognome, il nome e l’email: se necessario, aggiungete una riga per la funzione o il telefono a partire da un attributo personalizzato.
Accesso SSO con Keycloak
L’SSO utilizza un client OpenID Connect del realm, con un proprio ID client e segreto, indipendenti dalla sezione Connessione.
Dichiarate tutti gli URL di reindirizzamento mostrati in Accesso SSO (portale e Academy) come URI di reindirizzamento validi del client.
Inserite l’issuer del realm, nella forma
https://{server}/realms/{realm}, l’ID client e il segreto, salvate, poi verificate la discovery. L’issuer deve essere raggiungibile da Internet, anche per un’organizzazione con crittografia attiva.
L’attivazione dell’SSO e gli effetti di un’interruzione sono descritti nell’articolo generale.
Verifica e risoluzione dei problemi
| Situazione | Da verificare |
|---|---|
| Verifica della connessione non riuscita | L’URL di base è in https://, senza /realms? Il realm e l’ID client sono esatti? L’account di servizio è attivato sul client? |
| Credenziali accettate, lettura rifiutata | L’account di servizio del client ha i ruoli view-users e query-groups del client realm-management? |
| Organizzazione con crittografia attiva | La verifica e la sincronizzazione passano attraverso l’agente Bexxo Protected: deve essere avviato e raggiungere il vostro server Keycloak. |
Non avete trovato la risposta? Contattarci