Saltar al contenido principal
La autenticación por correo electrónico requiere un plan Enterprise.
La autenticación por correo electrónico te permite dar acceso a tu documentación privada a clientes, socios y otras personas ajenas a tu organización sin tener que gestionar tu propio proveedor de identidad. Invitas a los lectores por correo electrónico, los organizas en grupos y Mintlify aloja la página de inicio de sesión, los restablecimientos de contraseña y los códigos de inicio de sesión. Usa la autenticación por correo electrónico cuando:
  • Las personas que leen tus páginas no tienen cuentas en un proveedor de identidad que tú controles.
  • Quieres un acceso individual que puedas revocar, en lugar de una contraseña compartida.
  • Quieres mostrar páginas distintas a distintos lectores con grupos.
Si tus lectores ya inician sesión en tu producto, usa OAuth o JWT para que mantengan una sola cuenta.

​
Activa la autenticación por correo electrónico

1

Elige el método por correo electrónico.

  1. En tu dashboard, ve a Access.
  2. Establece Visibility en Private.
  3. Establece Method en Emails.
2

Elige cómo inician sesión los lectores.

Activa uno o ambos métodos de inicio de sesión:
  • Email and password: Los lectores establecen una contraseña desde su correo de invitación y pueden restablecerla por su cuenta.
  • Sign-in code: Los lectores reciben por correo electrónico un código de un solo uso de 6 dígitos cada vez que inician sesión.
3

(Opcional) Personaliza la marca de los correos para lectores.

En Reader emails, define el aspecto de las invitaciones, los restablecimientos de contraseña y los códigos de inicio de sesión:
  • From name: El nombre del remitente que ven los lectores, como Acme Docs. De forma predeterminada, es el nombre de tu sitio.
  • Reply-to: La dirección a la que llegan las respuestas, como support@acme.com.
  • Logo URL: Una URL https:// del logotipo que aparece en la parte superior de cada correo.
  • Brand color: El color de los botones de cada correo.
4

Guarda.

Haz clic en Save. Cuando tu sitio se vuelva a desplegar, los visitantes deberán iniciar sesión para leer tu documentación.
La página de configuración de Access con el método Emails seleccionado. Email and password y Sign-in code están activados, las reglas de dominio asignan el grupo customers a los lectores de acme.com y los correos para lectores usan el nombre de remitente Acme Docs.La página de configuración de Access con el método Emails seleccionado. Email and password y Sign-in code están activados, las reglas de dominio asignan el grupo customers a los lectores de acme.com y los correos para lectores usan el nombre de remitente Acme Docs.

​
Añade lectores

Los lectores son las personas que pueden iniciar sesión en tu sitio. Gestiónalos en la sección Readers de tu configuración de Access.
La tabla Readers con cinco lectores, sus grupos, su estado, la fecha de su último inicio de sesión y la fecha de fin de acceso.La tabla Readers con cinco lectores, sus grupos, su estado, la fecha de su último inicio de sesión y la fecha de fin de acceso.

​
Invita a lectores

  1. Haz clic en Invite.
  2. Introduce una o más direcciones de correo electrónico, una por línea.
  3. Opcionalmente, introduce grupos separados por comas y una fecha en Access until.
  4. Haz clic en Send invites.
Cada lector recibe un correo con un enlace para establecer una contraseña o iniciar sesión. Los enlaces de invitación caducan a los siete días. Los lectores aparecen como Invited hasta que inician sesión por primera vez y, después, como Active.
El cuadro de diálogo Invite readers con dos direcciones de correo de acme.com, los grupos customers y beta, y la fecha de Access until vacía.El cuadro de diálogo Invite readers con dos direcciones de correo de acme.com, los grupos customers y beta, y la fecha de Access until vacía.

​
Importa lectores desde un CSV

Para añadir muchos lectores a la vez, haz clic en Import CSV y elige un archivo con estas columnas:
readers.csv
  • email: Obligatorio.
  • groups: Opcional. Separa varios grupos con ; o |.
  • access_until: Opcional. Una fecha como 2026-12-31.
La fila de encabezado es opcional. La importación no envía correos de invitación. Los lectores importados configuran su cuenta con Forgot password en la página de inicio de sesión, o inician sesión con un código si activaste los códigos de inicio de sesión.

