SSO (Entreprise)
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Qu'est-ce que le SSO ?
Section intitulée « Qu'est-ce que le SSO ? »Le Single Sign-On (SSO) permet à votre équipe de se connecter à Capgo via le fournisseur d'identité (IdP) de votre entreprise. Capgo utilise SAML 2.0 via Supabase Auth. Lorsque le domaine e-mail d'un utilisateur correspond à un fournisseur SSO actif, il peut s'authentifier auprès de votre IdP et est provisionné dans l'organisation lors du callback SSO.
Le SSO ne modifie pas les droits des utilisateurs. Les permissions sont gérées par les rôles de l'organisation. Le SSO change uniquement la méthode d'authentification.
Prerequisites
Section intitulée « Prérequis »Avant de commencer :
- L'abonnement Enterprise est actif sur l'organisation Capgo.
- Un fournisseur d'identité qui prend en charge SAML 2.0 et expose une URL de métadonnées IdP (HTTPS).
- Possibilité de publier un enregistrement DNS TXT pour le domaine d'e-mail (ex.
company.compour les utilisateurs se connectant en tant queuser@company.com). - Un membre de l'organisation Capgo autorisé à modifier les paramètres de l'organisation.
- Une admin IdP de votre service informatique/sécurité.
Où trouver les paramètres SSO
Section intitulée « Où trouver les paramètres SSO »- Ouvrez https://console.capgo.app/
- Cliquez Paramètres dans la barre latérale gauche
- Sélectionnez l’ Organisation onglet
- Sélectionnez l’ Sécurité onglet
- Défiler jusqu'à configuration SSO. Le formulaire n'est disponible que si l'organisation dispose du plan Enterprise.
Étape 1 - Configurez votre IdP
Section intitulée « Étape 1 - Configurez votre IdP »Dans votre fournisseur d'identité, créez une nouvelle application SAML 2.0. Vous aurez besoin des Fournisseur de services valeurs affichées dans le panneau de configuration SSO de Capgo :
| Champ | Où l'utiliser |
|---|---|
| URL ACS | URL Assertion Consumer Service de votre application SAML IdP |
| ID de l'entité | Identifiant d'entité du Service Provider |
| URL de métadonnées SP | Optionnel : importez si votre IdP prend en charge l'import des métadonnées SP par URL |
| Format NameID | Format attendu pour le Name Identifier SAML |
Votre IdP doit transmettre l'adresse e-mail de l'utilisateur dans l'assertion. Capgo utilise le domaine de l'e-mail pour déterminer le fournisseur SSO actif et associer les comptes existants.
Étape 2 - Ajoutez le fournisseur SSO dans Capgo
Section intitulée « Étape 2 - Ajouter le fournisseur SSO dans Capgo »- Dans le panneau de configuration SSO, cliquez pour ajouter un nouveau fournisseur
- Saisissez le domaine d'e-mail (ex.
company.com). Il doit correspondre à la partie domaine des e-mails de connexion de vos utilisateurs - Saisissez votre IdP URL de métadonnées IdP (HTTPS)
- Envoyer
Le fournisseur est créé avec le statut En attente de vérification.
Étape 3 - Vérification du domaine via DNS
Section intitulée « Étape 3 - Vérification du domaine DNS »Capgo vérifie que vous contrôlez le domaine avant d'activer le SSO.
Ajoutez une TXT enregistrement chez votre fournisseur DNS :
| Champ | Valeur |
|---|---|
| Type | TXT |
| Nom / hôte | _capgo-sso.<your-domain> (ex. _capgo-sso.company.com) |
| Valeur | Le token de vérification affiché dans le panneau du dashboard |
Une fois l’enregistrement publié (la propagation du TTL DNS prend généralement de quelques minutes à une heure), cliquez sur Vérifier le DNS dans le dashboard. En cas de succès, le fournisseur passe à l’état Vérifié.
Étape 4 - Activez le fournisseur
Section intitulée « Étape 4 - Activer le fournisseur »Après la vérification DNS, cliquez sur Activer. Le statut du fournisseur devient Actif. Seuls les Actif fournisseurs sont utilisés lors du flux de connexion SSO.
Vous pouvez choisir Désactiver dans le dashboard à tout moment. Cela déplace le fournisseur vers Désactivé, ce qui suspend le SSO pour ce domaine sans supprimer la configuration.
Étape 5 - Testez et attribuez les rôles
Section intitulée « Étape 5 - Tester et assigner les rôles »Lorsqu'un utilisateur se connecte via SSO pour la première fois et n'est pas encore membre de cette organisation, Capgo lui attribue le lecture rôle.
Une fois les utilisateurs pilotes connectés :
- Accéder à Paramètres → Organisation → Membres
- Trouvez chaque utilisateur provisionné via SSO
- Ajustez leur rôl’au niveau approprié (Envoyer, Écrire, Admin, etc.)
Consultez le détail complet des permissions pour ce que chaque rôle peut faire.
Optionnel - Imposer le SSO
Section intitulée « Facultatif - Imposer le SSO »Sur un Actif fournisseur, vous pouvez activer Imposer le SSO. Lorsqu'il est activé, Capgo marque les utilisateurs auth existants de ce domaine d'e-mail comme « SSO uniquement » et le flux de connexion nécessite une authentification IdP pour ce domaine. En réglant le fournisseur sur Désactivé (Désactiver) ou désactiver l’application stricte supprime ce drapeau SSO uniquement pour le domaine.
Référence de l'état du fournisseur
Section intitulée « Référence de l’état du fournisseur »| Statut | Signification |
|---|---|
| En attente de vérification | Enregistrement DNS TXT non encore vérifié |
| Vérifié | Propriété du domaine confirmée ; prêt à activer |
| Actif | Le SSO est actif pour ce domaine |
| Désactivé | Configuré par Désactiver dans le dashboard ; SSO non utilisé pour ce domaine ; utilisez Réactiver pour revenir à Actif |
Checklist de déploiement progressif
Section intitulée « Checklist de déploiement »- Plan Enterprise confirmé
- Application SAML créée dans l'IdP avec l'URL ACS et l'ID d'entité de Capgo
- IdP configuré pour émettre une revendication e-mail stable
- Enregistrement DNS TXT publié et Vérifier le DNS réussi
- Fournisseur activé
- Utilisateurs pilotes connectés avec succès
- Rôles élevés par rapport au rôle par défaut lecture au besoin
- Décision d'application prise (et communiquée si activée)
Documentation associée
Section intitulée « Documentation associée »Continuer depuis le SSO (Enterprise)
Section intitulée « Continuer après SSO (Enterprise) »Si vous utilisez SSO (Entreprise) pour planifier les flux d'authentification et de compte, le connecter à @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, Authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs, et 5 étapes pour implémenter OAuth2 dans les apps Capacitor pour le contexte pratique dans « 5 étapes pour implémenter OAuth2 dans les apps Capacitor ».