> 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/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 om du migrerar från en IdP till en annan, kan du behöva uppdatera användarnas e-postadresser.

För att hjälpa till med 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 några 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 finns inga dubbletter, till exempel försöker du inte uppdatera olika användare till samma nya e-postadress eller så försöker du inte 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 ske i ett torrkörningsläge där inga ändringar görs men validering fortfarande utförs.<br><br><strong>Standard</strong>:<code>false</code></p>       |
| `--continue`       | Fältet `--continue` flaggan kommer att fortsätta migreringsprocessen om ett användarkonto om e-postadressen på kontot redan har uppdaterats                                                                                                                                            |
| `--ignore-missing` | Fältet `--ignore-missing` flaggan kommer att fortsätta migreringsprocessen om ett användarkonto inte hittades                                                                                                                                                                          |
| `--admin-id`       | Fältet `--admin-id` bör anges 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>`       | Fältet `<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, beroende på vilka flaggor du har valt, om ett fel loggas till konsolen och sedan fortsätter, eller loggas till konsolen och avslutas. Om skriptet avslutas i förtid på grund av ett fel kommer det att avslutas med kod 1 för att ange att det misslyckades.

När migreringen har slutförts kommer skriptet att logga 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://ayakaleaf-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.