Saltar al contenido principal
Los planes Pro incluyen autenticación con contraseña.Los planes Enterprise incluyen todos los métodos de autenticación.
La autenticación requiere que los usuarios inicien sesión antes de acceder a tu documentación.

​
Modos de Autenticación

Elige entre autenticación completa o parcial según tus necesidades de control de acceso. Autenticación completa: Todas las páginas están protegidas. Los usuarios deben iniciar sesión antes de acceder a cualquier contenido. Autenticación parcial: Algunas páginas son públicas, mientras que otras requieren autenticación. Los usuarios pueden navegar el contenido público libremente y autenticarse solo al acceder a páginas protegidas. Al configurar cualquiera de los métodos de handshake a continuación, selecciona Autenticación completa o Autenticación parcial en la configuración de tu dashboard.

​
Configuración de la autenticación

Selecciona el método de enlace (handshake) que deseas configurar.
  • Contraseña
  • Dashboard de Mintlify
  • OAuth 2.0
  • JWT (JSON Web Token)
La autenticación con contraseña solo proporciona control de acceso y no admite la personalización de contenido.

​
Requisitos previos

  • Tus requisitos de seguridad permiten compartir contraseñas entre usuarios.

​
Implementación

1

Crea una contraseña.

  1. En tu dashboard, ve a Autenticación.
  2. Selecciona Autenticación completa o Autenticación parcial.
  3. Selecciona Contraseña.
  4. Ingresa una contraseña segura.
  5. Selecciona Guardar cambios.
2

Distribuye el acceso.

Comparte de forma segura la contraseña y la URL de la documentación con los usuarios autorizados.

​
Ejemplo

Tu documentación está alojada en docs.foo.com y necesitas un control de acceso básico sin rastrear a usuarios individuales. Quieres impedir el acceso público manteniendo una configuración sencilla.Crea una contraseña segura en tu dashboard. Comparte las credenciales con los usuarios autorizados. ¡Listo!

​
Hacer públicas las páginas

Cuando se utiliza la autenticación parcial, todas las páginas están protegidas de forma predeterminada. Puedes hacer que páginas específicas sean visibles sin autenticación, ya sea a nivel de página o de grupo, con la propiedad public.

​
A nivel de página

Para hacer que una página sea pública, agrega public: true al frontmatter de la página.
Public page example
---
title: "Página pública"
public: true
---

​
Nivel de grupo

Para hacer públicas todas las páginas de un grupo, agrega "public": true debajo del nombre del grupo en el objeto navigation de tu docs.json.
Public group example
{
  "navigation": {
    "groups": [
      {
        "group": "Grupo público",
        "public": true,
        "icon": "play",
        "pages": [
          "quickstart",
          "installation",
          "settings"
        ]
      },
      {
        "group": "Grupo privado",
        "icon": "pause",
        "pages": [
          "private-information",
          "secret-settings"
        ]
      }
    ]
  }
}
⌘I