Migrering av brukernavn

​

Migrering av brukernavn

Når det gjelder innlogging, er brukerens primære identifikator e-postadressen. Hvis du migrerer fra lokal autentisering til SSO, eller fra én IdP til en annen, kan det hende du må oppdatere brukernes e-postadresser.

For å hjelpe med dette finnes det et skript som migrerer brukernes e-postadresser ved hjelp av en CSV-fil med følgende format:

oldEmail,newEmail

Etter å ha utført noen valideringskontroller går skriptet gjennom CSV-filen og oppdaterer brukernes e-postadresser fra oldEmail til newEmail.

​

Validering

Før migreringen kjøres, kontrolleres <csv_file> for å sikre at:

• For hver rad er både oldEmail og newEmail gyldige e-postadresser
• Det finnes ingen dupliserte oppføringer, for eksempel at du forsøker å oppdatere ulike brukere til samme nye e-postadresse, eller at du forsøker å oppdatere samme brukerkonto med en e-postadresse som allerede er i bruk

​

Bruk

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

​

Flagg

Navn	Beskrivelse
--commit	Når flagget --commit tas med, utføres migreringen faktisk. Når det utelates, kjøres migreringen i en tørrkjøringsmodus der ingen endringer gjøres, men valideringen likevel utføres. Standard:false
--continue	Flagget --continue fortsetter migreringsprosessen dersom e-postadressen på en brukerkonto allerede er oppdatert
--ignore-missing	Flagget --ignore-missing fortsetter migreringsprosessen dersom en brukerkonto ikke ble funnet
--admin-id	--admin-id skal settes til ID-en til administratoren som utfører migreringen, og brukes i oppføringer i revisjonsloggen. Gå til Admin > Manage Users, søk etter e-postadressen din og klikk på det første resultatet for å finne bruker-ID-en din.
<csv_file>	<csv_file> er filen som inneholder de gamle og nye e-postadressene

​

Fullføring

Mens migreringsskriptet kjører, avgjør flaggene du har valgt om en feil logges til konsollen og kjøringen fortsetter, eller om den logges til konsollen og skriptet avsluttes. Hvis skriptet avsluttes for tidlig på grunn av en feil, avsluttes det med kode 1 for å angi at det mislyktes.

Når migreringen er fullført, logger skriptet antall vellykkede, mislykkede og hoppet over oppdateringer til konsollen. Hvis migreringen fullføres uten feil, avsluttes skriptet med kode 0.