SSO (Enterprise)
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Cos'è SSO?
Sezione intitolata “Cos'è SSO?”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.
Prerequisiti
Sezione intitolata “Prerequisiti”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.comper gli utenti che accedono comeuser@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.
Dove trovare le impostazioni SSO
Sezione intitolata “Dove trovare le impostazioni SSO”- Apri https://console.capgo.app/
- Clicca su Impostazioni nella barra laterale sinistra
- Seleziona la Organizzazione scheda
- Seleziona la Sicurezza scheda
- Scorri fino a Configurazione SSO. Il modulo è disponibile solo se l'organizzazione ha un piano Enterprise.
Passaggio 1 - Configura il tuo IdP
Sezione intitolata “Passaggio 1 - Configura il tuo IdP”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:
| Campo | Dove usarlo |
|---|---|
| URL ACS | URL dell'Assertion Consumer Service nella tua app SAML IdP |
| ID entità | Identificatore dell'entità Service Provider |
| URL metadati SP | Facoltativo: importa se il tuo IdP supporta l'importazione dei metadati SP tramite URL |
| Formato NameID | Formato 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”- Nel pannello di configurazione SSO, fai clic per aggiungere un nuovo provider
- Inserisci il dominio email (es.
company.com). Deve corrispondere alla parte di dominio delle email di accesso dei tuoi utenti - Inserisci il tuo IdP URL dei metadati IdP (HTTPS)
- Invia
Il provider viene creato con stato In attesa di verifica.
Passaggio 3 - Verifica del dominio DNS
Sezione intitolata “Passaggio 3 - Verifica del dominio DNS”Capgo verifica che tu controlli il dominio prima che l'SSO possa essere attivato.
Aggiungi un TXT record presso il tuo provider DNS:
| Campo | Valore |
|---|---|
| Tipo | TXT |
| Nome / host | _capgo-sso.<your-domain> (es. _capgo-sso.company.com) |
| Valore | Il 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.
Passaggio 4 - Attiva il provider
Sezione intitolata “Passaggio 4 - Attiva il provider”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:
- Vai su Impostazioni → Organizzazione → Membri
- Trova ogni utente provisionato via SSO
- Regola il loro ruolo al livello appropriato (Carica, Write, Admin, ecc.)
Guarda il dettaglio completo dei permessi su cosa può fare ciascun ruolo.
Opzionale - Richiedi SSO
Sezione intitolata “Opzionale - Enforce SSO”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.
Riferimento stato del provider
Sezione intitolata “Riferimento sullo stato dei provider”| Stato | Significato |
|---|---|
| In attesa di verifica | Record DNS TXT non ancora verificato |
| Verificato | Proprietà del dominio confermata; pronto per l'attivazione |
| Attivo | SSO attivo per questo dominio |
| Disabilitato | Impostato da Disattiva nella dashboard; SSO non in uso per quel dominio; usa Riattiva per tornare a Attivo |
Checklist per il rollout
Sezione intitolata “Checklist di rollout”- 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)
Documentazione correlata
Sezione “Documentazione correlata”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.