> ## 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.

# Di chuyển tên người dùng

## Di chuyển tên người dùng

Xét về mặt đăng nhập, định danh chính của người dùng là địa chỉ email của họ. Nếu bạn đang chuyển từ xác thực cục bộ sang SSO hoặc chuyển từ một IdP sang một IdP khác, bạn có thể cần cập nhật địa chỉ email của người dùng.

Để hỗ trợ việc này, chúng tôi cung cấp một script giúp di chuyển email người dùng bằng một tệp CSV có định dạng sau:

`oldEmail,newEmail`

Sau khi thực hiện một số bước kiểm tra hợp lệ, script sẽ duyệt qua tệp CSV và cập nhật địa chỉ email của người dùng từ `oldEmail` thành `newEmail`.

### **Kiểm tra hợp lệ**

Trước khi chạy quá trình di chuyển, `<csv_file>` sẽ được kiểm tra để đảm bảo rằng:

* Với mỗi dòng, cả `oldEmail` và `newEmail` đều là địa chỉ email hợp lệ
* Không có mục trùng lặp, ví dụ: bạn không cố cập nhật nhiều người dùng khác nhau sang cùng một địa chỉ email mới, hoặc cố cập nhật cùng một tài khoản người dùng bằng một địa chỉ email đã được sử dụng

### **Cách sử dụng**

```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>"
```

### **Cờ**

| Tên | Mô tả |
| - | - |
| `--commit` | <p>Khi có cờ `--commit`, quá trình di chuyển sẽ thực sự được thực hiện. Khi bỏ qua, quá trình di chuyển sẽ chạy ở chế độ chạy thử (dry-run), không có thay đổi nào được thực hiện nhưng việc kiểm tra hợp lệ vẫn được tiến hành.<br /><br /><strong>Mặc định</strong>:`false`</p> |
| `--continue` | Cờ `--continue` sẽ tiếp tục quá trình di chuyển nếu địa chỉ email trên một tài khoản người dùng đã được cập nhật trước đó |
| `--ignore-missing` | Cờ `--ignore-missing` sẽ tiếp tục quá trình di chuyển nếu không tìm thấy một tài khoản người dùng |
| `--admin-id` | `--admin-id` nên được đặt thành ID của Quản trị viên đang thực hiện việc di chuyển và sẽ được dùng cho các mục nhật ký kiểm tra (audit log). Vào **Admin** > **Manage Users**, tìm kiếm địa chỉ email của bạn và nhấp vào kết quả đầu tiên để tìm user-id của bạn. |
| `<csv_file>` | `<csv_file>` là tệp chứa các địa chỉ email cũ và mới |

### **Hoàn tất**

Trong khi thực thi script di chuyển, các cờ bạn đã chọn sẽ quyết định việc một lỗi được ghi ra console rồi tiếp tục, hay được ghi ra console rồi thoát. Nếu script kết thúc sớm do lỗi, nó sẽ thoát với mã 1 để biểu thị rằng quá trình không thành công.

Khi quá trình di chuyển hoàn tất, script sẽ ghi ra console số lượng cập nhật thành công, thất bại và bị bỏ qua. Nếu quá trình di chuyển hoàn tất thành công, script sẽ thoát với mã 0.


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