mintlify__docs/fr/dashboard/sso.mdx

---
title: "Authentification unique (SSO)"
description: "Configurez SAML ou OIDC avec des fournisseurs d’identité pour l’authentification de votre équipe."
keywords: ["Authentification SAML", "OIDC", "Intégration Okta", "Fournisseur d'identité"]
---

<Info>
  SSO est disponible avec les [offres Enterprise](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>
                    ![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](/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>
                    ![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.](/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>
                    ![Capture d’écran de la page Service provider details avec les champs de saisie ACS URL et Entity ID mis en évidence.](/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>