Vai al contenuto

SSO (Enterprise)

Single Sign-On (SSO) consente al tuo team di accedere a Capgo utilizzando il provider di identità aziendale (IdP). Capgo utilizza SAML 2.0 tramite Supabase Auth. Quando il dominio email di un utente corrisponde a un provider SSO attivo, può autenticarsi presso il tuo IdP e viene provisionato nell'organizzazione durante il callback SSO.

SSO non modifica ciò che gli utenti possono fare. I permessi sono controllati da ruoli organizzativi. SSO modifica solo il metodo di autenticazione.

Prima di iniziare:

  • Abbonamento Enterprise attivo sull'organizzazione Capgo.
  • Un identity provider che supporta SAML 2.0 e espone un IdP URL dei metadati IdP (HTTPS).
  • Capacità di pubblicare un record DNS TXT per il dominio email (es. company.com per gli utenti che accedono come user@company.com).
  • Un membro dell'organizzazione Capgo con i permessi per aggiornare le impostazioni dell'organizzazione.
  • Un Admin IdP contatta il tuo team IT/sicurezza.
  1. Apri https://console.capgo.app/
  2. Clicca su Impostazioni nella barra laterale sinistra
  3. Seleziona la Organizzazione scheda
  4. Seleziona la Sicurezza scheda
  5. Scorri fino a Configurazione SSO. Il modulo è disponibile solo se l'organizzazione ha un piano Enterprise.

Nel tuo identity provider, crea una nuova applicazione SAML 2.0. Ti serviranno i seguenti Service Provider valori mostrati nel pannello di configurazione SSO di Capgo:

CampoDove usarlo
URL ACSURL dell'Assertion Consumer Service nella tua app SAML IdP
ID entitàIdentificatore dell'entità Service Provider
URL metadati SPFacoltativo: importa se il tuo IdP supporta l'importazione dei metadati SP tramite URL
Formato NameIDFormato previsto per il NameID SAML

Il tuo IdP deve rilasciare l' indirizzo email dell'utente nell'assertion. Capgo usa il dominio email per determinare il provider SSO attivo e associare gli account esistenti.

Passaggio 2 - Aggiungi il provider SSO in Capgo

Sezione intitolata “Passo 2 - Aggiungi il provider SSO in Capgo”
  1. Nel pannello di configurazione SSO, fai clic per aggiungere un nuovo provider
  2. Inserisci il dominio email (es. company.com). Deve corrispondere alla parte di dominio delle email di accesso dei tuoi utenti
  3. Inserisci il tuo IdP URL dei metadati IdP (HTTPS)
  4. Invia

Il provider viene creato con stato In attesa di verifica.

Capgo verifica che tu controlli il dominio prima che l'SSO possa essere attivato.

Aggiungi un TXT record presso il tuo provider DNS:

CampoValore
TipoTXT
Nome / host_capgo-sso.<your-domain> (es. _capgo-sso.company.com)
ValoreIl token di verifica mostrato nel pannello della dashboard

Una volta pubblicato il record (la propagazione del DNS TTL richiede di solito da pochi minuti a un'ora), clicca su Verifica DNS nella dashboard. In caso di successo, il provider passa a Verificato.

Dopo la verifica DNS, clicca su Attiva. Lo stato del provider diventa Attivo. Solo Attivo i provider vengono utilizzati durante il flusso di login SSO.

Puoi scegliere Disattiva nella dashboard in qualsiasi momento. Questo sposta il provider in Disabilitato, che mette in pausa l'SSO per quel dominio senza eliminare la configurazione.

Passaggio 5 - Testa e assegna i ruoli

Sezione intitolata “Step 5 - Test and assign roles”

Quando un utente effettua il login tramite SSO per la prima volta e non ha un'iscrizione esistente in quell'organizzazione, Capgo lo provisiona con il letto ruolo.

Dopo l'accesso degli utenti pilota:

  1. Vai su Impostazioni → Organizzazione → Membri
  2. Trova ogni utente provisionato via SSO
  3. Regola il loro ruolo al livello appropriato (Carica, Write, Admin, ecc.)

Guarda il dettaglio completo dei permessi su cosa può fare ciascun ruolo.

Su un Attivo provider è possibile attivare Imponi l'SSO. Quando è attivo, Capgo contrassegna come SSO-only gli utenti auth esistenti per quel dominio email e il flusso di login richiede l'autenticazione IdP per quel dominio. Impostando il provider su Disabilitato (Disattiva) oppure disattivando l'enforcement si rimuove il flag SSO-only per il dominio.

StatoSignificato
In attesa di verificaRecord DNS TXT non ancora verificato
VerificatoProprietà del dominio confermata; pronto per l'attivazione
AttivoSSO attivo per questo dominio
DisabilitatoImpostato da Disattiva nella dashboard; SSO non in uso per quel dominio; usa Riattiva per tornare a Attivo
  • Piano Enterprise confermato
  • App SAML creata nell'IdP con ACS URL ed Entity ID da Capgo
  • IdP configurato per rilasciare un claim email stabile
  • Record DNS TXT pubblicato e Verifica DNS completato
  • Provider attivato
  • Utenti pilota loggati con successo
  • Ruoli elevati rispetto a quelli di default letto se necessario
  • Decisione di enforcement presa (e comunicata se abilitata)

Continua con SSO (Enterprise)

Sezione “Continua da SSO (Enterprise)”

Se stai usando SSO (Enterprise) per pianificare i flussi di autenticazione e account, collegandolo a @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, Autenticazione a due fattori per i dettagli di implementazione in Two-factor authentication, e 5 step per implementare OAuth2 nelle app Capacitor per il contesto pratico in 5 passi per implementare OAuth2 nelle app Capacitor.