Migrar a LDAP o SAML

{
  _id:        '123',
  email:      '[e-mail]'
  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:

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - 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.

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.

1. 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 [e-mail] a [e-mail].

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

   Si tienes muchos usuarios, puedes usar el script de migración de nombres de usuario para cambiar de forma masiva la dirección de correo electrónico principal de los usuarios.

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

   Puedes encontrar la información necesaria para habilitar LDAP aquí y SAML 2.0 aquí.

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

   

   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.

   

   Consulta la página Variables de entorno 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.

​

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.

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

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

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

   Si aún no lo has hecho, consulta nuestra guía sobre cómo habilitar el envío de correo electrónico.

   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.