> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-mintlify-b54f69e3.mintlify.site/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="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/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=75c4b735974026af9a5527717107c266" 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/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-saml-metadata.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=c22616cdfba06487d7aaa662a9014709" 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/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-sp-details.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=29dda7dadc54b194c5701ee710d0009f" 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>