Passer au contenu principal
Le contrôle d’accès basé sur les rôles (RBAC) est disponible avec les offres Enterprise.
Mintlify propose trois niveaux d’accès au dashboard : lecteur, éditeur et administrateur. Sans RBAC, chaque membre dispose d’un accès complet au dashboard de votre organisation, et les nouveaux membres rejoignent l’organisation en tant qu’éditeurs.
Limitez l’accès administrateur uniquement aux personnes qui doivent effectuer des tâches d’administration.

Contributeurs du référentiel et déploiements

Toute personne disposant d’un accès en écriture à votre référentiel de documentation peut contribuer en y poussant des modifications. Les push vers votre branche de déploiement sont déployés automatiquement, quel que soit le rôle de la personne dans le dashboard. Les rôles du dashboard contrôlent uniquement ce que les personnes peuvent faire dans le dashboard Mintlify.

Ajouter des membres à votre organisation

Par défaut, la personne qui crée votre organisation Mintlify dispose d’un accès administrateur. Ajoutez des membres supplémentaires depuis la page Members de votre dashboard. Les forfaits Starter peuvent compter jusqu’à 5 membres. Les forfaits Pro et Enterprise peuvent inviter autant de membres que vous le souhaitez. Les éditeurs et administrateurs peuvent inviter des éditeurs et des lecteurs. Seuls les administrateurs peuvent inviter d’autres administrateurs.
  1. Accédez à la page Members de votre dashboard.
  2. Dans New member, saisissez des adresses e-mail, ou collez une liste séparée par des virgules, des points-virgules, des espaces ou des sauts de ligne. Vous pouvez inviter jusqu’à 250 adresses à la fois.
  3. Choisissez un rôle.
  4. Cliquez sur Invite.
Si toutes les adresses sont nouvelles, les invitations sont envoyées immédiatement. Si des adresses sont non valides, en double, ou correspondent à des personnes déjà membres ou déjà invitées, un panneau de vérification s’ouvre. Supprimez des lignes ou modifiez les rôles, puis cliquez sur Send invites. Sur les forfaits Pro et Enterprise, utilisez Bulk invite pour importer un fichier CSV d’adresses e-mail. Choisissez un rôle, cliquez sur Invite, puis vérifiez la liste avant d’envoyer les invitations.

Modifier le rôle d’un membre

Les administrateurs peuvent modifier le rôle attribué à n’importe quel membre.
  1. Accédez à la page Members de votre dashboard.
  2. Sur la ligne du membre, sélectionnez un nouveau rôle dans le menu déroulant Role. La modification est enregistrée immédiatement.
Le nouveau rôle prend effet lors du prochain chargement du dashboard par le membre. Vous ne pouvez pas modifier votre propre rôle. Si le rôle d’un membre provient du mappage de groupes SSO, sa ligne affiche Managed by SSO, et vous devez modifier son rôle dans votre fournisseur d’identité.

Supprimer un membre

Les administrateurs peuvent supprimer entièrement un membre de l’organisation, ce qui supprime son accès ainsi que toutes les clés qu’il a créées.
  1. Accédez à la page Members de votre dashboard.
  2. Sur la ligne du membre, ouvrez le menu d’actions et sélectionnez Remove member.
  3. Cliquez sur Remove pour confirmer.
La suppression d’un membre est différente de la révocation des identifiants : la suppression retire le membre de l’organisation, tandis que la révocation le déconnecte et efface ses clés tout en conservant son appartenance.

Révoquer les identifiants d’un membre

Les administrateurs peuvent déconnecter un membre du dashboard et révoquer ses clés et jetons sans le retirer de l’organisation. Utilisez la révocation des identifiants lors de l’offboarding d’une personne ou en réponse à un compte compromis.
  1. Accédez à la page Members de votre dashboard.
  2. Sur la ligne du membre, ouvrez le menu d’actions et sélectionnez Revoke credentials.
  3. Sélectionnez les identifiants à révoquer.
  4. Cliquez sur Revoke.
Vous pouvez révoquer toute combinaison des identifiants suivants : La révocation des identifiants est irréversible. Le membre peut se reconnecter et créer de nouvelles clés et de nouveaux jetons, sauf si vous le retirez également de l’organisation ou bloquez sa méthode de connexion. Vous ne pouvez pas révoquer vos propres identifiants.