> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification unique (SSO)

> Configurez SAML ou OIDC avec des fournisseurs d’identité pour l’authentification de votre équipe.

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

Utilisez l’authentification unique pour accéder à votre Dashboard via SAML ou OIDC. Si vous utilisez Okta, Google Workspace ou Microsoft Entra, nous proposons une documentation spécifique à ces fournisseurs 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 utilisant 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’identifiant de nom : `EmailAddress`
        * Déclarations d’attributs :
          | Nom         | Format du nom | Valeur           |
          | ----------- | ------------- | ---------------- |
          | `firstName` | Basique       | `user.firstName` |
          | `lastName`  | Basique       | `user.lastName`  |
      </Step>

      <Step title="Envoyez-nous les informations de votre IdP">
        Une fois l’application configurée, accédez à l’onglet Connexion et envoyez-nous l’URL des metadata.
        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 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">
        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 les envoyer 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=cf2c3bd5c84708e39d18f593363a27ef" 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-saml-metadata.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=24453fa68cb7b32b3422018c99135719" 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-sp-details.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=7c49c0b77e8bf54fad4053052e28d847" 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>
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Créer une application">
        1. Dans "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="Configurer SAML">
        Accédez à la page de configuration de l’authentification unique (Single Sign-On) et sélectionnez **SAML**. Sous "Basic SAML Configuration", saisissez ce qui suit :

        * Identifier (Entity ID) : l’URI d’audience fournie par Mintlify.
        * Reply URL (Assertion Consumer Service URL) : l’URL ACS fournie par Mintlify.

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

      <Step title="Configurer 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 claims suivants :
           | Name        | Value            |
           | ----------- | ---------------- |
           | `firstName` | `user.givenname` |
           | `lastName`  | `user.surname`   |
      </Step>

      <Step title="Envoyer vos informations IdP à Mintlify">
        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="Attribuer des utilisateurs">
        Accédez à "Users and groups" dans votre application Entra et ajoutez les utilisateurs devant avoir accès à votre Dashboard.
      </Step>
    </Steps>
  </Tab>
</Tabs>