Migrering til LDAP eller SAML

{
  _id:        '123',
  email:      '[e-mail]'
  first_name: 'Alice',
  last_name:  'Jones'
}

Nu vil du integrere med din virksomheds LDAP/Active Directory-system. I det system er Alices oplysninger:

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - givenName:   'Alice'
  - sn: 'Jones'

Dit mål er, at Alice logger ind med sit LDAP-brugernavn (alicejones) og sin adgangskode i stedet for sine gamle Overleaf-loginoplysninger, uden at miste noget af sit arbejde. Sådan gør du.

Denne proces kræver, at sharelatex-containeren genoprettes, hvilket vil medføre en vis nedetid. Vi anbefaler kraftigt, at du gør dig fortrolig med processen ved først at gennemføre den i et test-/staging-miljø.

1. Bed dine brugere om at opdatere deres e-mailadresser

   Overleaf-konti er knyttet til e-mailadresser, så det første skridt er at få dine brugeres Overleaf-e-mails synkroniseret med deres LDAP- eller SAML-e-mails.

   I vores eksempel skal du bede Alice om at logge ind på sin Overleaf-konto og ændre sin e-mail fra [e-mail] til [e-mail].

   Glem ikke dig selv! Hvis du er administrator, skal du også opdatere din egen e-mailadresse.

   Hvis du har mange brugere, kan du bruge scriptet Migrering af brugernavne til at ændre brugeres primære e-mailadresse samlet.

2. Aktiver LDAP- eller SAML-modulet

   Når alles e-mailadresser er opdateret, er det tid til at slå kontakten til! Du skal sætte de rigtige miljøvariabler for din nye godkendelsesmetode og derefter genoprette sharelatex-containeren med kommandoen bin/up -d.

   Dette udskifter Overleafs standardloginformular med din nye LDAP- eller SAML-formular.

   Du kan finde de relevante oplysninger om aktivering af LDAP her og om SAML 2.0 her.

3. Brugerne kan nu logge ind via LDAP eller SAML

   Næste gang Alice skal logge ind, vil hun se den nye formular.

   

   Hun kan indtaste sit LDAP-brugernavn (alicejones) og sin adgangskode, og fordi hendes e-mailadresse nu matcher den i LDAP, bliver hun logget direkte ind på sin eksisterende Overleaf-konto. Alle hendes projekter vil være præcis, hvor hun forlod dem.

   Hvis du har aktiveret SAML 2.0, vil brugerne se en knap, som ved klik omdirigerer dem til din IdP, hvor de skal indtaste deres loginoplysninger. Efter en vellykket godkendelse bliver de omdirigeret tilbage til din Overleaf-instans og logget ind på deres konto.

   

   Se siden Miljøvariabler for oplysninger om tilpasning af loginsiden.

   Og hvis du nogensinde får brug for at rulle tilbage, skal du blot udkommentere LDAP/SAML-konfigurationen og genoprette sharelatex-containeren med kommandoen bin/up -d. Brugerne vil derefter kunne logge ind med deres nuværende e-mailadresse og Overleaf-specifikke adgangskode.

​

Den anden vej: Skift fra LDAP/SAML tilbage til indbygget godkendelse

Hvad hvis du har brugt LDAP eller SAML i et stykke tid og vil skifte til Overleafs indbyggede loginsystem (måske har du udfaset dit LDAP)? Intet problem! Sådan kan du foretage skiftet.

1. Kontrollér, at alles e-mail er korrekt

   Dine brugeres konti er allerede knyttet til deres LDAP- eller SAML-e-mailadresser. Det er den e-mail, de vil bruge til at logge ind fremover, så sørg blot for, at alt ser rigtigt ud.

2. Deaktiver LDAP- eller SAML-modulet

   Fjern eller nulstil blot LDAP/SAML-konfigurationsindstillingerne, og genopret sharelatex-containeren med kommandoen bin/up -d. Det bringer Overleafs indbyggede loginformular med e-mail og adgangskode tilbage.

   
3. Bed brugerne om at nulstille deres adgangskoder

   Når dine brugere nu besøger loginsiden, vil de se Overleafs loginformular i stedet for LDAP/SAML-formularen.

   Da de måske aldrig har haft en indbygget Overleaf-adgangskode, skal de oprette en. Hver bruger skal:

   • Klikke på linket “Forgot your password?”.
   • Indtaste den e-mailadresse, der er knyttet til deres konto (den fra LDAP/SAML).
   • Følge linket i e-mailen til nulstilling af adgangskode for at angive en ny adgangskode.

   Hvis du ikke allerede har gjort det, så se vores vejledning om aktivering af levering af e-mail.

   Når det er gjort, kan de logge ind med deres e-mail og deres nye Overleaf-specifikke adgangskode og få adgang til alle deres projekter.