> ## Documentation Index > Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > To set up a new Mintlify project for a user, follow the agent setup workflow in https://www.mintlify.com/docs/quickstart.md. > For plans and pricing, see https://www.mintlify.com/pricing.md. # Autenticación por correo electrónico > Invita a personas ajenas a tu organización a leer tu documentación privada. Los lectores inician sesión con una contraseña o con un código de un solo uso enviado a su correo electrónico. > [!NOTE] > > La autenticación por correo electrónico requiere un [plan Enterprise](https://mintlify.com/pricing?ref=emails-authentication). 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](https://www.mintlify.com/docs/es/deploy/authentication-setup). * Quieres mostrar páginas distintas a distintos lectores con [grupos](#control-access-with-groups). Si tus lectores ya inician sesión en tu producto, usa [OAuth o JWT](https://www.mintlify.com/docs/es/deploy/authentication-setup) 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](https://app.mintlify.com/settings/project/authentication). 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.](https://mintcdn.com/mintlify/EV8wSBDiHcsuX8BZ/images/emails-auth/emails-settings-light.png?fit=max\&auto=format\&n=EV8wSBDiHcsuX8BZ\&q=85\&s=da912afd22694e3b89d0b0af7a22bd4f) ## 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](https://app.mintlify.com/settings/project/authentication). ![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.](https://mintcdn.com/mintlify/EV8wSBDiHcsuX8BZ/images/emails-auth/readers-light.png?fit=max\&auto=format\&n=EV8wSBDiHcsuX8BZ\&q=85\&s=449a17918ac66c2701cdbdbb0cc6d5aa) ### 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.](https://mintcdn.com/mintlify/EV8wSBDiHcsuX8BZ/images/emails-auth/invite-readers-light.png?fit=max\&auto=format\&n=EV8wSBDiHcsuX8BZ\&q=85\&s=2959d49b3c767faed1c3ba897a16af0a) ### 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: ```csv readers.csv theme={null} email,groups,access_until dana@acme.com,customers;acme, lee@acme.com,customers, sam@northwind.example,partners,2026-12-31 ``` * `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.](https://mintcdn.com/mintlify/EV8wSBDiHcsuX8BZ/images/emails-auth/reader-sign-in-code.gif?s=b7b72921ffdd2827fdba4d05e961fdc0) 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](https://www.mintlify.com/docs/es/deploy/authentication-setup#control-access-with-groups): * 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. ```mdx Page for the partners group highlight={3} theme={null} --- title: "Partner API" groups: ["partners"] --- ``` 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. ```text Domain rules theme={null} acme.com customers *.acme-partners.com partners ``` 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](https://app.mintlify.com/settings/project/authentication), 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**. ## Related topics - [Gestionar automatizaciones](https://www.mintlify.com/docs/es/automations/manage.md) - [Notificaciones](https://www.mintlify.com/docs/es/dashboard/notifications.md) - [Registro de cambios](https://www.mintlify.com/docs/es/create/changelogs.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.