> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrar a LDAP o SAML

```text theme={null}
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

Ahora quieres integrarte con el sistema LDAP/Active Directory de tu empresa. En ese sistema, los datos de Alice son:

```text theme={null}
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 nada de su trabajo. A continuación te explicamos cómo conseguirlo.

<Warning>
  Este proceso requiere volver a crear el contenedor **sharelatex**, lo que provocará cierto tiempo de inactividad. Te recomendamos encarecidamente que te familiarices con el proceso realizándolo primero en un entorno de pruebas/staging.
</Warning>

<Steps>
  <Step title="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 de LDAP o SAML.

    En nuestro ejemplo, 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`.

    <Warning>
      ¡No te olvides de ti! Si eres administrador, también tendrás que actualizar tu propia dirección de correo electrónico.
    </Warning>

    <Check>
      Si tienes muchos usuarios, puedes usar el script de [migración de nombres de usuario](/es/on-premises/user-and-project-management/user-management/username-migration) para cambiar de forma masiva la dirección de correo electrónico principal de los usuarios.
    </Check>
  </Step>

  <Step title="Habilita el módulo de LDAP o SAML">
    Una vez actualizadas las direcciones de correo electrónico de todos, ¡es hora de activarlo! Tendrás que establecer las variables de entorno adecuadas para tu nuevo método de autenticación y, a continuación, volver a crear el contenedor **sharelatex** con el comando `bin/up -d`.

    Esto sustituye el formulario de inicio de sesión estándar de Overleaf por el nuevo formulario de LDAP o SAML.

    <Info>
      Puedes encontrar la información necesaria para habilitar LDAP [aquí](/es/on-premises/configuration/overleaf-toolkit/authentication/ldap-authentication) y SAML 2.0 [aquí](/es/on-premises/configuration/overleaf-toolkit/authentication/saml-authentication).
    </Info>
  </Step>

  <Step title="Los usuarios ya pueden iniciar sesión mediante LDAP o SAML">
    La próxima vez que Alice vaya a iniciar sesión, verá el nuevo formulario.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-4.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=d1ff36e97d059a8833611541dfcdc317" alt="Página de inicio de sesión de LDAP/Active Directory" width="348" height="261" data-path="images/on-premises/image-4.jpg" />

    Puede 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á sesión directamente en su cuenta de Overleaf existente. Todos sus proyectos estarán exactamente donde los dejó.

    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 autenticarse correctamente, se les redirigirá de vuelta a tu instancia de Overleaf con la sesión iniciada en su cuenta.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-5.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a3486d88ffd5fe90549a596c05d7aa9" alt="Página de inicio de sesión de SAML" width="353" height="198" data-path="images/on-premises/image-5.jpg" />

    <Info>
      Consulta la página [Variables de entorno](/es/on-premises/configuration/overleaf-toolkit/environment-variables) para obtener información sobre cómo personalizar la experiencia de la página de inicio de sesión.

      Y si alguna vez necesitas revertir el cambio, basta con comentar la configuración de LDAP/SAML y volver a crear el contenedor **sharelatex** con el comando `bin/up -d`. Los usuarios podrán entonces iniciar sesión con su dirección de correo electrónico actual y una contraseña específica de Overleaf.
    </Info>
  </Step>
</Steps>

## En sentido contrario: volver de LDAP/SAML a la autenticación nativa

¿Y si llevas un tiempo usando LDAP o SAML y quieres pasar al sistema de inicio de sesión integrado de Overleaf (quizá porque has dejado de usar LDAP)? ¡No hay problema! Así es como puedes hacer el cambio.

<Steps>
  <Step title="Comprueba que el correo electrónico de todos sea correcto">
    Las cuentas de tus usuarios ya están vinculadas a sus direcciones de correo electrónico de LDAP o SAML. Ese es el correo que usarán para iniciar sesión a partir de ahora, así que asegúrate de que todo esté correcto.
  </Step>

  <Step title="Deshabilita el módulo de LDAP o SAML">
    Simplemente elimina o deja sin definir los ajustes de configuración de LDAP/SAML y vuelve a crear el contenedor **sharelatex** con el comando `bin/up -d`. Esto restablecerá el formulario nativo de inicio de sesión de Overleaf con correo electrónico y contraseña.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-6.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=6ab39d406809e864fc337f47bbd3b03b" alt="Página de inicio de sesión con autenticación nativa" width="407" height="279" data-path="images/on-premises/image-6.jpg" />
  </Step>

  <Step title="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 inicio de sesión de Overleaf en lugar del de LDAP/SAML.

    Como es posible que nunca hayan tenido una contraseña nativa de Overleaf, tendrán que crear una. Cada usuario debe:

    * Hacer clic en el enlace "Forgot your password?".
    * 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.

    <Info>
      Si aún no lo has hecho, consulta nuestra guía sobre cómo habilitar el [envío de correo electrónico](/es/on-premises/configuration/overleaf-toolkit/email-delivery).
    </Info>

    Una vez hecho esto, 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.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.