> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management/migrating-to-ldap-or-saml.md).

# Migrar 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 datos 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 contraseña en lugar de sus antiguas credenciales de Overleaf, sin perder ninguno de sus trabajos. Así es como lograrlo.

{% 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 llevándolo a cabo 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 de LDAP o SAML.

En nuestro ejemplo, le pedirías a Alice que inicie sesión en su cuenta de Overleaf y cambie su correo electrónico 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 la dirección de correo electrónico principal de un usuario en bloque.
{% endhint %}
{% endstep %}

{% step %}

### Habilita el módulo LDAP o SAML

Una vez que se hayan actualizado las direcciones de correo electrónico de todos, ¡es hora de activar el cambio! Tendrás que definir 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 el nuevo de 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 mediante 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 contraseña, y como su dirección de correo electrónico ahora coincide con la de LDAP, se les iniciará sesión directamente en su cuenta existente de Overleaf. 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 que introduzcan sus credenciales. Tras autenticarse correctamente, volverán a tu instancia de Overleaf e 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 revertir los cambios, simplemente 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 electrónico actual y su contraseña específica de Overleaf.
{% endhint %}
{% endstep %}
{% endstepper %}

## El camino inverso: cambiar de LDAP/SAML de vuelta a la autenticación nativa

¿Y si has estado usando LDAP o SAML durante un tiempo y quieres pasar al sistema de inicio de sesión integrado de Overleaf (quizá hayas retirado tu LDAP)? ¡No hay problema! Así es como puedes hacer ese cambio.

{% stepper %}
{% step %}

### 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. 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 correcto.
{% endstep %}

{% step %}

### Desactiva el módulo LDAP o SAML

Simplemente elimina o desactiva la configuración de LDAP/SAML y vuelve a crear el **sharelatex** contenedor usando el `bin/up -d` comando. Esto traerá de vuelta el formulario nativo de inicio de sesión con correo y contraseña de Overleaf.

![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 la página de inicio de sesión ahora, verán el formulario 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:

* Haz clic en el enlace «¿Olvidaste tu contraseña?».
* Introduce la dirección de correo electrónico asociada con su cuenta (la de LDAP/SAML).
* Sigue el enlace del correo de restablecimiento de contraseña para establecer una nueva contraseña.

{% hint style="info" %}
Si aún 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 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.
{% 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://overleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management/migrating-to-ldap-or-saml.md?ask=<question>&goal=<endgoal>
```

`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.