Questa guida accompagna gli amministratori enterprise nell'attivazione del Single Sign-On (SSO) SAML, per un'autenticazione degli utenti sicura e centralizzata in AI Studios.
Passaggio 1: configura l'SSO nella dashboard di AI Studios
Accedi al tuo account AI Studios.
Fai clic sull'immagine del profilo (in alto a destra).
Nel menu a discesa, fai clic su Setting.
Nel menu a sinistra, seleziona SAML SSO.
Passaggio 2: configura il tuo Identity Provider (IdP)
Prima di collegare AI Studios al tuo IdP, crea una SAML 2.0 Application nel portale del tuo IdP. AI Studios funziona con Okta e Microsoft Entra ID (in precedenza Azure AD).
Come configurare SAML in Okta
Come configurare SAML in Okta
Passaggio 1: crea una nuova integrazione app
Apri la Okta Admin Console e fai clic su Admin in alto a destra.
Vai su Applications > Applications.
Fai clic su Create App Integration.
Seleziona SAML 2.0 e fai clic su Next.
Passaggio 2: configura l'integrazione SAML
Assegna all'app il nome AI Studios, poi fai clic su Next.
In SAML Settings, inserisci i valori forniti durante la configurazione dell'SSO in AI Studios.
Single sign-on URL
Audience URL (SP Entity ID)
Imposta Name ID format su email.
Imposta Name ID in modo che usi l'attributo email dell'utente.
Passaggio 3: completa la configurazione dell'app
Seleziona I’m an Okta customer adding an internal app.
Seleziona This is an internal app that we have created.
Fai clic su Finish per completare la configurazione.
Passaggio 4: integra l'app con AI Studios
Vai alla scheda Sign On dell'app.
Scorri verso il basso e fai clic su View SAML setup instructions.
Copia i tre parametri seguenti e incollali nella piattaforma AI Studios:
Identity Provider Single Sign-On URL
Identity Provider Issuer (Entity ID)
X.509 Certificate
Passaggio 5: assegna altri utenti all'app
Apri la scheda People in Directory.
Fai clic sul pulsante 'Add Person'
Compila le informazioni, assicurandoti che lo username corrisponda all'indirizzo email che la persona usa per accedere ad AI Studios
Come configurare SAML in Microsoft Entra ID (in precedenza Azure AD)
Come configurare SAML in Microsoft Entra ID (in precedenza Azure AD)
Passaggio 1: crea una nuova applicazione
Nel Microsoft Entra admin center, vai su Microsoft Entra ID
Fai clic su Enterprise Applications
Seleziona All Applications, poi fai clic su + New Application
Scegli Create your own application
Inserisci AI Studios come nome dell'app e fai clic su Create
Passaggio 2: configura il Single Sign-On (SAML)
Dopo aver creato l'app, vai su Set up single sign-on
Nella sezione Basic SAML Configuration, inserisci quanto segue:
Identifier (Entity ID)
Reply URL (Assertion Consumer Service URL)
Fai clic su Save
Passaggio 3: assegna attributi e attestazioni
Fai clic su Edit nella sezione Attributes and Claims
Trova l'attestazione chiamata Unique User Identifier (Name ID)
Cambia il Source attribute in
user.displayname, così il NameID inviato ad AI Studios corrisponde al formato dell'indirizzo email dell'utente
Passaggio 4: copia i parametri di configurazione SAML
Nella sezione Single sign-on, scorri fino alle sezioni SAML Certificates e Set up AI Studios
Copia i valori seguenti:
Identity Provider Single Sign-On URL (Login URL)
Identity Provider Issuer (Microsoft Entra Identifier)
X.509 Certificate (scarica il Certificate (Base64))
Apri le impostazioni SSO nella piattaforma AI Studios
Incolla i tre valori nei rispettivi campi
Fai clic su Save per completare l'integrazione
Passaggio 5: assegna utenti e gruppi
Vai su Users and groups nelle impostazioni dell'app
Fai clic su + Add user/group
Quando aggiungi un nuovo utente, imposta il Display Name in modo che corrisponda all'indirizzo email AI Studios dell'utente
Impostazioni SAML da usare
Impostazione | Valore |
Single Sign-On URL (ACS / Callback URL) | |
Audience URL (SP Entity ID) |
Attestazioni obbligatorie (nessun namespace!)
Includi le seguenti attestazioni nella configurazione SAML del tuo IdP. Tutti i valori devono essere in minuscolo e non devono includere un namespace.
Nome attestazione | Descrizione | Note |
| Indirizzo email dell'utente | Deve essere in minuscolo e chiamarsi esattamente |
⚠️ Attestazioni come emailaddress o email_address non vengono accettate. Il nome deve essere esattamente email.
Passaggio 3: condividi i metadati con AI STUDIOS
Ti verrà chiesto di inserire quanto segue:
Campo | Descrizione |
Idp Single Sign-On URL (Login URL) | L'endpoint di accesso del tuo IdP |
Idp Issuer (Identifier) | Identificatore univoco del tuo IdP |
Certificate | Il tuo certificato di firma SAML |
Come ottenere questi valori dei parametri in Okta
Come ottenere questi valori dei parametri in Okta
Vai su Application > Applications e seleziona l'app AI Studios.
Vai alla scheda Sign On nel menu dell'app.
Scorri verso il basso e fai clic su View SAML setup instructions.
Copia i tre parametri seguenti e incollali nella piattaforma AI Studios:
Identity Provider Single Sign-On URL
Identity Provider Issuer (Entity ID)
X.509 Certificate
Come ottenere questi valori dei parametri in Microsoft Entra ID/Azure AD
Come ottenere questi valori dei parametri in Microsoft Entra ID/Azure AD
Vai su Enterprise applications > Enterprise Applications | All applications > AI Studios
Nella sezione Single sign-on, scorri fino alle sezioni SAML Certificates e Set up AI Studios
Copia i valori seguenti:
Identity Provider Single Sign-On URL (Login URL)
Identity Provider Issuer (Microsoft Entra Identifier)
X.509 Certificate (scarica il Certificate (Base64))
Apri le impostazioni SSO nella piattaforma AI Studios e incolla questi valori nei rispettivi campi.
Dopo l'invio, viene generato un link di configurazione SSO univoco associato al tuo account.
Passaggio 4: attiva o disattiva l'SSO
Vedrai un interruttore per attivare o disattivare l'SSO.
Attivo (predefinito):
Abilita l'accesso SSO sia per gli amministratori sia per i membri del team
Disattivo:
Solo gli amministratori possono accedere con l'SSO
I membri del team non possono accedere al workspace