> 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/sv/anvandar-och-projektadministration/user-management/username-migration.md).

# Migrering av användarnamn

## Migrering av användarnamn

Ur ett inloggningsperspektiv är den primära identifieraren för en användare deras e-postadress. Om du migrerar från lokalt baserad autentisering till SSO eller migrerar från en IdP till en annan kan du behöva uppdatera användarnas e-postadresser.

För att underlätta detta tillhandahålls ett skript som migrerar användares e-postadresser med hjälp av en CSV-fil med följande format:

`oldEmail,newEmail`

Efter att ha utfört vissa valideringskontroller kommer skriptet att gå igenom CSV-filen och uppdatera användarnas e-postadresser från `oldEmail` till `newEmail`.

### **Validering**

Innan migreringen körs kommer `<csv_file>` att kontrolleras för att säkerställa att:

* För varje rad är både `oldEmail` och `newEmail` är giltiga e-postadresser
* det inte finns några dubblettposter, till exempel att du inte försöker uppdatera olika användare till samma nya e-postadress eller att du försöker uppdatera samma användarkonto med en e-postadress som redan används

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

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

| Namn               | Beskrivning                                                                                                                                                                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--commit`         | <p>Inkluderingen av <code>--commit</code> flaggan kommer faktiskt att utföra migreringen. Om den utelämnas kommer migreringen att köras i ett testläge där inga ändringar görs men validering fortfarande utförs.<br><br><strong>Standard</strong>:<code>false</code></p>            |
| `--continue`       | Den `--continue` flaggan kommer att fortsätta migreringsprocessen om ett användarkonto om e-postadressen på kontot redan har uppdaterats                                                                                                                                             |
| `--ignore-missing` | Den `--ignore-missing` flaggan kommer att fortsätta migreringsprocessen om ett användarkonto inte hittades                                                                                                                                                                           |
| `--admin-id`       | Den `--admin-id` ska sättas till ID:t för administratören som utför migreringen och kommer att användas för poster i granskningsloggen. Gå till **Admin** > **Hantera användare** och sök efter din e-postadress och klicka på det första resultatet för att hitta ditt användar-ID. |
| `<csv_file>`       | Den `<csv_file>` är filen med de gamla och nya e-postadresserna i                                                                                                                                                                                                                    |

### **Slutförande** <a href="#completion" id="completion"></a>

När migreringsskriptet körs avgör de flaggor du har valt om ett fel loggas till konsolen och sedan fortsätter, eller loggas till konsolen och avslutar. Om skriptet avslutas i förtid på grund av ett fel, avslutas det med kod 1 för att ange att det misslyckades.

När migreringen har slutförts loggar skriptet antalet lyckade, misslyckade och överhoppade uppdateringar till konsolen. Om migreringen slutförs framgångsrikt avslutas det med kod 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/sv/anvandar-och-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.