Migrer vers LDAP ou SAML

{
  _id:        '123',
  email:      '[e-mail]'
  first_name: 'Alice',
  last_name:  'Jones'
}

Vous souhaitez maintenant intégrer le système LDAP/Active Directory de votre entreprise. Dans ce système, les informations d’Alice sont les suivantes :

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - givenName:   'Alice'
  - sn: 'Jones'

Votre objectif est qu’Alice se connecte avec son nom d’utilisateur LDAP (alicejones) et son mot de passe au lieu de ses anciens identifiants Overleaf, sans perdre aucun de ses travaux. Voici comment procéder.

Ce processus nécessite de recréer le conteneur sharelatex, ce qui entraînera une interruption de service. Nous vous recommandons vivement de vous familiariser d’abord avec ce processus en le réalisant dans un environnement de test ou de préproduction.

1. Demander à vos utilisateurs de mettre à jour leur adresse e-mail

   Les comptes Overleaf sont liés à des adresses e-mail : la première étape consiste donc à aligner les adresses e-mail Overleaf de vos utilisateurs sur leurs adresses e-mail LDAP ou SAML.

   Dans notre exemple, vous demanderiez à Alice de se connecter à son compte Overleaf et de remplacer son adresse [e-mail] par [e-mail].

   Ne vous oubliez pas ! Si vous êtes administrateur, vous devrez également mettre à jour votre propre adresse e-mail.

   Si vous avez beaucoup d’utilisateurs, vous pouvez utiliser le script de migration des noms d’utilisateur pour modifier en masse l’adresse e-mail principale des utilisateurs.

2. Activer le module LDAP ou SAML

   Une fois les adresses e-mail de tous les utilisateurs mises à jour, il est temps d’activer le nouveau système ! Vous devez définir les variables d’environnement adaptées à votre nouvelle méthode d’authentification, puis recréer le conteneur sharelatex à l’aide de la commande bin/up -d.

   Le formulaire de connexion standard d’Overleaf est alors remplacé par votre nouveau formulaire LDAP ou SAML.

   Vous trouverez les informations nécessaires pour activer LDAP ici, et SAML 2.0 ici.

3. Les utilisateurs peuvent désormais se connecter via LDAP ou SAML

   La prochaine fois qu’Alice se connectera, elle verra le nouveau formulaire.

   

   Elle peut saisir son nom d’utilisateur LDAP (alicejones) et son mot de passe et, comme son adresse e-mail correspond désormais à celle de LDAP, elle sera directement connectée à son compte Overleaf existant. Tous ses projets seront exactement là où elle les avait laissés.

   Si vous avez activé SAML 2.0, les utilisateurs verront un bouton qui, lorsqu’on clique dessus, les redirige vers votre IdP pour saisir leurs identifiants. Une fois authentifiés, ils sont redirigés vers votre instance Overleaf et connectés à leur compte.

   

   Consultez la page Variables d’environnement pour savoir comment personnaliser la page de connexion.

   Et si vous devez revenir en arrière, il suffit de commenter la configuration LDAP/SAML et de recréer le conteneur sharelatex à l’aide de la commande bin/up -d. Les utilisateurs pourront alors se connecter avec leur adresse e-mail actuelle et leur mot de passe propre à Overleaf.

​

Dans l’autre sens : revenir de LDAP/SAML à l’authentification native

Et si vous utilisez LDAP ou SAML depuis un certain temps et souhaitez passer au système de connexion intégré d’Overleaf (par exemple parce que vous avez abandonné votre LDAP) ? Aucun problème ! Voici comment procéder.

1. Vérifier que l'adresse e-mail de chacun est correcte

   Les comptes de vos utilisateurs sont déjà liés à leurs adresses e-mail LDAP ou SAML. C’est l’adresse qu’ils utiliseront désormais pour se connecter : assurez-vous simplement que tout est correct.

2. Désactiver le module LDAP ou SAML

   Il suffit de supprimer ou de désactiver les paramètres de configuration LDAP/SAML et de recréer le conteneur sharelatex à l’aide de la commande bin/up -d. Le formulaire de connexion natif d’Overleaf par e-mail et mot de passe sera alors rétabli.

   
3. Demander aux utilisateurs de réinitialiser leur mot de passe

   Lorsque vos utilisateurs accéderont à la page de connexion, ils verront le formulaire de connexion Overleaf au lieu du formulaire LDAP/SAML.

   Comme ils n’ont peut-être jamais eu de mot de passe Overleaf natif, ils devront en créer un. Chaque utilisateur doit :

   • Cliquer sur le lien « Forgot your password? ».
   • Saisir l’adresse e-mail associée à son compte (celle provenant de LDAP/SAML).
   • Suivre le lien figurant dans l’e-mail de réinitialisation pour définir un nouveau mot de passe.

   Si ce n’est pas déjà fait, consultez notre guide sur l’activation de l’envoi des e-mails.

   Une fois cela fait, ils pourront se connecter avec leur adresse e-mail et leur nouveau mot de passe propre à Overleaf pour accéder à tous leurs projets.