> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/nl/gebruikers-en-projectbeheer/user-management/username-migration.md).

# Migratie van gebruikersnaam

## Migratie van gebruikersnamen

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

Om hierbij te helpen, is er een script beschikbaar dat gebruikers-e-mails migreert met behulp van een CSV-bestand in het volgende formaat:

`oldEmail,newEmail`

Na het uitvoeren van enkele validatiecontroles zal het script door het CSV-bestand itereren en de e-mailadressen van de gebruikers bijwerken van `oldEmail` naar `newEmail`.

### **Validatie**

Voordat de migratie wordt uitgevoerd, zal de `<csv_file>` worden gecontroleerd om te verzekeren dat:

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

### **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 %}

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

| Naam               | Beschrijving                                                                                                                                                                                                                                                                                      |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--commit`         | <p>De opname van de <code>--commit</code> vlag zal de migratie daadwerkelijk uitvoeren. Als deze wordt weggelaten, gebeurt de migratie in dry-run-modus waarin geen wijzigingen worden aangebracht, maar validatie 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 zal worden gebruikt voor auditlogboekvermeldingen. 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 door u gekozen vlaggen, of er een fout naar de console wordt gelogd en daarna wordt doorgegaan, of dat er naar de console wordt gelogd en het script wordt afgesloten. Als het script voortijdig stopt vanwege een fout, wordt het afgesloten met code 1 om aan te geven dat het mislukt is.

Na voltooiing van de migratie zal het script het aantal geslaagde, mislukte en overgeslagen updates naar de console loggen. 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://ayakaleaf-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.