Aller au contenu

SSO (Entreprise)

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.

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.com pour les utilisateurs se connectant en tant que user@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é.
  1. Ouvrez https://console.capgo.app/
  2. Cliquez Paramètres dans la barre latérale gauche
  3. Sélectionnez l’ Organisation onglet
  4. Sélectionnez l’ Sécurité onglet
  5. Défiler jusqu'à configuration SSO. Le formulaire n'est disponible que si l'organisation dispose du plan Enterprise.

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 :

ChampOù l'utiliser
URL ACSURL Assertion Consumer Service de votre application SAML IdP
ID de l'entitéIdentifiant d'entité du Service Provider
URL de métadonnées SPOptionnel : importez si votre IdP prend en charge l'import des métadonnées SP par URL
Format NameIDFormat 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.

  1. Dans le panneau de configuration SSO, cliquez pour ajouter un nouveau fournisseur
  2. Saisissez le domaine d'e-mail (ex. company.com). Il doit correspondre à la partie domaine des e-mails de connexion de vos utilisateurs
  3. Saisissez votre IdP URL de métadonnées IdP (HTTPS)
  4. 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 :

ChampValeur
TypeTXT
Nom / hôte_capgo-sso.<your-domain> (ex. _capgo-sso.company.com)
ValeurLe 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é.

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.

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 :

  1. Accéder à Paramètres → Organisation → Membres
  2. Trouvez chaque utilisateur provisionné via SSO
  3. 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.

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.

StatutSignification
En attente de vérificationEnregistrement DNS TXT non encore vérifié
VérifiéPropriété du domaine confirmée ; prêt à activer
ActifLe 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)

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 ».