Configurare KeyCloak per l’uso con accesso unico Adobe

Ultimo aggiornamento il 29 ott 2026

Configura KeyCloak come provider di identità SAML (IdP) in modo che gli utenti possano accedere alle app e ai servizi Adobe con le credenziali dell’organizzazione.

Prima di iniziare

Assicurati di avere:

  • Ruolo di amministratore di sistema in Adobe Admin Console
  • Accesso amministratore al realm di KeyCloak che autentica gli utenti Adobe
  • Un dominio che puoi verificare e aggiungere alla directory
Suggerimento

Assicurati che l’indirizzo e-mail di ogni utente appartenga a un dominio richiesto in Admin Console. KeyCloak usa l’indirizzo e-mail come identificatore dell’utente.

Crea una directory e scarica i metadati Adobe

Accedi a Admin Console, vai su Impostazioni > Identità > Directory e seleziona Crea directory.

Inserisci un nome directory, seleziona Federated ID, quindi seleziona Avanti.

Seleziona Other SAML Providers, quindi Avanti.

Nella schermata Set up IdP, seleziona Download Adobe Metadata file. Tieni aperta questa schermata per il passaggio successivo.

Importa il client Adobe in KeyCloak

Accedi ad Admin Console di KeyCloak e seleziona il realm che autentica gli utenti Adobe.

Seleziona Clients > Import client.

In Resource file, seleziona Browse e carica il file di metadati Adobe. KeyCloak compila l'ID entità Adobe, l'URL ACS, il certificato e altre impostazioni SAML dal file.

Nota

Importa il file di metadati Adobe invece di creare il client manualmente. In questo modo KeyCloak usa le impostazioni SAML esatte di Adobe.

In Name, inserisci Adobe Identity Management – <nome dell’organizzazione>, quindi seleziona Save.

Verifica le impostazioni importate:

  • Valid redirect URIs mostra l’URL ACS di Adobe.
  • Il Name ID format è email.
  • La firma è attivata in Firma e crittografia.
  • La scheda Chiavi mostra il certificato di Adobe.

Mappatura degli attributi utente

Adobe richiede l’indirizzo e-mail, il nome e il cognome dell’utente nell’asserzione SAML. Crea un client scope che li invii.

Nel pannello di navigazione, seleziona Client scopes > Create client scope.

Inserisci Adobe Identity Scope come nome, seleziona SAML come protocollo, quindi seleziona Salva.

Nella scheda Mapper, seleziona Configura un nuovo mapper (oppure Aggiungi mapper > Per configurazione), quindi seleziona Attributo utente.

Inserisci i valori per il primo attributo nella tabella seguente. Lascia SAML Attribute NameFormat su Non specificato e Aggrega i valori degli attributi disattivato, quindi seleziona Salva.

Inserimento degli attributi utente
Inserisci gli attributi utente.

Ripeti i passaggi 3 e 4 per ciascun attributo nella tabella.

 

Nota

CountryCode non è un attributo Keycloak incorporato.Per inviarlo, aggiungi prima un attributo utente personalizzato in Realm settings > User profile che memorizzi un codice paese ISO 3166-1 di due lettere.

Seleziona Clients, seleziona il client Adobe, quindi seleziona la scheda Client scopes.

Seleziona Aggiungi client scope, seleziona Adobe Identity Scope, quindi seleziona Aggiungi > Predefinito.

Carica i metadati di KeyCloak in Admin Console

In KeyCloak, vai a Realm settings > General > Endpoints e seleziona SAML 2.0 Identity Provider Metadata.

Salva il file XML che si apre, ad esempio come keycloak-idp-metadata.xml.

Torna alla schermata Configura IdP in Adobe Admin Console, carica il file di metadati di KeyCloak, quindi seleziona Avanti.

Lascia attivata la creazione automatica dell’account. Se l’organizzazione esegue il provisioning manuale degli utenti, disattiva questa impostazione.

In Mappatura attributi, seleziona un paese predefinito, quindi seleziona Fine.

Successivamente, verifica la proprietà del dominio e aggiungi il dominio alla directory, se non l’hai già fatto.

Verificare Single Sign-On

Nella Admin Console, vai su Impostazioni > Identità > Directory, quindi seleziona la directory.

Nel pannello dei dettagli della directory, seleziona Test.

Accedi come utente KeyCloak.Verifica che la pagina Convalida IdP riuscita elenchi i valori previsti per ciascun attributo.

Pagina di convalida IdP riuscita di Admin Console
Conferma la riuscita della convalida IdP.

Se manca un attributo, controlla il relativo mapper e verifica che Adobe Identity Scope sia un ambito predefinito nel client Adobe.Per altri problemi, consulta Risolvere gli errori di accesso Federated ID (SSO) oppure eseguire un trace SAML.Per assistenza sulla configurazione, vai su Admin Console > Assistenza per contattare l’Assistenza clienti di Adobe.