Passer au contenu principal
Le SSO est disponible avec les offres Enterprise.
Les administrateurs Enterprise peuvent configurer l’authentification unique (SSO) SAML pour Okta ou Microsoft Entra directement depuis le dashboard Mintlify. Pour d’autres fournisseurs comme Google Workspace ou Okta OIDC, contactez-nous pour configurer le SSO.

​
Configurer le SSO

​
Okta

1

Configurer le SSO Okta dans votre dashboard Mintlify

  1. Dans votre dashboard Mintlify, accédez à la page Identity & access.
  2. Cliquez sur Configure.
  3. Sélectionnez Okta SAML.
  4. Copiez la Single sign on URL et l’Audience URI.
2

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 dashboard Mintlify
    • Audience URI : l’URI que vous avez copiée depuis votre dashboard Mintlify
    • Name ID Format : EmailAddress
  3. Ajoutez ces déclarations d’attribut :
    NameName formatValue
    firstNameBasicuser.firstName
    lastNameBasicuser.lastName
3

Copier l'URL de metadata Okta

Dans Okta, allez dans l’onglet Sign On de votre application et copiez l’URL de metadata.
4

Enregistrer dans Mintlify

De retour dans le dashboard Mintlify, collez l’URL de metadata et cliquez sur Save changes.

​
Microsoft Entra

1

Configurer le SSO Microsoft Entra dans votre dashboard Mintlify

  1. Dans votre dashboard Mintlify, accédez à la page Identity & access.
  2. Cliquez sur Configure.
  3. Sélectionnez Microsoft Entra ID SAML.
  4. Copiez la Single sign on URL et l’Audience URI.
2

Créer une application d'entreprise dans Microsoft Entra

  1. Dans Microsoft Entra, accédez à Enterprise applications.
  2. Cliquez sur New application.
  3. Cliquez sur Create your own application.
  4. Sélectionnez “Integrate any other application you don’t find in the gallery (Non-gallery).”
3

Configurer SAML dans Microsoft Entra

  1. Dans Microsoft Entra, accédez à Single Sign-On.
  2. Cliquez sur SAML.
  3. Sous Basic SAML Configuration, saisissez ce qui suit :
    • Identifier (Entity ID) : l’Audience URI depuis Mintlify
    • Reply URL (Assertion Consumer Service URL) : la Single sign on URL depuis Mintlify
Laissez les autres valeurs vides et cliquez sur Save.
4

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 :
    NameValue
    firstNameuser.givenname
    lastNameuser.surname
5

Copier l'URL de metadata Microsoft Entra

Sous SAML Certificates, copiez l’App Federation Metadata URL.
6

Enregistrer dans Mintlify

De retour dans le dashboard Mintlify, collez l’URL de metadata et cliquez sur Save changes.
7

Affecter des utilisateurs

Dans Microsoft Entra, accédez à Users and groups. Affectez les utilisateurs qui doivent avoir accès à votre dashboard Mintlify.

​
Provisionnement JIT (just-in-time)

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.
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.
Pour activer le provisionnement JIT, vous devez avoir activé le SSO. Accédez à la page Identity & access de votre dashboard, configurez le SSO, puis activez le provisionnement JIT.

​
Domaines vérifiés

Vérifiez la propriété de vos domaines d’e-mail afin que Mintlify puisse restreindre le SSO et le provisionnement des membres aux personnes disposant d’adresses e-mail correspondantes. Lorsqu’une personne se connecte avec une adresse e-mail appartenant à un domaine vérifié, Mintlify la redirige automatiquement vers votre fournisseur d’identité. La redirection automatique fonctionne que vous exigiez ou non le SSO, tant que votre organisation dispose d’une connexion SSO active. Vous pouvez ajouter jusqu’à cinq domaines vérifiés par organisation.
  1. Accédez à la page Identity & access de votre dashboard.
  2. Dans l’onglet SSO, dans la section Verified domains, saisissez le domaine (par exemple, example.com) et cliquez sur Add.
  3. Mintlify génère un jeton de vérification. Dans votre fournisseur DNS, créez un enregistrement TXT avec le nom _mintlify-verification.example.com et le jeton comme valeur. Certains fournisseurs DNS ajoutent automatiquement le domaine. Si c’est le cas du vôtre, saisissez simplement _mintlify-verification comme nom d’enregistrement.
  4. 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 de suppression à côté de celui-ci.

