Authentification unique (SSO)

Personnalisez la manière dont votre équipe peut se connecter à votre Dashboard d’administration

La fonctionnalité SSO est disponible sur l’offre Enterprise.

Utilisez l’authentification unique pour votre Dashboard via SAML et OIDC. Si vous utilisez Okta, Google Workspace ou Microsoft Entra, nous proposons une documentation spécifique par fournisseur pour configurer le SSO. Si vous utilisez un autre fournisseur, veuillez nous contacter.

​

Okta

SAML

1. Créer une application

   Dans Applications, cliquez pour créer une nouvelle intégration d’application avec SAML 2.0.

2. Configurer l’intégration

   Renseignez les éléments suivants :

   • URL d’authentification unique (fournie par Mintlify)
   • URI d’audience (fournie par Mintlify)
   • Name ID Format : EmailAddress
   • Déclarations d’attribut :

     Nom	Format du nom	Valeur
     firstName	Basique	user.firstName
     lastName	Basique	user.lastName

3. Envoyez-nous les informations de votre IdP

   Une fois l’application configurée, accédez à l’onglet de connexion et envoyez-nous l’URL de metadata. Nous activerons la connexion de notre côté à partir de ces informations.

​

Google Workspace

SAML

1. Créer une application

   Sous Web and mobile apps, sélectionnez Add custom SAML app dans le menu déroulant Add app.

   
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.

   
3. Configurer l’intégration

   Sur la page Service provider details, saisissez les informations suivantes :

   • ACS URL (fournie par Mintlify)
   • Entity ID (fourni par Mintlify)
   • Name ID format : EMAIL
   • Name ID : Basic Information > Primary email

   

   Sur 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.

​

Microsoft Entra

SAML

1. Créer une application

   1. Sous « Applications d’entreprise », sélectionnez Nouvelle application.
   2. Sélectionnez Créer votre propre application et choisissez « Intégrer toute autre application introuvable dans la galerie (Hors galerie) ».
2. Configurer SAML

   Accédez à la page de configuration de l’authentification unique et sélectionnez SAML. Sous « Configuration SAML de base », saisissez les éléments suivants :

   • Identificateur (Entity ID) : l’Audience URI fourni par Mintlify.
   • URL de réponse (Assertion Consumer Service URL) : l’URL ACS fournie par Mintlify.

   Laissez les autres valeurs vides et sélectionnez Enregistrer.

3. Configurer les attributs et les revendications

   Modifiez la section Attributs et revendications :

   1. Sélectionnez Identifiant utilisateur unique (Name ID) sous « Revendication requise ».
   2. Modifiez l’attribut Source pour utiliser user.primaryauthoritativeemail.
   3. Sous Revendications supplémentaires, créez les revendications suivantes :

      Nom	Valeur
      firstName	user.givenname
      lastName	user.surname

4. Envoyer à Mintlify les informations de votre IdP

   Une fois l’application configurée, accédez à la section « Certificats SAML » et envoyez-nous l’URL des metadata de fédération de l’application. Nous activerons la connexion de notre côté à l’aide de ces informations.

5. Attribuer des utilisateurs

   Accédez à « Utilisateurs et groupes » dans votre application Entra et ajoutez les utilisateurs qui doivent avoir accès à votre Dashboard.