> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification unique (SSO)

> Personnalisez la manière dont votre équipe peut se connecter à votre tableau de bord d’administration

<Info>
  La fonctionnalité SSO est disponible avec l’[offre Enterprise](https://mintlify.com/pricing?ref=sso).
</Info>

Utilisez l’authentification unique pour accéder à votre tableau de bord via SAML et OIDC. Si vous utilisez Okta, Google Workspace ou Microsoft Entra, nous proposons une documentation spécifique à chaque fournisseur pour configurer le SSO. Si vous utilisez un autre fournisseur, veuillez [nous contacter](mailto:support@mintlify.com).

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

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Créer une application">
        Dans `Applications`, cliquez pour créer une nouvelle intégration d’application avec SAML 2.0.
      </Step>

      <Step title="Configurer l’intégration">
        Renseignez les éléments suivants :

        * URL d’authentification unique (fournie par Mintlify)
        * URI d’audience (fournie par Mintlify)
        * Format de l’ID de nom : `EmailAddress`
        * Déclarations d’attribut :
          | Nom         | Format du nom | Valeur           |
          | ----------- | ------------- | ---------------- |
          | `firstName` | Basic         | `user.firstName` |
          | `lastName`  | Basic         | `user.lastName`  |
      </Step>

      <Step title="Envoyez-nous les informations de votre IdP">
        Une fois l’application configurée, accédez à l’onglet Sign On et envoyez-nous l’URL des métadonnées.
        Nous activerons la connexion de notre côté à partir de ces informations.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OIDC">
    <Steps>
      <Step title="Créer une application">
        Dans `Applications`, cliquez pour créer une nouvelle intégration d’application avec OIDC.
        Choisissez le type d’application `Web Application`.
      </Step>

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

      <Step title="Envoyez-nous les informations de votre IdP">
        Une fois l’application configurée, 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 envoyer ces informations via un service comme 1Password ou SendSafely.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<div id="google-workspace">
  ## Google Workspace
</div>

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Créer une application">
        Sous `Web and mobile apps`, sélectionnez `Add custom SAML app` dans le menu déroulant `Add app`.

        <Frame>
          <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/KAieJWDWb9msJsqT/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=KAieJWDWb9msJsqT&q=85&s=3c22d39ebbc32ac243f02fbb74456e35" alt="" 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 fournie, l’Entity ID et le certificat x509, puis envoyez-les à l’équipe Mintlify.

        <Frame>
          <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/KAieJWDWb9msJsqT/images/gsuite-saml-metadata.png?fit=max&auto=format&n=KAieJWDWb9msJsqT&q=85&s=0c7cf8e29c08986b0b4aff2f8679c238" alt="" 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 (fourni par Mintlify)
        * Entity ID (fourni par Mintlify)
        * Name ID format : `EMAIL`
        * Name ID : `Basic Information > Primary email`

        <Frame>
          <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/KAieJWDWb9msJsqT/images/gsuite-sp-details.png?fit=max&auto=format&n=KAieJWDWb9msJsqT&q=85&s=389cfe426c177e3afcff224ca6bcbdb0" alt="" width="3788" height="1864" data-path="images/gsuite-sp-details.png" />
        </Frame>

        À la page suivante, saisissez 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>
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Create an application">
        1. Sous « Enterprise applications », sélectionnez **New application**.
        2. Sélectionnez **Create your own application** et choisissez « Integrate any other application you don't find in the gallery (Non-gallery) ».
      </Step>

      <Step title="Configure SAML">
        Accédez à la page de configuration Single Sign-On et sélectionnez **SAML**. Sous « Basic SAML Configuration », saisissez les éléments suivants :

        * Identifier (Entity ID) : l’Audience URI fourni par Mintlify.
        * Reply URL (Assertion Consumer Service URL) : l’ACS URL fourni par Mintlify.

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

      <Step title="Configure Attributes & Claims">
        Modifiez la section Attributes & Claims :

        1. Sélectionnez **Unique User Identifier (Name ID)** sous « Required Claim ».
        2. Modifiez l’attribut Source pour utiliser `user.primaryauthoritativeemail`.
        3. Sous Additional claims, créez les revendications suivantes :
           | Name        | Value            |
           | ----------- | ---------------- |
           | `firstName` | `user.givenname` |
           | `lastName`  | `user.surname`   |
      </Step>

      <Step title="Send Mintlify your IdP information">
        Une fois l’application configurée, accédez à la section « SAML Certificates » et envoyez-nous l’App Federation Metadata URL.
        Nous activerons la connexion de notre côté à l’aide de ces informations.
      </Step>

      <Step title="Assign Users">
        Accédez à « Users and groups » dans votre application Entra et ajoutez les utilisateurs qui doivent avoir accès à votre tableau de bord.
      </Step>
    </Steps>
  </Tab>
</Tabs>