# Configurer l'authentification unique (SSO)

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

Source: https://aicodeops.dev/fr/docs/sso · Mis à jour le: 2026-10-18

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](https://aicodeops.dev/fr/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 :

| Champ               | SAML 2.0                                                      | OpenID Connect                                   |
| ------------------- | ------------------------------------------------------------- | ------------------------------------------------ |
| **Protocol**        | SAML 2.0                                                      | OpenID Connect                                   |
| **Display Name**    | Un nom que vous reconnaissez, par exemple « Okta »            | Un nom, par exemple « Azure AD »                 |
| **Email Domain**    | Un domaine vérifié                                            | Un domaine vérifié                               |
| **Default Role**    | Member, Developer ou Viewer                                   | Member, Developer ou Viewer                      |
| Paramètres de l'IdP | **IdP Entity ID**, **IdP SSO URL**, **IdP Certificate (PEM)** | **Issuer URL**, **Client ID**, **Client Secret** |

3. 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 :

| Protocole | Libellé          | Chemin                               | Usage                                                   |
| --------- | ---------------- | ------------------------------------ | ------------------------------------------------------- |
| SAML      | **Metadata URL** | `/sso/saml/<connection-id>/metadata` | Métadonnées du fournisseur de service, et son entity ID |
| SAML      | **ACS URL**      | `/sso/saml/<connection-id>/acs`      | Assertion Consumer Service (HTTP-POST)                  |
| OIDC      | **Redirect URI** | `/sso/oidc/<connection-id>/callback` | URI 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.

## 4. Activer et partager le lien

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 :

```text
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](https://aicodeops.dev/fr/docs/members). Vous pouvez changer leur rôle plus tard ; consultez [Rôles et permissions](https://aicodeops.dev/fr/docs/roles-and-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](https://aicodeops.dev/fr/docs/audit-logs) d'un espace de travail, et elles sont conservées 7 jours.

## Étapes suivantes

- [Présentation d'Enterprise](https://aicodeops.dev/fr/docs/enterprise)
- [Rôles et permissions](https://aicodeops.dev/fr/docs/roles-and-permissions)
- [Offre Enterprise](https://aicodeops.dev/fr/enterprise)

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