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

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	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. Mặc định:false
--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.