Migreren naar LDAP of SAML

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

Nu wil je integreren met het LDAP/Active Directory-systeem van je bedrijf. In dat systeem zijn de gegevens van Alice:

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

Je doel is dat Alice inlogt met haar LDAP-gebruikersnaam (alicejones) en wachtwoord in plaats van met haar oude Overleaf-inloggegevens, zonder dat ze iets van haar werk kwijtraakt. Zo pak je dat aan.

Voor dit proces moet de container sharelatex opnieuw worden aangemaakt, wat enige downtime veroorzaakt. We raden ten zeerste aan om je eerst met dit proces vertrouwd te maken door het in een test-/stagingomgeving te doorlopen.

1. Vraag je gebruikers hun e-mailadressen bij te werken

   Overleaf-accounts zijn gekoppeld aan e-mailadressen, dus de eerste stap is ervoor zorgen dat de Overleaf-e-mailadressen van je gebruikers overeenkomen met hun LDAP- of SAML-e-mailadressen.

   In ons voorbeeld vraag je Alice om in te loggen op haar Overleaf-account en haar e-mailadres te wijzigen van [e-mail] naar [e-mail].

   Vergeet jezelf niet! Als je beheerder bent, moet je ook je eigen e-mailadres bijwerken.

   Als je veel gebruikers hebt, kun je het script voor gebruikersnaammigratie gebruiken om het primaire e-mailadres van gebruikers in bulk te wijzigen.

2. De LDAP- of SAML-module inschakelen

   Zodra ieders e-mailadres is bijgewerkt, is het tijd om de knop om te zetten! Stel de juiste omgevingsvariabelen in voor je nieuwe authenticatiemethode en maak vervolgens de container sharelatex opnieuw aan met de opdracht bin/up -d.

   Hiermee wordt het standaard inlogformulier van Overleaf vervangen door je nieuwe LDAP- of SAML-formulier.

   Je vindt de relevante informatie voor het inschakelen van LDAP hier en voor SAML 2.0 hier.

3. Gebruikers kunnen nu inloggen via LDAP of SAML

   De volgende keer dat Alice inlogt, ziet ze het nieuwe formulier.

   

   Ze kan haar LDAP-gebruikersnaam (alicejones) en wachtwoord invoeren, en omdat haar e-mailadres nu overeenkomt met dat in LDAP, wordt ze direct ingelogd op haar bestaande Overleaf-account. Al haar projecten staan precies waar ze ze heeft achtergelaten.

   Als je SAML 2.0 hebt ingeschakeld, zien gebruikers een knop die hen na het klikken doorstuurt naar je IdP om hun inloggegevens in te voeren. Na succesvolle authenticatie worden ze teruggestuurd naar je Overleaf-instantie en ingelogd op hun account.

   

   Zie de pagina Omgevingsvariabelen voor informatie over het aanpassen van de inlogpagina.

   En als je ooit wilt terugdraaien, zet dan gewoon de LDAP/SAML-configuratie in commentaar en maak de container sharelatex opnieuw aan met de opdracht bin/up -d. Gebruikers kunnen dan inloggen met hun huidige e-mailadres en hun Overleaf-specifieke wachtwoord.

​

De andere kant op: van LDAP/SAML terug naar native authenticatie

Wat als je al een tijdje LDAP of SAML gebruikt en wilt overstappen op het ingebouwde inlogsysteem van Overleaf (misschien heb je je LDAP uitgefaseerd)? Geen probleem! Zo maak je die overstap.

1. Controleer of ieders e-mailadres klopt

   De accounts van je gebruikers zijn al gekoppeld aan hun LDAP- of SAML-e-mailadressen. Dit is het e-mailadres waarmee ze voortaan inloggen, dus controleer gewoon of alles klopt.

2. De LDAP- of SAML-module uitschakelen

   Verwijder simpelweg de LDAP/SAML-configuratie-instellingen of maak ze leeg en maak de container sharelatex opnieuw aan met de opdracht bin/up -d. Hiermee komt het native inlogformulier van Overleaf met e-mailadres en wachtwoord terug.

   
3. Vraag gebruikers hun wachtwoord opnieuw in te stellen

   Wanneer je gebruikers nu de inlogpagina bezoeken, zien ze het Overleaf-inlogformulier in plaats van het LDAP/SAML-formulier.

   Omdat ze mogelijk nooit een native Overleaf-wachtwoord hebben gehad, moeten ze er een aanmaken. Elke gebruiker moet:

   • Op de link “Forgot your password?” klikken.
   • Het e-mailadres invoeren dat aan zijn of haar account is gekoppeld (het adres uit LDAP/SAML).
   • De link in de e-mail voor wachtwoordherstel volgen om een nieuw wachtwoord in te stellen.

   Als je dat nog niet hebt gedaan, bekijk dan onze handleiding over het inschakelen van E-mailbezorging.

   Daarna kunnen ze inloggen met hun e-mailadres en hun nieuwe Overleaf-specifieke wachtwoord om toegang te krijgen tot al hun projecten.