> 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/nl/gebruikers-en-projectbeheer/user-management/migrating-to-ldap-or-saml.md).

# Migreren naar LDAP of SAML

```
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

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

```
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

Uw doel is dat Alice inlogt met hun LDAP-gebruikersnaam (`alicejones`) en wachtwoord in plaats van hun oude Overleaf-inloggegevens, zonder iets van hun werk te verliezen. Zo doet u dat.

{% hint style="warning" %}
Voor dit proces moet u de **sharelatex** container opnieuw maken, wat tot enige downtime zal leiden. We raden sterk aan om dit proces eerst door te nemen in een test-/stagingomgeving.
{% endhint %}

{% stepper %}
{% step %}

### Vraag uw gebruikers hun e-mailadressen bij te werken

Overleaf-accounts zijn gekoppeld aan e-mailadressen, dus de eerste stap is ervoor te zorgen dat de Overleaf-e-mails van uw gebruikers synchroon lopen met hun LDAP- of SAML-e-mails.

In ons voorbeeld zou u Alice vragen in te loggen op hun Overleaf-account en hun e-mailadres te wijzigen van `alice@example.com` naar `alicejones@tech.example.com`.

{% hint style="warning" %}
Vergeet uzelf niet! Als u een beheerder bent, moet u ook uw eigen e-mailadres bijwerken.
{% endhint %}

{% hint style="success" %}
Als u veel gebruikers heeft, kunt u het [Gebruikersnaammigratie](/on-premises/nl/gebruikers-en-projectbeheer/user-management/username-migration.md) script gebruiken om het primaire e-mailadres van een gebruiker in bulk te wijzigen.
{% endhint %}
{% endstep %}

{% step %}

### Schakel de LDAP- of SAML-module in

Zodra ieders e-mailadres is bijgewerkt, is het tijd om de schakelaar om te zetten! U moet de juiste omgevingsvariabelen instellen voor uw nieuwe authenticatiemethode en daarna de **sharelatex** container opnieuw maken met behulp van de `bin/up -d` commando uit te voeren.

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

{% hint style="info" %}
U vindt de relevante informatie voor het inschakelen van LDAP [hier](/on-premises/nl/configuratie/overleaf-toolkit/authentication/ldap-authentication.md), en SAML 2.0 [hier](/on-premises/nl/configuratie/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

### Gebruikers kunnen nu inloggen via LDAP of SAML

De volgende keer dat Alice gaat inloggen, zien ze het nieuwe formulier.

![LDAP/Active Directory-inlogpagina](/files/0111367ac772900b8f1a17098b926f624d175cb5)

Ze kunnen hun LDAP-gebruikersnaam invoeren (`alicejones`) en wachtwoord, en omdat hun e-mailadres nu overeenkomt met dat in LDAP, worden ze direct ingelogd op hun bestaande Overleaf-account. Al hun projecten staan precies waar ze ze hebben achtergelaten.

Als u SAML 2.0 heeft ingeschakeld, zien gebruikers een knop die hen, wanneer erop wordt geklikt, doorstuurt naar uw IdP om hun inloggegevens in te voeren. Bij succesvolle authenticatie worden ze teruggestuurd naar uw Overleaf-instantie en ingelogd op hun account.

![SAML-inlogpagina](/files/14964fb77ec34d2efca5fae3b1cef32f59338745)

{% hint style="info" %}
Zie de [Omgevingsvariabelen](broken://pages/a145fe34bdd0f59059ab93431fc01a7c5ed96e53) pagina voor informatie over het aanpassen van de inlogpagina-ervaring.

En als u ooit moet terugrollen, commentarieert u gewoon de LDAP/SAML-configuratie uit en maakt u de **sharelatex** container opnieuw maken met behulp van de `bin/up -d` opdracht opnieuw aan. Gebruikers kunnen dan inloggen met hun huidige e-mailadres en het Overleaf-specifieke wachtwoord.
{% endhint %}
{% endstep %}
{% endstepper %}

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

Wat als u al een tijdje LDAP of SAML gebruikt en wilt overstappen naar het ingebouwde inlogsysteem van Overleaf (misschien heeft u uw LDAP buiten gebruik gesteld)? Geen probleem! Zo maakt u die overstap.

{% stepper %}
{% step %}

### Controleer of ieders e-mailadres correct is

De accounts van uw gebruikers zijn al gekoppeld aan hun LDAP- of SAML-e-mailadressen. Dit is het e-mailadres waarmee ze vanaf nu inloggen, dus controleer gewoon of alles klopt.
{% endstep %}

{% step %}

### Schakel de LDAP- of SAML-module uit

Verwijder of haal de LDAP/SAML-configuratie-instellingen weg en maak de **sharelatex** container opnieuw maken met behulp van de `bin/up -d` opdracht opnieuw aan. Hiermee wordt het native Overleaf-inlogformulier met e-mail en wachtwoord teruggebracht.

![Inlogpagina voor native authenticatie](/files/8d68b6c9079988addf744f4e9491b3cad54d42b7)
{% endstep %}

{% step %}

### Vraag gebruikers hun wachtwoorden opnieuw in te stellen

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

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

* Klik op de link 'Wachtwoord vergeten?'.
* Voer het e-mailadres in dat aan hun account is gekoppeld (het adres uit LDAP/SAML).
* Volg de link in de e-mail voor het opnieuw instellen van het wachtwoord om een nieuw wachtwoord in te stellen.

{% hint style="info" %}
Als u dat nog niet hebt gedaan, bekijk dan onze handleiding over het inschakelen van [E-mailbezorging](/on-premises/nl/configuratie/overleaf-toolkit/email-delivery.md).
{% endhint %}

Zodra dat is gedaan, kunnen ze inloggen met hun e-mailadres en hun nieuwe Overleaf-specifieke wachtwoord om toegang te krijgen tot al hun projecten.
{% 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/nl/gebruikers-en-projectbeheer/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.