> 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/da/bruger-og-projektadministration/user-management/username-migration.md).

# Migrering af brugernavne

## Migrering af brugernavne

Set fra et login-perspektiv er brugerens primære identifikator deres e-mailadresse. Hvis du migrerer fra lokal autentificering til SSO, eller du migrerer fra en IdP til en anden, kan det være nødvendigt at opdatere brugernes e-mailadresser.

For at hjælpe med dette leveres et script, der migrerer brugernes e-mails ved hjælp af en CSV-fil med følgende format:

`oldEmail,newEmail`

Efter at have udført nogle valideringstjek vil scriptet gennemgå CSV-filen og opdatere brugernes e-mailadresser fra `oldEmail` til `newEmail`.

### **Validering**

Før migreringen køres, vil `<csv_file>` blive kontrolleret for at sikre, at:

* For hver række er både `oldEmail` og `newEmail` gyldige e-mailadresser
* Der er ingen duplikerede poster, for eksempel forsøger du ikke at opdatere forskellige brugere til den samme nye e-mailadresse, eller du forsøger ikke at opdatere den samme brugerkonto med en e-mailadresse, der allerede er i brug

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

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

| Navn               | Beskrivelse                                                                                                                                                                                                                                                                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--commit`         | <p>Inkluderingen af <code>--commit</code> flaget udfører selve migreringen. Hvis den udelades, vil migreringen foregå i en prøvekørsel, hvor der ikke foretages ændringer, men validering stadig udføres.<br><br><strong>Standard</strong>:<code>false</code></p>              |
| `--continue`       | Det `--continue` flaget vil fortsætte migreringsprocessen, hvis en brugerkonto, hvis e-mailadresse på kontoen allerede er blevet opdateret                                                                                                                                     |
| `--ignore-missing` | Det `--ignore-missing` flaget vil fortsætte migreringsprocessen, hvis en brugerkonto ikke blev fundet                                                                                                                                                                          |
| `--admin-id`       | Det `--admin-id` skal angives som ID'et for den administrator, der udfører migreringen, og vil blive brugt til poster i revisionsloggen. Gå til **Admin** > **Administrer brugere** og søg efter din e-mailadresse, og klik på det første resultat for at finde dit bruger-id. |
| `<csv_file>`       | Det `<csv_file>` er filen med de gamle og nye e-mailadresser i                                                                                                                                                                                                                 |

### **Fuldførelse** <a href="#completion" id="completion"></a>

Mens migreringsscriptet kører, vil det afhænge af de flag, du har valgt, om en fejl logges til konsollen og derefter fortsætter, eller logges til konsollen og afsluttes. Hvis scriptet afsluttes for tidligt på grund af en fejl, afsluttes det med koden 1 for at angive, at det ikke lykkedes.

Når migreringen er fuldført, logger scriptet antallet af vellykkede, mislykkede og overhoppede opdateringer til konsollen. Hvis migreringen fuldføres succesfuldt, afsluttes den med kode 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/da/bruger-og-projektadministration/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.