AI CodeOps

Configurer l'authentification unique (SSO)

Mis à jour le

Configurez la connexion SAML 2.0 ou OpenID Connect pour AI CodeOps avec l'offre Enterprise : vérifiez votre domaine, créez une connexion, configurez votre IdP et activez-la.

L'authentification unique permet à vos équipes de se connecter à AI CodeOps par votre propre fournisseur d'identité (IdP), avec SAML 2.0 ou OpenID Connect (OIDC). Tout IdP qui prend en charge l'un de ces protocoles fonctionne ; vous saisissez vous-même ses paramètres, il n'y a donc pas de préréglages par fournisseur.

Avant de commencer

  • Offre. Le SSO fait partie de l'offre Enterprise, tout comme la vérification de domaine. Sans elle, la carte affiche « SSO (SAML 2.0 / OIDC) is available on the Enterprise plan. » Consultez Enterprise.
  • Qui peut le configurer. Le SSO appartient à l'organisation, pas à un seul espace de travail. Les Owners et les Admins de l'organisation voient la carte. Seul un Owner peut créer, modifier et activer une connexion. Les Owners et les Admins peuvent vérifier des domaines, définir l'espace de travail par défaut du SSO, et désactiver et supprimer des connexions.
  • Accès au DNS. Vous devez ajouter un enregistrement TXT pour votre domaine de messagerie.

Les réglages se trouvent dans Configure → Settings, dans la carte Single sign-on.

1. Vérifier votre domaine

  1. Sous Verified Domains, saisissez votre domaine de messagerie, par exemple example.com, et choisissez Verify a domain.
  2. Ajoutez à votre DNS l'enregistrement TXT affiché : - Nom : _codeopsstudio-verify.example.com - Valeur : le token affiché à l'écran
  3. Choisissez Check now. Les modifications DNS peuvent mettre un moment à apparaître : vérifiez de nouveau plus tard si le domaine n'est pas encore vérifié.

Vous ne pouvez pas créer de connexion pour un domaine tant qu'il n'est pas vérifié.

2. Créer une connexion

  1. Choisissez Add SSO connection.
  2. Dans New SSO Connection, renseignez :
ChampSAML 2.0OpenID Connect
ProtocolSAML 2.0OpenID Connect
Display NameUn nom que vous reconnaissez, par exemple « Okta »Un nom, par exemple « Azure AD »
Email DomainUn domaine vérifiéUn domaine vérifié
Default RoleMember, Developer ou ViewerMember, Developer ou Viewer
Paramètres de l'IdPIdP Entity ID, IdP SSO URL, IdP Certificate (PEM)Issuer URL, Client ID, Client Secret
  1. Choisissez Create Connection.

Le client secret OIDC est chiffré au repos. Il n'y a pas de champ pour une URL de métadonnées de l'IdP ; copiez les valeurs depuis votre IdP.

3. Configurer votre fournisseur d'identité

La carte de la connexion affiche les valeurs dont votre IdP a besoin :

ProtocoleLibelléCheminUsage
SAMLMetadata URL/sso/saml/<connection-id>/metadataMétadonnées du fournisseur de service, et son entity ID
SAMLACS URL/sso/saml/<connection-id>/acsAssertion Consumer Service (HTTP-POST)
OIDCRedirect URI/sso/oidc/<connection-id>/callbackURI de redirection pour votre application OIDC

Les chemins sont relatifs à l'adresse de la console, par exemple https://console.aicodeops.dev.

SAML. Envoyez l'adresse e-mail de l'utilisateur comme NameID (format adresse e-mail) ou comme attribut email. Les assertions doivent être signées avec le certificat que vous avez saisi. AI CodeOps vérifie la signature, l'audience, l'expiration et le fait que la réponse correspond à une connexion qu'il a lui-même initiée. La connexion doit partir d'AI CodeOps ; une tuile sur le tableau de bord de votre IdP ne fonctionnera pas.

OIDC. AI CodeOps demande les scopes openid email profile et utilise PKCE.

Une nouvelle connexion est en test tant que vous ne l'activez pas. Pendant ce temps, elle ne connecte que les personnes qui font déjà partie de votre organisation, et ne crée aucun compte. Pour l'essayer avec votre propre compte, ouvrez /sso/saml/<connection-id>/login ou /sso/oidc/<connection-id>/login à l'adresse de la console.

  1. Sur la carte de la connexion, choisissez Activate.
  2. Partagez le lien de connexion avec vos équipes :
https://console.aicodeops.dev/sso/login?domain=example.com

Le lien ouvre Continue with single sign-on si le domaine est absent, de sorte que les personnes peuvent aussi y saisir leur e-mail professionnel. Il trouve la connexion active du domaine et les envoie vers votre IdP.

Nouveaux utilisateurs et rôles

La première connexion par SSO crée le compte de la personne si elle n'en a pas et l'ajoute à votre organisation.

Pour placer directement les nouvelles personnes dans un espace de travail, ouvrez les réglages de cet espace de travail et choisissez Set this workspace as SSO default sur la carte de la connexion. Elles le rejoignent avec le Default Role de la connexion. Sans espace de travail par défaut, elles arrivent dans leur propre espace de travail personnel jusqu'à ce que quelqu'un les invite. Vous pouvez changer leur rôle plus tard ; consultez Rôles et permissions.

Les sessions restent dans votre organisation

Une connexion par votre SSO n'atteint que les espaces de travail de votre organisation et l'espace de travail personnel de la personne. Les espaces de travail d'autres organisations sont bloqués pour cette session, même si la personne en est membre.

Désactiver ou supprimer

  • Deactivate arrête les nouvelles connexions par SSO et conserve la configuration.
  • Delete supprime la connexion après que vous avez confirmé avec Delete connection. Ses utilisateurs se connectent alors avec un mot de passe ou un compte social.

Les modifications du SSO sont enregistrées comme événements d'audit sso.connection.* et sso.domain.* sur l'organisation. Elles n'apparaissent pas sur la page du journal d'audit d'un espace de travail, et elles sont conservées 7 jours.

Étapes suivantes

Questions fréquentes

Quelle offre inclut le SSO ?

Enterprise. Dans les autres offres, la carte Single sign-on indique que le SSO est disponible avec l'offre Enterprise.

Où se trouve l'URL des métadonnées SAML ?

Sur la carte de la connexion, une fois la connexion créée, sous le libellé Metadata URL. Elle a la forme /sso/saml/<connection-id>/metadata et constitue aussi l'entity ID du fournisseur de service.

Peut-on encore se connecter avec un mot de passe une fois le SSO activé ?

Oui. Le SSO ajoute un moyen de se connecter ; il ne désactive pas la connexion par mot de passe ni par compte social pour votre domaine.

Cette page vous a-t-elle été utile ?