Descripción general

Controla quién ve tu documentación y personaliza su experiencia

Los planes Pro incluyen autenticación por contraseña.

Los planes Enterprise incluyen todos los métodos de autenticación.

Elige entre tres enfoques para gestionar el acceso y personalizar tu documentación según la información del usuario y tus necesidades de seguridad:

• Autenticación completa: Protección total de la privacidad para todo el contenido con personalización completa.
• Autenticación parcial: Control de acceso página por página con personalización completa.
• Personalización: Personalización del contenido sin garantías de seguridad. Todo el contenido permanece públicamente accesible.

Ejemplos de uso

Elige autenticación completa cuando:

• Estés creando documentación interna de la empresa que contenga información sensible
• Documentes APIs propietarias que requieran verificación de usuario
• Crees guías de implementación específicas para clientes

Elige autenticación parcial cuando:

• Ofrezcas guías públicas de inicio con funciones avanzadas privadas
• Administres un producto freemium donde los usuarios premium obtengan documentación adicional
• Publiques documentación de código abierto con secciones empresariales privadas

Elige personalización cuando:

• Crees documentación pública de API que muestre ejemplos específicos del usuario
• Construyas sitios de marketing que personalicen el contenido según los perfiles de usuario
• Ofrezcas tutoriales públicos que se adapten a las preferencias o niveles de habilidad del usuario

Métodos de autenticación

Elige el método que mejor se adapte a tu infraestructura y a tus requisitos de seguridad.

Método	Disponible para	Complejidad de configuración	Ideal para
JWT	Todos los enfoques	Media	Flujos de inicio de sesión personalizados, máximo control de seguridad
OAuth 2.0	Todos los enfoques	Alta	Proveedores de autenticación de terceros, seguridad de nivel empresarial
Mintlify Dashboard	Solo autenticación	Baja	Equipos que ya usan el panel de Mintlify
Password	Solo autenticación	Baja	Acceso compartido simple sin personalización
Shared Session	Solo personalización	Baja	Apps con autenticación basada en sesiones existente

Cuándo usar cada método

JWT: Úsalo cuando ya tengas un sistema de autenticación y quieras control total del flujo de inicio de sesión. Ideal para la gestión de usuarios personalizada o cuando necesites desacoplar el acceso a la documentación de tu aplicación principal.

OAuth 2.0: Úsalo cuando quieras aprovechar proveedores de autenticación de terceros (Google, GitHub, etc.) o necesites estándares de seguridad de nivel empresarial. Ideal para organizaciones que ya usan infraestructura OAuth.

Mintlify Dashboard: Úsalo cuando tus editores de documentación también sean los lectores. Perfecto para equipos internos que ya gestionan el contenido desde el panel de Mintlify.

Password: Úsalo para un control de acceso sencillo cuando no necesites rastrear usuarios individuales ni personalizar contenido. Útil para contratistas, usuarios beta o accesos temporales.

Shared Session: Úsalo cuando quieras un inicio de sesión transparente entre tu aplicación y la documentación. Ideal cuando los usuarios ya están autenticados en tu aplicación principal y quieres personalizar su experiencia en la documentación.

Personalización de contenido

Los tres enfoques admiten funciones de personalización, como contenido MDX dinámico, prellenado de claves de API y controles de visibilidad de páginas. Para obtener pautas de implementación detalladas, consulta la Configuración de personalización.