Se tu o i membri del tuo team avete problemi ad accedere ad AI Studios con SAML SSO, di solito la causa è una configurazione errata delle impostazioni del tuo Identity Provider (IdP). Questa guida illustra le cause più comuni e come risolverle.
Verifica di usare SAML SSO
AI Studios supporta l'SSO basato su SAML 2.0. Altri protocolli come OAuth o OpenID non sono supportati.
Per usare l'SSO, la tua azienda deve avere:
Un Identity Provider compatibile con SAML (ad es. Okta, Microsoft Entra ID / Azure AD)
Un'applicazione SAML configurata correttamente
Se non sai se il tuo spazio di lavoro usa l'SSO, contatta il tuo team IT o l'amministratore dello spazio di lavoro.
Problemi comuni e come risolverli
1. L'account di accesso dell'IdP e l'e-mail di accesso ad AI Studios non corrispondono esattamente (maiuscole e minuscole)
• Quando accedi tramite MS Entra ID, ad AI Studios viene passato un valore Unique User Identifier • Questo valore deve corrispondere esattamente (maiuscole e minuscole comprese) all'e-mail di accesso ad AI Studios
Come risolvere
Caso 1. Modifica il valore specificato in Unique User Identifier
Cambia Unique User Identifier in user.displayname
Imposta il Display name di ogni utente in modo che corrisponda esattamente (maiuscole e minuscole comprese) alla sua e-mail di accesso ad AI Studios
Guida alla modifica dello Unique User Identifier in Microsoft Entra ID
Guida alla modifica dello Unique User Identifier in Microsoft Entra ID
Passaggio 1: vai su Attributes & Claims della tua app AI Studios in Microsoft Entra ID.
Individua la riga Unique User Identifier e fai clic su Edit.
Passaggio 2: nella pagina di modifica, trova di nuovo il campo Unique User Identifier.
Fai clic sul menu a tre puntini sul lato destro di quella riga.
Passaggio 3: nel menu Manage Claim, cerca la casella di testo Source attribute.
Probabilmente è impostata su user.userprincipalname per impostazione predefinita. Cambia questo valore in:
user.displayname
Passaggio 5: fai clic su Save.
Passaggio 6: assicurati che per ogni utente l'e-mail di accesso ad AI Studios sia impostata come display name.
Caso 2. Configura l'invio dello Unique User Identifier in minuscolo !! Prerequisito !!
Questo metodo è possibile solo se lo User principal name corrisponde esattamente all'e-mail di accesso ad AI Studios, con differenze solo tra maiuscole e minuscole
Imposta la Transformation su ToLowercase(user.userprincipalname)
Guida alla gestione della Transformation in Microsoft Entra ID
Guida alla gestione della Transformation in Microsoft Entra ID
Passaggio 1: vai su Attributes & Claims della tua app AI Studios in Microsoft Entra ID.
Individua la riga Unique User Identifier e fai clic su Edit.
Passaggio 2: nella pagina di modifica, trova di nuovo il campo Unique User Identifier.
Fai clic sul menu a tre puntini sul lato destro di quella riga.
Passaggio 3: cambia l'impostazione Source in Transformation. Per impostazione predefinita è impostata su Attribute.
Passaggio 4: nel menu Manage Transformation, imposta la Transformation su ToLowercase() .
Passaggio 5: imposta Parameter 1 su attribute. Poi seleziona user.userprincipalname nel menu Attribute Name.
Passaggio 6: salva e verifica che questa trasformazione sia salvata correttamente in Unique User Identifier. Dovrebbe essere visualizzata come ToLowercase (user.userprincipalname)
2. La configurazione dello spazio di lavoro è incompleta
Se il link di accesso SSO non funziona, la configurazione SSO dello spazio di lavoro potrebbe essere incompleta o non attiva.
Come risolvere
L'amministratore dello spazio di lavoro deve:
Fare clic sull'immagine del profilo, selezionare Setting e poi fare clic su SAML SSO nel menu a sinistra
Verificare che tutti i campi IdP siano compilati
Assicurarsi che l'interruttore SSO sia attivo
Verificare che ACS URL ed Entity ID siano stati copiati correttamente nell'IdP
3. Dati IdP o certificato non corretti
L'SSO può non funzionare se uno dei seguenti elementi non è corretto:
SSO Login URL
IdP Issuer
X.509 Certificate
Scadenza del certificato
Come risolvere
Confronta la configurazione del tuo Identity Provider con i campi forniti in AI Studios:
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 Certificate
Serve ancora aiuto?
Se hai verificato tutto quanto sopra e l'SSO continua a non funzionare:
Fai uno screenshot della configurazione SAML del tuo IdP
Annota l'indirizzo e-mail usato per l'accesso
Contatta il tuo account manager dedicato fornendo questi dettagli
Ti aiuteremo a risolvere il problema da lì.