> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification unique (SSO)

> Configurez l'authentification unique avec des fournisseurs SAML ou OIDC comme Okta, Azure AD et Google Workspace pour sécuriser l'accès de l'équipe.

<Info>
  SSO est disponible avec les [offres Enterprise](https://mintlify.com/pricing?ref=sso).
</Info>

Les administrateurs Enterprise peuvent configurer le SSO SAML pour Okta ou Microsoft Entra directement depuis le Tableau de bord Mintlify. Pour d’autres fournisseurs comme Google Workspace ou Okta OIDC, [contactez-nous](mailto:support@mintlify.com) pour configurer le SSO.

<div id="configure-sso">
  ## Configurer le SSO
</div>

<div id="okta">
  ### Okta
</div>

<Steps>
  <Step title="Configurer le SSO Okta dans votre Tableau de bord Mintlify">
    1. Dans votre Tableau de bord Mintlify, accédez à la page [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso).
    2. Cliquez sur **Configure**.
    3. Sélectionnez **Okta SAML**.
    4. Copiez l’**URL de Single sign on** et l’**Audience URI**.
  </Step>

  <Step title="Créer une application SAML dans Okta">
    1. Dans Okta, sous **Applications**, créez une nouvelle intégration d’application utilisant SAML 2.0.

    2. Saisissez les informations suivantes à partir de Mintlify :
       * **Single sign on URL** : l’URL que vous avez copiée depuis votre Tableau de bord Mintlify
       * **Audience URI** : l’URI que vous avez copiée depuis votre Tableau de bord Mintlify
       * **Name ID Format** : `EmailAddress`

    3. Ajoutez ces déclarations d’attribut :

       | Name        | Name format | Value            |
       | ----------- | ----------- | ---------------- |
       | `firstName` | Basic       | `user.firstName` |
       | `lastName`  | Basic       | `user.lastName`  |
  </Step>

  <Step title="Copier l’URL de metadata Okta">
    Dans Okta, allez dans l’onglet **Sign On** de votre application et copiez l’URL de metadata.
  </Step>

  <Step title="Enregistrer dans Mintlify">
    De retour dans le Tableau de bord Mintlify, collez l’URL de metadata et cliquez sur **Enregistrer les modifications**.
  </Step>
</Steps>

<div id="microsoft-entra">
  ### Microsoft Entra
</div>

<Steps>
  <Step title="Configurer Microsoft Entra SSO dans votre tableau de bord Mintlify">
    1. Dans votre tableau de bord Mintlify, accédez à la page [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso).
    2. Cliquez sur **Configure**.
    3. Sélectionnez **Microsoft Entra ID SAML**.
    4. Copiez l’**URL de connexion unique** et l’**URI d’audience**.
  </Step>

  <Step title="Créer une application d’entreprise dans Microsoft Entra">
    1. Dans Microsoft Entra, accédez à **Enterprise applications**.
    2. Sélectionnez **New application**.
    3. Sélectionnez **Create your own application**.
    4. Sélectionnez « Integrate any other application you don't find in the gallery (Non-gallery) ».
  </Step>

  <Step title="Configurer SAML dans Microsoft Entra">
    1. Dans Microsoft Entra, accédez à **Single Sign-On**.
    2. Sélectionnez **SAML**.
    3. Sous **Basic SAML Configuration**, saisissez ce qui suit :
       * **Identifier (Entity ID)** : l’URI d’audience depuis Mintlify
       * **Reply URL (Assertion Consumer Service URL)** : l’URL de connexion unique depuis Mintlify

    Laissez les autres valeurs vides et sélectionnez **Save**.
  </Step>

  <Step title="Configurer Attributes & Claims dans Microsoft Entra">
    1. Dans Microsoft Entra, accédez à **Attributes & Claims**.
    2. Sélectionnez **Unique User Identifier (Name ID)** sous « Required Claim ».
    3. Modifiez l’attribut Source en `user.primaryauthoritativeemail`.
    4. Sous **Additional claims**, créez les éléments suivants :
       | Name        | Value            |
       | ----------- | ---------------- |
       | `firstName` | `user.givenname` |
       | `lastName`  | `user.surname`   |
  </Step>

  <Step title="Copier l’URL de metadata Microsoft Entra">
    Sous **SAML Certificates**, copiez l’**App Federation Metadata URL**.
  </Step>

  <Step title="Enregistrer dans Mintlify">
    De retour dans le tableau de bord Mintlify, collez l’URL de metadata et cliquez sur **Enregistrer les modifications**.
  </Step>

  <Step title="Affecter des utilisateurs">
    Dans Microsoft Entra, accédez à **Users and groups**. Affectez les utilisateurs qui doivent avoir accès à votre tableau de bord Mintlify.
  </Step>
</Steps>

<div id="jit-provisioning">
  ## Provisionnement JIT
</div>

Lorsque vous activez le provisionnement JIT (just-in-time), les utilisateurs qui se connectent via votre fournisseur d'identité sont automatiquement ajoutés à votre organisation Mintlify.

<Note>
  Le provisionnement JIT fonctionne uniquement pour les connexions initiées par l’IdP. Les utilisateurs doivent se connecter à partir de votre fournisseur d’identité (dashboard Okta ou portail Microsoft Entra) plutôt que de passer par la page de connexion Mintlify.
</Note>

Pour activer le provisionnement JIT, vous devez avoir activé le SSO. Accédez à la page [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso) de votre Dashboard, configurez le SSO, puis activez le provisionnement JIT.

<div id="enforce-sso-only-sign-in">
  ## Imposer la connexion uniquement via SSO
</div>

Les propriétaires de l'organisation peuvent exiger que tous les membres de l'organisation se connectent via votre fournisseur d'identité. Lorsque l'application du SSO est activée, Mintlify rejette les connexions par mot de passe, lien magique et Google OAuth pour les membres de l'organisation.

1. Accédez à la page [Single Sign-On](https://app.mintlify.com/settings/organization/sso) dans votre dashboard.
2. Vérifiez que le SSO est configuré et validé de bout en bout.
3. Activez le bouton bascule **Enforce SSO-only sign-in**.

<Warning>
  Mintlify empêche l'application du SSO si son activation excluait tous les propriétaires de l'organisation. Configurez au moins un e-mail de secours (breakglass) ou vérifiez qu'un propriétaire peut se connecter via votre IdP avant d'imposer le SSO.
</Warning>

Pour cesser d'imposer le SSO, désactivez le bouton bascule. Les autres méthodes de connexion redeviennent immédiatement disponibles.

<div id="verified-domains">
  ## Domaines vérifiés
</div>

Ajoutez les domaines détenus par votre organisation afin que Mintlify puisse rattacher les connexions et les invitations à une identité de confiance. Vous pouvez ajouter jusqu'à cinq domaines vérifiés par organisation.

1. Accédez à la page [Single Sign-On](https://app.mintlify.com/settings/organization/sso) dans votre dashboard.
2. Dans la section **Verified domains**, cliquez sur **Add domain**.
3. Saisissez le domaine (par exemple, `example.com`) et cliquez sur **Add**.
4. Mintlify génère un jeton de vérification. Ajoutez-le en tant qu'enregistrement DNS TXT sur le domaine.
5. Revenez au dashboard et cliquez sur **Verify**. Le statut passe de **Pending** à **Verified** une fois l'enregistrement propagé.

Pour supprimer un domaine, cliquez sur le bouton <Icon icon="trash" /> de suppression à côté de celui-ci.

<div id="breakglass-emails">
  ## E-mails de secours (breakglass)
</div>

Désignez des comptes d'accès d'urgence qui peuvent se connecter même lorsque l'application du SSO est activée ou que votre fournisseur d'identité est inaccessible. Utilisez les e-mails de secours pour restaurer l'accès en cas de panne de votre IdP ou si une mauvaise configuration verrouille les membres.

1. Accédez à la page [Single Sign-On](https://app.mintlify.com/settings/organization/sso) dans votre dashboard.
2. Dans la section **Breakglass emails**, ajoutez les adresses e-mail des membres de l'organisation qui doivent conserver un accès hors SSO.
3. Cliquez sur **Save changes**.

<Tip>
  Utilisez des e-mails de secours pour les comptes de propriétaires qui ne sont pas liés à votre IdP principal, conservez les identifiants dans un gestionnaire de mots de passe sécurisé, et révisez la liste à chaque changement dans l'équipe.
</Tip>

Chaque e-mail de secours doit déjà appartenir à un membre de votre organisation. Les membres listés comme breakglass peuvent se connecter avec un mot de passe, un lien magique ou Google OAuth, même lorsque l'application du SSO est activée.

<div id="map-rbac-roles-with-saml-groups">
  ## Mapper les rôles RBAC avec les groupes SAML
</div>

Attribuez des [rôles](/fr/dashboard/roles) aux utilisateurs en fonction de leur appartenance à des groupes dans le fournisseur d'identité. Lorsqu'un utilisateur se connecte via SSO, Mintlify lit l'attribut `groups` de l'assertion SAML et associe ces groupes aux rôles du tableau de bord.

<div id="configure-group-attribute-statements">
  ### Configurer les déclarations d'attribut de groupe
</div>

Ajoutez une déclaration d'attribut `groups` à la configuration de votre fournisseur d'identité SAML. L'attribut doit utiliser le format de nom `unspecified`.

L'assertion SAML résultante doit inclure un `AttributeStatement`.

```xml Example SAML assertion theme={null}
<saml2:AttributeStatement xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
    <saml2:Attribute Name="groups" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Everyone</saml2:AttributeValue>
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Engineering</saml2:AttributeValue>
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Admins</saml2:AttributeValue>
    </saml2:Attribute>
</saml2:AttributeStatement>
```

**Exigences clés :**

* Le nom de l'attribut doit être `groups` (sensible à la casse)
* Le format de nom doit être `urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified`
* Chaque groupe auquel l'utilisateur appartient doit être un élément `AttributeValue` distinct

<Tabs>
  <Tab title="Okta">
    Dans la configuration de votre application SAML Okta, ajoutez une déclaration d'attribut de groupe :

    | Name     | Name format | Filter        | Value |
    | -------- | ----------- | ------------- | ----- |
    | `groups` | Unspecified | Matches regex | `.*`  |

    Ajustez le filtre pour correspondre aux groupes spécifiques que vous souhaitez envoyer à Mintlify.
  </Tab>

  <Tab title="Microsoft Entra">
    Dans votre application d'entreprise Microsoft Entra :

    1. Accédez à **Single Sign-On** > **Attributes & Claims**.
    2. Sélectionnez **Add a group claim**.
    3. Sélectionnez les groupes à inclure (tous les groupes ou des groupes spécifiques).
    4. Sous **Advanced options**, cochez **Customize the name of the group claim** et définissez le nom sur `groups`.
  </Tab>
</Tabs>

Une fois configuré, Mintlify associe les noms de groupes de l'assertion SAML aux rôles de votre organisation. Pour configurer ou modifier les mappages groupe-rôle, contactez votre représentant de compte Mintlify.

<div id="change-or-remove-sso-provider">
  ## Modifier ou supprimer le fournisseur SSO
</div>

1. Accédez à la page [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso) dans votre Dashboard.
2. Cliquez sur **Configure**.
3. Sélectionnez votre fournisseur SSO préféré ou choisissez de ne pas utiliser le SSO.

Si vous désactivez le SSO, les utilisateurs devront s'authentifier à l'aide d'un mot de passe, d'un lien magique ou de Google OAuth.

<div id="other-providers">
  ## Autres fournisseurs
</div>

Pour les fournisseurs autres que Microsoft Entra ou Okta SAML, [contactez-nous](mailto:support@mintlify.com) pour configurer le SSO.

<div id="google-workspace-with-saml">
  ### Google Workspace avec SAML
</div>

<Steps>
  <Step title="Créer une application">
    1. Dans Google Workspace, accédez à **Web and mobile apps**.
    2. Sélectionnez **Add custom SAML app** dans le menu déroulant **Add app**.

    <Frame>
      <img src="https://mintcdn.com/mintlify/GiucHIlvP3i5L17o/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=GiucHIlvP3i5L17o&q=85&s=2c06c394d98ccd65df92aefceaeb75bd" alt="Capture d’écran de la page de création d’application SAML de Google Workspace avec l’élément de menu « Add custom SAML app » mis en évidence" width="3804" height="1860" data-path="images/gsuite-add-custom-saml-app.png" />
    </Frame>
  </Step>

  <Step title="Envoyez-nous les informations de votre IdP">
    Copiez l’URL SSO, l’Entity ID et le certificat x509 fournis, puis envoyez-les à l’équipe Mintlify.

    <Frame>
      <img src="https://mintcdn.com/mintlify/GiucHIlvP3i5L17o/images/gsuite-saml-metadata.png?fit=max&auto=format&n=GiucHIlvP3i5L17o&q=85&s=e9e47998599205dc051e9402cba63756" alt="Capture d’écran de la page d’application SAML de Google Workspace avec l’URL SSO, l’Entity ID et le certificat x509 mis en évidence. Les valeurs spécifiques de chacun sont floutées." width="3800" height="1850" data-path="images/gsuite-saml-metadata.png" />
    </Frame>
  </Step>

  <Step title="Configurer l’intégration">
    Sur la page Service provider details, saisissez les éléments suivants :

    * ACS URL (fournie par Mintlify)
    * Entity ID (fourni par Mintlify)
    * Name ID format : `EMAIL`
    * Name ID : `Basic Information > Primary email`

    <Frame>
      <img src="https://mintcdn.com/mintlify/GiucHIlvP3i5L17o/images/gsuite-sp-details.png?fit=max&auto=format&n=GiucHIlvP3i5L17o&q=85&s=a410a25f000fe2bc4d735a6ebe7754da" alt="Capture d’écran de la page Service provider details avec les champs de saisie ACS URL et Entity ID mis en évidence." width="3788" height="1864" data-path="images/gsuite-sp-details.png" />
    </Frame>

    À la page suivante, ajoutez les déclarations d’attribut suivantes :

    | Google Directory Attribute | App Attribute |
    | -------------------------- | ------------- |
    | `First name`               | `firstName`   |
    | `Last name`                | `lastName`    |

    Une fois cette étape terminée et les utilisateurs attribués à l’application, informez notre équipe et nous activerons le SSO pour votre compte.
  </Step>
</Steps>

<div id="okta-oidc">
  ### Okta (OIDC)
</div>

<Steps>
  <Step title="Créer une application">
    Dans Okta, sous **Applications**, créez une nouvelle intégration d’application utilisant OIDC. Choisissez le type d’application **Web Application**.
  </Step>

  <Step title="Configurer l’intégration">
    Sélectionnez le flux d’octroi « code d’autorisation » et renseignez l’URL de redirection fournie par Mintlify.
  </Step>

  <Step title="Envoyez-nous les informations de votre IdP">
    Accédez à l’onglet **General** et repérez le Client ID et le client secret. Veuillez nous les transmettre de manière sécurisée, ainsi que l’URL de votre instance Okta (par exemple, `<your-tenant-name>.okta.com`). Vous pouvez les envoyer via un service comme 1Password ou SendSafely.
  </Step>
</Steps>


## Related topics

- [Créer une base de connaissances](/fr/guides/knowledge-base.md)
- [Comment améliorer le SEO de la documentation](/fr/guides/seo.md)
- [Configuration de l'authentification](/fr/deploy/authentication-setup.md)