> 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/username-migration.md).

# Gebruikersnaammigratie

## Migratie van gebruikersnamen

Vanuit inlogperspectief is de primaire identificatie voor een gebruiker hun e-mailadres. Als u migreert van lokaal gebaseerde authenticatie naar SSO, of als u van de ene IdP naar een andere migreert, moet u mogelijk de e-mailadressen van gebruikers bijwerken.

Om hierbij te helpen, wordt een script geleverd waarmee gebruikers-e-mails kunnen worden gemigreerd met behulp van een CSV-bestand met de volgende indeling:

`oudeE-mail,nieuweE-mail`

Na enkele validatiecontroles uit te voeren, zal het script door het CSV-bestand lopen en de e-mailadressen van de gebruikers bijwerken van `oudeE-mail` naar `nieuweE-mail`.

### **Validatie**

Vóór het uitvoeren van de migratie zal de `<csv_file>` worden gecontroleerd om ervoor te zorgen dat:

* Voor elke rij zijn zowel de `oudeE-mail` als de `nieuweE-mail` geldige e-mailadressen zijn
* Er zijn geen dubbele vermeldingen; u probeert bijvoorbeeld niet verschillende gebruikers bij te werken naar hetzelfde nieuwe e-mailadres, of u probeert niet hetzelfde gebruikersaccount bij te werken met een e-mailadres dat al in gebruik is

### **Gebruik** <a href="#usage" id="usage"></a>

{% code overflow="wrap" %}

```bash
docker cp <csv_file> sharelatex:/overleaf/services/web/<csv_file> docker exec sharelatex /bin/bash -c "cd /overleaf/services/web;node ./modules/server-ce-scripts/scripts/migrate-user-emails.js [--commit] [--continue|--ignore-missing] [--admin-id=ADMIN_USER_ID] <csv_file>"
```

{% endcode %}

### **Vlaggen** <a href="#flags" id="flags"></a>

| Naam               | Beschrijving                                                                                                                                                                                                                                                                                                          |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--commit`         | <p>De opname van de <code>--commit</code> vlag zal de migratie daadwerkelijk uitvoeren. Wanneer deze wordt weggelaten, gebeurt de migratie in een proefuitvoeringsmodus, waarin geen wijzigingen worden aangebracht maar validatie nog wel wordt uitgevoerd.<br><br><strong>Standaard</strong>:<code>false</code></p> |
| `--continue`       | De `--continue` vlag zal het migratieproces voortzetten als het e-mailadres op het account al is bijgewerkt                                                                                                                                                                                                           |
| `--ignore-missing` | De `--ignore-missing` vlag zal het migratieproces voortzetten als een gebruikersaccount niet is gevonden                                                                                                                                                                                                              |
| `--admin-id`       | De `--admin-id` moet worden ingesteld op de ID van de beheerder die de migratie uitvoert en wordt gebruikt voor logboekvermeldingen in de audit. Ga naar **Beheerder** > **Gebruikers beheren** en zoek naar uw e-mailadres en klik op het eerste resultaat om uw gebruikers-id te vinden.                            |
| `<csv_file>`       | De `<csv_file>` is het bestand met de oude en nieuwe e-mailadressen in                                                                                                                                                                                                                                                |

### **Voltooiing** <a href="#completion" id="completion"></a>

Tijdens het uitvoeren van het migratiescript bepaalt, afhankelijk van de gekozen vlaggen, of er een fout naar de console wordt gelogd en daarna wordt doorgegaan, of dat de fout naar de console wordt gelogd en het script afloopt. Als het script voortijdig stopt door een fout, wordt het afgesloten met code 1 om aan te geven dat het mislukt is.

Na voltooiing van de migratie logt het script het aantal geslaagde, mislukte en overgeslagen updates naar de console. Als de migratie succesvol is voltooid, wordt het afgesloten met code 0.


---

# 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/username-migration.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.