​
Require SSO

Les administrateurs de l’organisation peuvent exiger que toutes les personnes de l’organisation se connectent via votre fournisseur d’identité. Lorsque Require SSO est activé, Mintlify rejette les connexions par mot de passe, lien magique et Google OAuth.
  1. Accédez à la page Identity & access de votre dashboard.
  2. Vérifiez que le SSO fonctionne de bout en bout. Dans une fenêtre de navigation privée, connectez-vous à votre dashboard Mintlify depuis le catalogue d’applications de votre fournisseur d’identité (initié par l’IdP) et depuis la page de connexion Mintlify en utilisant une adresse e-mail sur un domaine vérifié (initié par le SP). Les deux flux doivent effectuer une redirection via votre fournisseur d’identité et vous amener au dashboard.
  3. Dans l’onglet SSO, dans la section Sign-in policy, activez Require SSO.
Vous ne pouvez exiger le SSO qu’après avoir configuré une connexion SSO. Exiger le SSO ne vérifie pas si les membres peuvent toujours se connecter ; ajoutez donc un accès de secours pour au moins un administrateur avant de l’activer.
Pour cesser d’exiger le SSO, désactivez le paramètre. Les autres méthodes de connexion redeviennent immédiatement disponibles.

​
Accès de secours

Désignez les membres qui peuvent contourner le SSO et se connecter avec un mot de passe ou un lien magique. Utilisez l’accès de secours pour restaurer l’accès si votre fournisseur d’identité subit une panne ou si une mauvaise configuration verrouille les membres.
  1. Accédez à la page Identity & access de votre dashboard.
  2. Dans l’onglet SSO, dans la section Break-glass access, saisissez l’adresse e-mail d’un membre qui doit conserver un accès hors SSO et cliquez sur Add.
Chaque e-mail de secours doit correspondre à un membre existant de votre organisation. L’accès de secours ne prend effet que lorsque Require SSO est activé.
Ajoutez un accès de secours pour les comptes administrateurs qui ne sont pas liés à votre fournisseur d’identité principal, conservez les identifiants dans un gestionnaire de mots de passe sécurisé et révisez la liste à chaque changement dans l’équipe.

​
Mapper les rôles RBAC avec les groupes SAML

Attribuez des rôles 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 dashboard.

​
Configurer les déclarations d’attribut de groupe

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.
Example SAML assertion
<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
Dans la configuration de votre application SAML Okta, ajoutez une déclaration d’attribut de groupe :
NameName formatFilterValue
groupsUnspecifiedMatches regex.*
Ajustez le filtre pour correspondre aux groupes spécifiques que vous souhaitez envoyer à Mintlify.
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.

​
Modifier ou supprimer le fournisseur SSO

  1. Accédez à la page Identity & access de 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 supprimez le SSO, les utilisateurs devront s’authentifier à l’aide d’un mot de passe, d’un lien magique ou de Google OAuth.

​
Autres fournisseurs

Pour les fournisseurs autres que Microsoft Entra ou Okta SAML, contactez-nous pour configurer le SSO.

​
Google Workspace avec SAML

1

Créer une application

  1. Dans Google Workspace, accédez à Web and mobile apps.
  2. Cliquez sur Add custom SAML app dans le menu déroulant Add app.
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
2

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.
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 apparaissent floutées.
3

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
Capture d'écran de la page Service provider details avec les champs de saisie ACS URL et Entity ID mis en évidence.
À la page suivante, ajoutez les déclarations d’attribut suivantes :
Google Directory AttributeApp Attribute
First namefirstName
Last namelastName
Une fois cette étape terminée et les utilisateurs affectés à l’application, informez notre équipe et nous activerons le SSO pour votre compte.

​
Okta (OIDC)

1

Créer une application

Dans Okta, sous Applications, créez une nouvelle intégration d’application utilisant OIDC. Choisissez le type Web Application.
2

Configurer l'intégration

Sélectionnez le flux d’octroi « authorization code » et renseignez l’URL de redirection fournie par Mintlify.
3

Envoyez-nous les informations de votre IdP

Accédez à l’onglet General et repérez le client ID et le client secret. Transmettez-les-nous de manière sécurisée, avec l’URL de votre instance Okta (par exemple, <your-tenant-name>.okta.com). Vous pouvez les envoyer via un service comme 1Password ou SendSafely.