L’authentification au tableau de bord Mintlify est disponible sur toutes les offres.L’authentification par mot de passe, OAuth et JWT nécessite une offre Enterprise.
Configurer l’authentification
- Mot de passe
- Tableau de bord Mintlify
- OAuth 2.0
- JWT
L’authentification par mot de passe fournit uniquement un contrôle d’accès et ne prend pas en charge les fonctionnalités spécifiques aux utilisateurs comme le contrôle d’accès basé sur les groupes ou le pré-remplissage du bac à sable d’API.
Prérequis du mot de passe
- Vos exigences de sécurité autorisent le partage de mots de passe entre les utilisateurs.
Configuration du mot de passe
1
Créer un mot de passe.
- Dans votre Dashboard, accédez à Authentication.
- Activez l’authentification.
- Dans la section Password Protection, saisissez un mot de passe sécurisé
2
Distribuer l'accès.
Partagez de manière sécurisée le mot de passe et l’URL de la documentation avec les utilisateurs autorisés.
Exemple de mot de passe
Vous hébergez votre documentation surdocs.foo.com et vous avez besoin d’un contrôle d’accès de base sans suivi des utilisateurs individuels. Vous voulez empêcher l’accès public tout en gardant la configuration simple.Créez un mot de passe robuste dans votre Dashboard. Partagez les identifiants de connexion avec les utilisateurs autorisés.Rendre des pages publiques
public.
Pages individuelles
public: true au frontmatter de la page.
Public page example
Groupes de pages
navigation de votre docs.json.
Public group example
Contrôler l’accès avec des groupes
Example user info
groups dans le frontmatter.
Example page restricted to the admin group
Fonctionnement des groupes avec les pages publiques
- Par défaut, toutes les pages nécessitent une authentification.
- Les pages comportant une propriété
groupsne sont accessibles qu’aux utilisateurs authentifiés appartenant à ces groupes. - Les pages sans propriété
groupssont accessibles à tous les utilisateurs authentifiés. - Les pages avec
public: trueet sans propriétégroupssont accessibles à tout le monde.
Format des données utilisateur
string
Requis pour l’authentification JWT. Le nom d’hôte de votre site de documentation. La chaîne doit correspondre exactement au domaine sur lequel vous déployez votre documentation. Mintlify valide que l’hôte du JWT correspond à l’hôte de la requête afin d’empêcher la réutilisation du jeton sur différents sites.
number
Heure d’expiration de la session, en secondes depuis l’époque Unix. Lorsque l’heure actuelle dépasse cette valeur, l’utilisateur doit s’authentifier de nouveau.
string[]
Liste des groupes auxquels l’utilisateur appartient. Les pages dont le champ
groups dans le frontmatter contient une valeur correspondante sont accessibles à cet utilisateur.Exemple : Un utilisateur avec groups: ["admin", "engineering"] peut accéder aux pages étiquetées avec admin ou engineering dans leur champ groups du frontmatter.Record<string, any>
Données personnalisées accessibles dans les pages MDX via la variable
user pour le contenu personnalisé.object
Préremplit les champs du bac à sable d’API avec des valeurs propres à l’utilisateur. Lorsqu’un utilisateur s’authentifie, ces valeurs renseignent les champs de saisie correspondants dans le bac à sable d’API. Les utilisateurs peuvent remplacer les valeurs préremplies, et leurs remplacements sont conservés dans le stockage local.Seules les valeurs qui correspondent au schéma de sécurité du point de terminaison actuel sont appliquées.
Disponibilité des fonctionnalités
llms.txt, llms-full.txt et skill.md, sont soumis aux mêmes exigences d’authentification que vos pages de documentation.