​
Limita durante cuánto tiempo tiene acceso un lector

Establece Access until cuando invites o importes a un lector. Después de esa fecha, el lector no puede iniciar sesión y su sesión actual finaliza.

​
Elimina a un lector

Abre el menú de acciones en la fila del lector y haz clic en Remove reader. Mintlify cierra la sesión del lector la próxima vez que se actualice su sesión, y no podrá volver a iniciar sesión a menos que lo invites de nuevo.

​
Cómo inician sesión los lectores

Cuando alguien visita tu sitio, ve una página de inicio de sesión con tu logotipo. Según los métodos que hayas activado, puede:
  • Introducir su correo electrónico y su contraseña.
  • Hacer clic en Email me a code e introducir el código de 6 dígitos del correo. Los códigos caducan a los 10 minutos.
  • Hacer clic en Forgot password? para recibir un enlace de restablecimiento. Los enlaces de restablecimiento caducan a la hora y solo funcionan una vez.
Un lector introduce jordan@acme.com en la página de inicio de sesión de la documentación de Acme, hace clic en Email me a code y ve un mensaje para introducir el código de 6 dígitos del correo.
Las contraseñas deben tener al menos 12 caracteres. Tras 10 intentos fallidos de contraseña, la cuenta se bloquea durante 15 minutos. Las sesiones duran siete días, o hasta la fecha de Access until del lector si esta llega antes. La página de inicio de sesión nunca revela si un correo electrónico tiene acceso. Quien introduce un correo que no pertenece a un lector ve el mismo mensaje “Check your email” y no se envía ningún correo.

​
Controla el acceso con grupos

Los grupos determinan qué páginas puede ver cada lector. Funcionan igual que los grupos de la autenticación con OAuth y JWT:
  • Las páginas sin la propiedad groups son visibles para todos los lectores que hayan iniciado sesión.
  • Las páginas con la propiedad groups solo son visibles para los lectores que pertenezcan al menos a uno de esos grupos.
  • Las páginas con public: true son visibles para todo el mundo, incluidos los visitantes que no han iniciado sesión.
Page for the partners group
Los lectores obtienen grupos de dos formas:
  • Por lector: Asigna grupos al invitar o importar a un lector.
  • Reglas de dominio: Asigna los mismos grupos a todos los lectores cuyo dominio de correo coincida. Introduce una regla por línea: el dominio y, a continuación, los grupos separados por espacios.
Domain rules
Por ejemplo, una regla para acme.com coincide con dana@acme.com. Una regla para *.acme-partners.com coincide con subdominios como sam@eu.acme-partners.com, pero no con el propio acme-partners.com. Las reglas de dominio solo añaden grupos. Las personas con un dominio coincidente siguen necesitando una invitación para iniciar sesión.

​
Envía los correos para lectores desde tu propio dominio

De forma predeterminada, los correos para lectores se envían desde notifications@mintlify.com con tu From name. Para enviarlos desde tu propia dirección, como docs@docs.acme.com, añade un dominio de envío.
1

Añade tu dominio.

  1. En tu configuración de Access, busca Sending domain en la configuración de Emails.
  2. Introduce el nombre del remitente, como docs, y el dominio, como docs.acme.com.
  3. Haz clic en Add domain.
Usa un subdominio desde el que aún no envíes correo, para que estos registros no afecten a tu configuración de correo existente.
2

Añade los registros DNS.

Copia cada registro en tu proveedor de DNS. Mintlify muestra un registro DKIM TXT y registros SPF MX y TXT en el subdominio send de tu dominio.
3

Verifica.

Cuando los registros se hayan propagado, haz clic en Verify. Cuando el estado cambie a Verified, los correos para lectores se enviarán desde tu dirección.
Hasta que tu dominio esté verificado, los correos para lectores se seguirán enviando desde notifications@mintlify.com. Cada sitio puede tener un dominio de envío, y cada dominio solo puede pertenecer a un sitio. No puedes usar mintlify.com ni sus subdominios. Para cambiar el nombre del remitente, edítalo y guarda. Para dejar de enviar desde tu dominio, haz clic en Remove.