Descripción general

Controla quién puede ver tu documentación y personaliza su experiencia

Los planes Pro incluyen autenticación con 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: Privacidad total 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 sigue siendo de acceso público.

Ejemplos de casos de uso

Elige autenticación completa cuando:

• Crees documentación interna de la empresa que contenga información confidencial
• Documentes APIs propietarias que requieran verificación de usuarios
• 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
• Operes 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 handshake

Elige el método que mejor se adapte a tu infraestructura actual 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 empresarial
Mintlify Dashboard	Solo autenticación	Baja	Equipos que ya usan el panel de Mintlify
Password	Solo autenticación	Baja	Acceso compartido sencillo sin personalización
Shared Session	Solo personalización	Baja	Apps con autenticación existente basada en sesiones

Cuándo usar cada método

JWT: Úsalo cuando ya tengas un sistema de autenticación y quieras control total sobre el flujo de inicio de sesión. Ideal para la gestión personalizada de usuarios 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 quienes editan la documentación también son quienes la leen. Perfecto para equipos internos que ya gestionan el contenido desde el panel de Mintlify.

Password: Úsalo para un control de acceso simple cuando no necesitas hacer seguimiento de usuarios individuales ni personalizar contenido. Adecuado para contratistas, usuarios beta o escenarios de acceso temporal.

Shared Session: Úsalo cuando quieras un inicio de sesión sin fricciones 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 del contenido

Los tres enfoques admiten funciones de personalización, como contenido MDX dinámico, autocompletado de claves de API y controles de visibilidad de páginas. Para obtener una guía de implementación detallada, consulta Configuración de personalización.