Migrering af brugernavne

​

Migrering af brugernavne

Set fra et login-perspektiv er en brugers primære identifikator vedkommendes e-mailadresse. Hvis du migrerer fra lokal godkendelse til SSO, eller hvis du migrerer fra én IdP til en anden, kan det være nødvendigt at opdatere brugernes e-mailadresser.

Som hjælp til dette findes der et script, der migrerer brugeres e-mailadresser ved hjælp af en CSV-fil med følgende format:

oldEmail,newEmail

Efter at have udført nogle valideringstjek gennemløber scriptet CSV-filen og opdaterer brugernes e-mailadresser fra oldEmail til newEmail.

​

Validering

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

• både oldEmail og newEmail er gyldige e-mailadresser i hver række
• der ikke er nogen dubletter, f.eks. at du ikke forsøger at opdatere forskellige brugere til den samme nye e-mailadresse, eller at du forsøger at opdatere den samme brugerkonto med en e-mailadresse, der allerede er i brug

​

Brug

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

​

Flag

Navn	Beskrivelse
--commit	Når flaget --commit medtages, udføres migreringen rent faktisk. Hvis det udelades, sker migreringen i en dry-run-tilstand, hvor der ikke foretages ændringer, men valideringen stadig udføres. Standard:false
--continue	Flaget --continue fortsætter migreringsprocessen, hvis e-mailadressen på en brugerkonto allerede er blevet opdateret
--ignore-missing	Flaget --ignore-missing fortsætter migreringsprocessen, hvis en brugerkonto ikke blev fundet
--admin-id	--admin-id skal sættes til ID’et for den administrator, der udfører migreringen, og bruges til poster i revisionsloggen. Gå til Admin > Manage Users, søg efter din e-mailadresse, og klik på det første resultat for at finde dit bruger-ID.
<csv_file>	<csv_file> er filen, der indeholder de gamle og nye e-mailadresser

​

Afslutning

Mens migreringsscriptet kører, afhænger det af de valgte flag, om en fejl logges til konsollen, hvorefter scriptet fortsætter, eller logges til konsollen, hvorefter scriptet afsluttes. Hvis scriptet afsluttes for tidligt på grund af en fejl, afsluttes det med kode 1 for at angive, at det ikke lykkedes.

Når migreringen er fuldført, logger scriptet antallet af gennemførte, mislykkede og oversprungne opdateringer til konsollen. Hvis migreringen gennemføres uden fejl, afsluttes scriptet med kode 0.