> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management/migrating-to-ldap-or-saml.md). # Migración a LDAP o SAML ``` { _id: '123', email: 'alice@example.com' first_name: 'Alice', last_name: 'Jones' } ``` Ahora, quieres integrarlo con el sistema LDAP/Active Directory de tu empresa. En ese sistema, los detalles de Alice son: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Tu objetivo es que Alice inicie sesión con su nombre de usuario de LDAP (`alicejones`) y su contraseña en lugar de sus antiguas credenciales de Overleaf, sin perder ninguno de sus trabajos. Así es como hacerlo. {% hint style="warning" %} Este proceso requerirá volver a crear el **sharelatex** contenedor, lo que provocará algo de tiempo de inactividad. Recomendamos encarecidamente que te familiarices con este proceso haciéndolo primero en un entorno de prueba/staging. {% endhint %} {% stepper %} {% step %} ### Pide a tus usuarios que actualicen sus direcciones de correo electrónico Las cuentas de Overleaf están vinculadas a direcciones de correo electrónico, así que el primer paso es sincronizar los correos de Overleaf de tus usuarios con sus correos LDAP o SAML. En nuestro ejemplo, le pedirías a Alice que inicie sesión en su cuenta de Overleaf y cambie su correo de `alice@example.com` a `alicejones@tech.example.com`. {% hint style="warning" %} ¡No te olvides de ti mismo! Si eres administrador, también tendrás que actualizar tu propia dirección de correo electrónico. {% endhint %} {% hint style="success" %} Si tienes muchos usuarios, puedes usar el [Migración de nombres de usuario](/on-premises/es/gestion-de-usuarios-y-proyectos/user-management/username-migration.md) script para cambiar en lote la dirección de correo principal de un usuario. {% endhint %} {% endstep %} {% step %} ### Habilita el módulo LDAP o SAML Una vez que se hayan actualizado las direcciones de correo de todos, ¡es hora de activar el cambio! Tendrás que establecer las variables de entorno correctas para tu nuevo método de autenticación y luego volver a crear el **sharelatex** contenedor usando el `bin/up -d` comando. Esto sustituye el formulario de inicio de sesión estándar de Overleaf por tu nuevo formulario LDAP o SAML. {% hint style="info" %} Puedes encontrar la información relevante para habilitar LDAP [aquí](/on-premises/es/configuracion/overleaf-toolkit/authentication/ldap-authentication.md), y SAML 2.0 [aquí](/on-premises/es/configuracion/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Los usuarios ahora pueden iniciar sesión a través de LDAP o SAML La próxima vez que Alice vaya a iniciar sesión, verá el nuevo formulario. ![Página de inicio de sesión de LDAP/Active Directory](/files/0c556bd49e4beedacc9c484db5bcae6cb3f437b0) Pueden introducir su nombre de usuario de LDAP (`alicejones`) y su contraseña, y como su dirección de correo electrónico ahora coincide con la de LDAP, iniciarán sesión directamente en su cuenta de Overleaf existente. Todos sus proyectos estarán exactamente donde los dejaron. Si has habilitado SAML 2.0, los usuarios verán un botón que, al hacer clic, los redirigirá a tu IdP para introducir sus credenciales. Tras una autenticación correcta, volverán a tu instancia de Overleaf y iniciarán sesión en su cuenta. ![Página de inicio de sesión de SAML](/files/621f476927f3cb0851dd8b303b528229d132cc40) {% hint style="info" %} Consulte la [Variables de entorno](broken://pages/8fb72e269ed6d7f1914fe9caa3472414c7e140c7) página para obtener información sobre cómo personalizar la experiencia de la página de inicio de sesión. Y si alguna vez necesitas revertirlo, solo comenta la configuración de LDAP/SAML y vuelve a crear el **sharelatex** contenedor usando el `bin/up -d` comando. Entonces los usuarios podrán iniciar sesión usando su dirección de correo actual y su contraseña específica de Overleaf. {% endhint %} {% endstep %} {% endstepper %} ## Ir en la otra dirección: cambiar de LDAP/SAML de vuelta a la autenticación nativa ¿Qué pasa si has estado usando LDAP o SAML durante un tiempo y quieres pasar al sistema de inicio de sesión integrado de Overleaf (quizá has dejado obsoleto tu LDAP)? ¡No hay problema! Así es como puedes hacer ese cambio. {% stepper %} {% step %} ### Comprueba que el correo de todos sea correcto Las cuentas de tus usuarios ya están vinculadas a sus direcciones de correo LDAP o SAML. Este es el correo que usarán para iniciar sesión a partir de ahora, así que solo asegúrate de que todo se vea bien. {% endstep %} {% step %} ### Deshabilita el módulo LDAP o SAML Simplemente elimina o desactiva los ajustes de configuración de LDAP/SAML y vuelve a crear el **sharelatex** contenedor usando el `bin/up -d` comando. Esto devolverá el formulario nativo de inicio de sesión de Overleaf con correo electrónico y contraseña. ![Página de inicio de sesión de autenticación nativa](/files/b1fbc28b84e8ddebff06c43005b24d94cbe35924) {% endstep %} {% step %} ### Pide a los usuarios que restablezcan sus contraseñas Cuando tus usuarios visiten ahora la página de inicio de sesión, verán el formulario de Overleaf en lugar del de LDAP/SAML. Como puede que nunca hayan tenido una contraseña nativa de Overleaf, tendrán que crear una. Cada usuario debería: * Hacer clic en el enlace "¿Has olvidado tu contraseña?". * Introducir la dirección de correo electrónico asociada a su cuenta (la de LDAP/SAML). * Seguir el enlace del correo de restablecimiento de contraseña para establecer una nueva contraseña. {% hint style="info" %} Si todavía no lo has hecho, consulta nuestra guía sobre cómo habilitar [Entrega de correo electrónico](/on-premises/es/configuracion/overleaf-toolkit/email-delivery.md). {% endhint %} Una vez hecho eso, podrán iniciar sesión con su correo electrónico y su nueva contraseña específica de Overleaf para acceder a todos sus proyectos. {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management/migrating-to-ldap-or-saml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.