Migrace uživatelských jmen

​

Migrace uživatelských jmen

Z hlediska přihlašování je primárním identifikátorem uživatele jeho e-mailová adresa. Pokud přecházíte z místního ověřování na SSO nebo z jednoho IdP na jiný, může být nutné aktualizovat e-mailové adresy uživatelů.

S tím pomáhá dodávaný skript, který migruje e-maily uživatelů pomocí souboru CSV v následujícím formátu:

oldEmail,newEmail

Po provedení několika ověřovacích kontrol skript projde soubor CSV a aktualizuje e-mailové adresy uživatelů z oldEmail na newEmail.

​

Ověření

Před spuštěním migrace bude soubor <csv_file> zkontrolován, aby se zajistilo, že:

• V každém řádku jsou oldEmail i newEmail platné e-mailové adresy
• Neexistují duplicitní záznamy, například se nepokoušíte aktualizovat různé uživatele na stejnou novou e-mailovou adresu ani aktualizovat stejný uživatelský účet na již použitou e-mailovou adresu

​

Použití

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

​

Příznaky

Název	Popis
--commit	Zahrnutí příznaku --commit migraci skutečně provede. Pokud je vynechán, migrace proběhne v režimu zkušebního běhu (dry-run), ve kterém se neprovádějí žádné změny, ale ověření se přesto provede. Výchozí:false
--continue	Příznak --continue pokračuje v procesu migrace, pokud již byla e-mailová adresa u uživatelského účtu aktualizována
--ignore-missing	Příznak --ignore-missing pokračuje v procesu migrace, pokud uživatelský účet nebyl nalezen
--admin-id	--admin-id by měl být nastaven na ID administrátora, který migraci provádí, a použije se pro záznamy v auditním záznamu. Své user-id zjistíte tak, že přejdete do Admin > Manage Users, vyhledáte svou e-mailovou adresu a kliknete na první výsledek.
<csv_file>	<csv_file> je soubor se starými a novými e-mailovými adresami

​

Dokončení

Během provádění migračního skriptu závisí na zvolených příznacích, zda se chyba zapíše do konzole a skript pokračuje, nebo se zapíše do konzole a skript skončí. Pokud skript kvůli chybě skončí předčasně, ukončí se s kódem 1, který značí neúspěch.

Po dokončení migrace skript vypíše do konzole počet úspěšných, neúspěšných a přeskočených aktualizací. Pokud migrace proběhne úspěšně, skript se ukončí s kódem 0.