Roles
Asigna roles de administrador, editor o lector a los miembros del equipo para controlar el acceso, la edición y los despliegues en Mintlify.
El control de acceso basado en roles (RBAC) está disponible en los planes Enterprise.
Mintlify ofrece tres niveles de acceso al dashboard: lector, editor y administrador.
| Lector | Editor | Administrador | |
|---|---|---|---|
| Ver contenido en el editor | ✅ | ✅ | ✅ |
| Ver el dashboard y Analytics | ✅ | ✅ | ✅ |
| Hacer preguntas al Slack agent | ✅ | ✅ | ✅ |
| Realizar cambios con el Slack agent | ❌ | ✅ | ✅ |
| Editar contenido en el editor web | ❌ | ✅ | ✅ |
| Publicar cambios | ❌ | ✅ | ✅ |
| Crear, renombrar y eliminar páginas | ❌ | ✅ | ✅ |
| Reordenar la navegación | ❌ | ✅ | ✅ |
| Subir archivos multimedia | ❌ | ✅ | ✅ |
| Iniciar implementaciones | ❌ | ✅ | ✅ |
| Crear y eliminar claves de API | ❌ | ✅ | ✅ |
| Configurar integraciones | ❌ | ✅ | ✅ |
| Configurar el assistant | ❌ | ✅ | ✅ |
| Configurar Add-ons | ❌ | ✅ | ✅ |
| Invitar editores y lectores | ❌ | ✅ | ✅ |
| Actualizar roles de usuario | ❌ | ❌ | ✅ |
| Invitar administradores | ❌ | ❌ | ✅ |
| Eliminar usuarios | ❌ | ❌ | ✅ |
| Gestionar la facturación | ❌ | ❌ | ✅ |
| Gestionar SSO | ❌ | ❌ | ✅ |
| Actualizar el dominio personalizado | ❌ | ❌ | ✅ |
| Actualizar la fuente de Git | ❌ | ❌ | ✅ |
| Eliminar la organización | ❌ | ❌ | ✅ |
Limita el acceso de administrador solo a las personas que necesiten realizar tareas de administración.
Por defecto, la persona que crea tu organización en Mintlify tiene acceso de administrador. Agrega miembros adicionales en la página Members de tu dashboard.
Puedes invitar a cualquier número de miembros a tu organización.
Los administradores pueden cambiar el rol asignado a cualquier miembro.
- Ve a la página Members de tu dashboard.
- En la fila del miembro, selecciona un nuevo rol en el menú desplegable de roles.
- Confirma el cambio.
El nuevo rol se aplica la próxima vez que el miembro cargue el dashboard.
Los administradores pueden eliminar por completo a un miembro de la organización, lo que elimina su acceso y cualquier clave que haya creado.
- Ve a la página Members de tu dashboard.
- En la fila del miembro, haz clic en el botón Remove.
- Confirma la eliminación.
Eliminar a un miembro es diferente de revocar credenciales: la eliminación borra al miembro de la organización, mientras que la revocación cierra su sesión y elimina sus claves, pero conserva su pertenencia.
Los administradores pueden cerrar la sesión de un miembro en el dashboard y revocar sus claves y tokens sin eliminarlo de la organización. Utiliza la revocación de credenciales cuando realices el offboarding de alguien o respondas a una cuenta comprometida.
- Ve a la página Members de tu dashboard.
- En la fila del miembro, haz clic en el botón Revoke credentials.
- Selecciona qué credenciales revocar.
- Haz clic en Revoke.
Puedes revocar cualquier combinación de las siguientes credenciales:
| Credencial | Qué hace la revocación |
|---|---|
| Sesiones | Cierra la sesión del miembro en el dashboard. |
| Tokens de CLI | Cierra la sesión del miembro en la CLI. |
| API keys | Elimina las API keys que el miembro creó. |
| Discovery API keys | Elimina las discovery API keys que el miembro creó. |
| Clientes M2M | Revoca las credenciales de cliente de máquina a máquina del miembro. |
| Aplicaciones conectadas | Desconecta las aplicaciones que el miembro autorizó a través de OAuth. |
La revocación de credenciales no se puede deshacer. El miembro puede volver a iniciar sesión y crear nuevas claves y tokens a menos que también lo elimines de la organización o bloquees su método de inicio de sesión. No puedes revocar tus propias credenciales.