Vai al contenuto
Bexxo Assistenza

Assistenza La piattaforma Importazione e SSO

Collegare Keycloak

Per gli amministratori Aggiornato il 13 novembre 2026

Collegare un realm Keycloak per sincronizzare le persone e i gruppi dell’organizzazione e preparare l’accesso con l’account Keycloak (SSO).
In questa pagina
  1. Panoramica
  2. Preparare un client in Keycloak
  3. Compilare la sezione Connessione
  4. Ciò che viene importato
  5. Accesso SSO con Keycloak
  6. Verifica e risoluzione dei problemi

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.

Le impostazioni comuni a tutte le importazioniImportare le persone e configurare l’SSO

1Preparare un client in Keycloak

La sincronizzazione si autentica come client confidenziale con account di servizio (flusso client_credentials). Nel realm da leggere:

  1. create un client OpenID Connect con autenticazione del client e account di servizio attivati;

  2. assegnate al suo account di servizio i due ruoli qui sotto del client realm-management;

  3. verificate che il realm risponda a {URL di base}/realms/{realm}/protocol/openid-connect/token (token) e {URL di base}/admin/realms/{realm}/ (letture).

Ruoli del client realm-management

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, enabled e ogni attributo personalizzato nella forma attributes. seguito dal suo nome (solo primo valore), ad esempio attributes.department.
  • Per un gruppo: name e path (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.

  1. Dichiarate tutti gli URL di reindirizzamento mostrati in Accesso SSO (portale e Academy) come URI di reindirizzamento validi del client.

  2. 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

SituazioneDa verificare
Verifica della connessione non riuscitaL’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 rifiutataL’account di servizio del client ha i ruoli view-users e query-groups del client realm-management?
Organizzazione con crittografia attivaLa verifica e la sincronizzazione passano attraverso l’agente Bexxo Protected: deve essere avviato e raggiungere il vostro server Keycloak.
Organizzazione con crittografia attivaInstallare l’agente Bexxo Protected

Non avete trovato la risposta? Contattarci