Authentication vs personalization
Mintlify ofrece tanto Autenticación como Personalización. En su mayor parte, la Autenticación es simplemente Personalización + privacidad. Sin embargo, hay algunas diferencias clave que es importante tener en cuenta, de más importante a menos importante:
Garantías de Seguridad
La Autenticación es una solución de documentación privada completamente desarrollada. Cada aspecto de tus documentos, incluyendo el contenido de las páginas, imágenes, resultados de búsqueda y características del asistente de IA, son completamente inaccesibles para usuarios no autenticados.
La Personalización, por otro lado, no ofrece garantías de seguridad para el contenido de tu documentación. Todo el contenido de las páginas, imágenes, resultados de búsqueda y características del asistente de IA pueden ser accedidos por el público. Incluso si estás usando la función de páginas ocultas de Personalización, un atacante motivado aún podría acceder al contenido de una página oculta.
Métodos de Handshake
Debido a la diferencia en los requisitos de seguridad para Autenticación y Personalización, diferentes métodos de handshake están disponibles para cada uno. Ambos métodos ofrecen un Handshake JWT y OAuth, aunque los pasos de configuración son ligeramente diferentes.
La Autenticación ofrece dos métodos de Handshake adicionales:
-
Handshake de Contraseña, que protege tu sitio web con una única contraseña global configurable.
-
Mintlify Auth Handshake, que permitirá a los usuarios ver tu documentación solo si tienen acceso a tu panel de control.
La Personalización ofrece un método de Handshake adicional:
- Handshake de Sesión Compartida, un método super simple que solo requiere configurar un único endpoint que devuelve datos para usuarios ya autenticados.