ユーザーが多い場合は、

ユーザー名の移行

ログインの観点から、ユーザーの主要な識別子はメールアドレスです。ローカル認証からSSOに移行する場合や一つのIdPから別のIdPへ移行する場合、ユーザーのメールアドレスを更新する必要があることがあります。

これを支援するために、次の形式のCSVファイルを使用してユーザーのメールを移行するスクリプトが提供されています：

oldEmail,newEmail

いくつかの検証チェックを行った後、スクリプトはCSVファイルを順に処理し、ユーザーのメールアドレスをから更新します。 oldEmail から newEmail.

検証

移行を実行する前に <csv_file> は以下を確認するためにチェックされます：

• 各行について、両方の oldEmail と newEmail が有効なメールアドレスであること

• 重複したエントリがないこと。例えば、異なるユーザーを同じ新しいメールアドレスに更新しようとしていないこと、または同じユーザーアカウントを既に使用されているメールアドレスに更新しようとしていないこと

使い方

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

フラグ

名前	説明
--commit	この --commit フラグを付けると実際に移行が行われます。省略した場合、移行はドライランモードで実行され、変更は行われませんが検証は実施されます。 デフォルト:false
--continue	この --continue フラグは、アカウント上のメールアドレスが既に更新されている場合に移行処理を続行します。
--ignore-missing	この --ignore-missing このフラグは、ユーザーアカウントが見つからなかった場合に移行処理を続行します。
--admin-id	この --admin-id は移行を実行する管理者のIDに設定する必要があり、監査ログのエントリに使用されます。に移動して、 管理者 > ユーザー管理 に移動して自分のメールアドレスを検索し、最初の結果をクリックしてユーザーIDを確認してください。
<csv_file>	この <csv_file> は古いメールアドレスと新しいメールアドレスが入ったファイルです。

完了

移行スクリプトを実行する際、選択したフラグに応じて、エラーがコンソールに記録されて処理を続行するか、コンソールに記録して終了するかが決まります。スクリプトがエラーにより早期終了した場合は、失敗を示すために終了コード1で終了します。

移行が完了すると、スクリプトはコンソールに成功、失敗、スキップされた更新の件数を記録します。移行が正常に完了した場合は終了コード0で終了します。