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

# Migreren naar LDAP of SAML

```text theme={null}
{
  _id:        '123',
  email:      'alice@example.com'
  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:

```text theme={null}
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - 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.

<Warning>
  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.
</Warning>

<Steps>
  <Step title="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 `alice@example.com` naar `alicejones@tech.example.com`.

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

    <Check>
      Als je veel gebruikers hebt, kun je het script voor [gebruikersnaammigratie](/nl/on-premises/user-and-project-management/user-management/username-migration) gebruiken om het primaire e-mailadres van gebruikers in bulk te wijzigen.
    </Check>
  </Step>

  <Step title="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.

    <Info>
      Je vindt de relevante informatie voor het inschakelen van LDAP [hier](/nl/on-premises/configuration/overleaf-toolkit/authentication/ldap-authentication) en voor SAML 2.0 [hier](/nl/on-premises/configuration/overleaf-toolkit/authentication/saml-authentication).
    </Info>
  </Step>

  <Step title="Gebruikers kunnen nu inloggen via LDAP of SAML">
    De volgende keer dat Alice inlogt, ziet ze het nieuwe formulier.

    <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="Inlogpagina voor LDAP/Active Directory" width="348" height="261" data-path="images/on-premises/image-4.jpg" />

    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.

    <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="Inlogpagina voor SAML" width="353" height="198" data-path="images/on-premises/image-5.jpg" />

    <Info>
      Zie de pagina [Omgevingsvariabelen](/nl/on-premises/configuration/overleaf-toolkit/environment-variables) 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.
    </Info>
  </Step>
</Steps>

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    <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="Inlogpagina voor native authenticatie" width="407" height="279" data-path="images/on-premises/image-6.jpg" />
  </Step>

  <Step title="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.

    <Info>
      Als je dat nog niet hebt gedaan, bekijk dan onze handleiding over het inschakelen van [E-mailbezorging](/nl/on-premises/configuration/overleaf-toolkit/email-delivery).
    </Info>

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


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