Solo Krea Enterprise — Il SAML SSO è disponibile esclusivamente per i clienti Krea Enterprise. Contatta il nostro team commerciale per saperne di più sui piani Enterprise.
Prerequisiti
Prima di iniziare, assicurati di avere:Dominio verificato
Completa prima la Verifica del dominio
Ruolo nel workspace
Devi essere owner o admin del workspace
Accesso all'Identity Provider
Accesso admin al tuo IdP (Okta, Google Workspace, ecc.)
Piano Enterprise
Abbonamento Krea Enterprise attivo
Passaggio 1: ottieni i dettagli del Service Provider Krea
Dopo aver completato la verifica del dominio, la modale di configurazione mostrerà la sezione di configurazione SAML.
Ti serviranno questi due valori per configurare il tuo identity provider:
| Campo | Valore |
|---|---|
| ACS URL | https://superb.krea.ai/auth/v1/sso/saml/acs |
| Entity ID | https://superb.krea.ai/auth/v1/sso/saml/metadata |
| Metadata XML | https://superb.krea.ai/auth/v1/sso/saml/metadata |
Passaggio 2: configura il tuo Identity Provider
Crea un’applicazione SAML nel tuo identity provider usando i valori del Passaggio 1.- Okta
- Google Workspace
Accedi alle applicazioni
Accedi alla tua Okta Admin Console (di solito
https://your-org.okta.com/admin) e vai su Applications → Applications nella barra laterale.Crea l'integrazione dell'app
Clicca su Create App Integration.Seleziona SAML 2.0 come metodo di accesso e clicca su Next.
Configura le impostazioni generali
Inserisci Krea come App name.Facoltativamente carica un logo per una facile identificazione.Clicca su Next.
Configura le impostazioni SAML
Inserisci i seguenti valori:
| Campo | Valore |
|---|---|
| Single sign-on URL | https://superb.krea.ai/auth/v1/sso/saml/acs |
| Audience URI (SP Entity ID) | https://superb.krea.ai/auth/v1/sso/saml/metadata |
| Name ID format | EmailAddress |
| Application username |
Completa la configurazione
Clicca su Next.Nella pagina Feedback, seleziona “I’m an Okta customer adding an internal app” e clicca su Finish.
Ottieni l'URL dei metadati
Nella pagina dell’applicazione, vai alla scheda Sign On.Scorri fino a SAML Signing Certificates e trova il Metadata URL. Clicca su Actions → View IdP metadata per ottenere l’URL.
Riferimento: Help Okta - Creare integrazioni di app SAML ↗
Passaggio 3: collega il tuo IdP a Krea
Tornando alla modale di Krea, fornisci i metadati del tuo IdP:- URL (consigliato)
- Metadata XML
Ideale per: Okta e altri IdP che forniscono un URL pubblico dei metadati
- Nella modale di Krea, seleziona la scheda URL
- Incolla il Metadata URL del tuo IdP nel campo di testo
- Clicca su Save changes
Usare un URL permette a Krea di recuperare automaticamente i certificati aggiornati quando il tuo IdP li ruota.
Passaggio 4: testa la tua configurazione
Apri una finestra in incognito
Usa una nuova finestra del browser in incognito/privata per evitare sessioni in cache.
Vai al login di Krea
Vai su krea.ai/login ↗
Clicca sul pulsante SSO
Nella pagina di login, clicca sul pulsante SSO per avviare l’autenticazione SAML.
Inserisci la tua email
Digita un indirizzo email del tuo dominio verificato (ad esempio,
you@acme.com)Autenticati con il tuo IdP
Dovresti essere reindirizzato alla pagina di login della tua organizzazione.
Riuscito! Se riesci ad accedere, il tuo SAML SSO è configurato correttamente. Invita i membri del tuo team a usare il pulsante SSO con la loro email di lavoro per accedere.
Imporre il SAML SSO
Una volta configurato e testato l’SSO, puoi imporlo a tutti gli utenti con il tuo dominio verificato. Questo garantisce che chiunque nella tua organizzazione si autentichi tramite il tuo identity provider.
Vai alle impostazioni del workspace
Vai su Workspace Settings ↗ e scorri fino alla sezione Single Sign-On (SSO).
Disabilitare l’imposizione
Se hai bisogno di disabilitare l’imposizione dell’SSO:- Vai su Workspace Settings ↗
- Nella sezione Single Sign-On (SSO), trova il toggle Enforce SSO
- Clicca sul toggle per disabilitare l’imposizione
- Gli utenti riavranno la possibilità di accedere con password o magic link
Disabilitare l’imposizione non disabilita l’SSO stesso — gli utenti possono comunque scegliere di accedere tramite SSO usando il pulsante SSO nella pagina di login.
Risoluzione dei problemi
Configurazione SSO non riuscita
Configurazione SSO non riuscita
- Controlla gli URL — assicurati che ACS URL e Entity ID siano esattamente come mostrati (senza slash finali)
- Verifica l’accesso ai metadati — se usi un URL, assicurati che sia accessibile pubblicamente
- Prova invece l’XML — se l’URL non funziona, scarica e incolla direttamente l’XML
- Controlla la scadenza del certificato — i certificati IdP scaduti faranno fallire la configurazione
Gli utenti non riescono ad accedere
Gli utenti non riescono ad accedere
- Cliccare sul pulsante SSO — gli utenti devono cliccare sul pulsante SSO nella pagina di login (non basta inserire l’email)
- Assegnare gli utenti nell’IdP — gli utenti devono essere assegnati all’app SAML di Krea nel tuo IdP
- Controllare il Name ID — verifica che il Name ID sia impostato sul formato email/EmailAddress nel tuo IdP
- Verificare il dominio email — le email degli utenti devono corrispondere esattamente al dominio verificato
- Controllare il provisioning utenti — gli utenti potrebbero dover essere prima invitati al workspace Krea
Errore 'Invalid SAML response'
Errore 'Invalid SAML response'
- Disallineamento dell’orologio — assicurati che l’orologio del server IdP sia accurato (entro 5 minuti dall’ora reale)
- Condizioni dell’asserzione — verifica che le condizioni NotBefore/NotOnOrAfter dell’asserzione SAML siano valide
- Problemi di firma — verifica che venga utilizzato il certificato corretto
Loop di redirect o pagina vuota
Loop di redirect o pagina vuota
- Cancella i cookie — cancella tutti i cookie relativi a Krea e riprova
- Controlla l’ACS URL — assicurati che non ci siano errori di battitura nell’ACS URL configurato nel tuo IdP
- Verifica il dominio — conferma che la verifica del dominio sia ancora attiva
Gestire l’SSO
Visualizzare lo stato dell’SSO
- Vai su Workspace Settings ↗
- Scorri fino alla sezione Domain Management
- La card SSO mostra:
- Stato Enabled con un indicatore verde
- Il tuo dominio verificato
- Pulsante Configure per modificare le impostazioni
Aggiornare i metadati dell’IdP
Se hai bisogno di aggiornare i metadati del tuo IdP (ad esempio, dopo una rotazione del certificato):- Vai su Workspace Settings ↗
- Nella sezione Domain Management, clicca su Configure nella card SSO
- Aggiorna l’URL o l’XML dei metadati
- Clicca su Save changes
Disabilitare l’SSO
- Vai su Workspace Settings ↗
- Nella sezione Domain Management, clicca su Configure nella card SSO
- Clicca su Disable SSO in fondo alla modale
- Conferma l’azione
Hai bisogno di aiuto?
Supporto Enterprise
Contatta il nostro team di supporto enterprise all’indirizzo support@krea.ai
Team commerciale
Domande sui piani Enterprise? Scrivi a sales@krea.ai