> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migración de nombres de usuario

## Migración de nombres de usuario

Desde el punto de vista del inicio de sesión, el identificador principal de un usuario es su dirección de correo electrónico. Si estás migrando de una autenticación local a SSO, o de un IdP a otro, es posible que tengas que actualizar las direcciones de correo electrónico de los usuarios.

Para ayudarte con esto, se proporciona un script que migra los correos electrónicos de los usuarios a partir de un archivo CSV con el siguiente formato:

`oldEmail,newEmail`

Tras realizar algunas comprobaciones de validación, el script recorrerá el archivo CSV y actualizará las direcciones de correo electrónico de los usuarios de `oldEmail` a `newEmail`.

### **Validación**

Antes de ejecutar la migración, se comprobará el `<csv_file>` para garantizar que:

* En cada fila, tanto `oldEmail` como `newEmail` son direcciones de correo electrónico válidas
* No hay entradas duplicadas; por ejemplo, que no intentas asignar la misma dirección de correo nueva a usuarios distintos ni actualizar la misma cuenta de usuario con una dirección de correo ya utilizada

### **Uso**

```bash wrap theme={null}
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>"
```

### **Opciones**

| Nombre | Descripción |
| - | - |
| `--commit` | <p>Incluir la opción `--commit` hace que la migración se realice de verdad. Si se omite, la migración se ejecuta en modo de simulación (dry-run), en el que no se realiza ningún cambio, pero sí se hace la validación.<br /><br /><strong>Predeterminado</strong>:`false`</p> |
| `--continue` | La opción `--continue` hace que el proceso de migración continúe si la dirección de correo electrónico de una cuenta de usuario ya se ha actualizado |
| `--ignore-missing` | La opción `--ignore-missing` hace que el proceso de migración continúe si no se encuentra una cuenta de usuario |
| `--admin-id` | `--admin-id` debe establecerse en el ID del administrador que realiza la migración y se usará en las entradas del registro de auditoría. Ve a **Admin** > **Manage Users**, busca tu dirección de correo electrónico y haz clic en el primer resultado para encontrar tu ID de usuario. |
| `<csv_file>` | `<csv_file>` es el archivo que contiene las direcciones de correo electrónico antiguas y nuevas |

### **Finalización**

Durante la ejecución del script de migración, las opciones que hayas elegido determinarán si un error se registra en la consola y el proceso continúa, o si se registra en la consola y el script termina. Si el script termina antes de tiempo debido a un error, saldrá con el código 1 para indicar que no se ha completado correctamente.

Al finalizar la migración, el script mostrará en la consola el número de actualizaciones correctas, fallidas y omitidas. Si la migración se completa correctamente, saldrá con el código 0.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.