Migrera till LDAP eller SAML

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

Nu vill du integrera med ditt företags LDAP-/Active Directory-system. I det systemet ser Alices uppgifter ut så här:

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

Målet är att Alice ska logga in med sitt LDAP-användarnamn (alicejones) och lösenord i stället för sina gamla Overleaf-inloggningsuppgifter, utan att förlora något av sitt arbete. Så här gör du det.

Den här processen kräver att containern sharelatex återskapas, vilket leder till viss driftstopp. Vi rekommenderar starkt att du bekantar dig med processen genom att först gå igenom den i en test-/stagingmiljö.

1. Be dina användare att uppdatera sina e-postadresser

   Overleaf-konton är knutna till e-postadresser, så det första steget är att synkronisera användarnas e-postadresser i Overleaf med deras e-postadresser i LDAP eller SAML.

   I vårt exempel ber du Alice att logga in på sitt Overleaf-konto och ändra sin e-postadress från [e-mail] till [e-mail].

   Glöm inte bort dig själv! Om du är administratör måste du också uppdatera din egen e-postadress.

   Om du har många användare kan du använda skriptet Username migration för att ändra användares primära e-postadress i bulk.

2. Aktivera LDAP- eller SAML-modulen

   När allas e-postadresser har uppdaterats är det dags att slå om! Du behöver ange rätt miljövariabler för din nya autentiseringsmetod och sedan återskapa containern sharelatex med kommandot bin/up -d.

   Detta ersätter Overleafs vanliga inloggningsformulär med ditt nya LDAP- eller SAML-formulär.

   Du hittar relevant information om hur du aktiverar LDAP här och SAML 2.0 här.

3. Användarna kan nu logga in via LDAP eller SAML

   Nästa gång Alice loggar in ser hon det nya formuläret.

   

   Hon kan ange sitt LDAP-användarnamn (alicejones) och lösenord, och eftersom hennes e-postadress nu matchar den i LDAP loggas hon direkt in på sitt befintliga Overleaf-konto. Alla hennes projekt finns kvar precis där hon lämnade dem.

   Om du har aktiverat SAML 2.0 ser användarna en knapp som, när den klickas, omdirigerar dem till din IdP där de anger sina inloggningsuppgifter. Efter lyckad autentisering omdirigeras de tillbaka till din Overleaf-instans och loggas in på sitt konto.

   

   Se sidan Miljövariabler för information om hur du anpassar inloggningssidan.

   Och om du någon gång behöver rulla tillbaka kommenterar du bara bort LDAP-/SAML-konfigurationen och återskapar containern sharelatex med kommandot bin/up -d. Användarna kan då logga in med sin nuvarande e-postadress och sitt Overleaf-specifika lösenord.

​

Åt andra hållet: byta från LDAP/SAML tillbaka till inbyggd autentisering

Vad händer om du har använt LDAP eller SAML ett tag och vill gå över till Overleafs inbyggda inloggningssystem (kanske för att du har avvecklat din LDAP)? Inga problem! Så här gör du bytet.

1. Kontrollera att allas e-postadresser är korrekta

   Användarnas konton är redan kopplade till deras e-postadresser i LDAP eller SAML. Det är den e-postadress de kommer att logga in med från och med nu, så se bara till att allt ser rätt ut.

2. Inaktivera LDAP- eller SAML-modulen

   Ta helt enkelt bort eller avaktivera konfigurationsinställningarna för LDAP/SAML och återskapa containern sharelatex med kommandot bin/up -d. Detta återställer Overleafs inbyggda inloggningsformulär med e-postadress och lösenord.

   
3. Be användarna att återställa sina lösenord

   När användarna nu besöker inloggningssidan ser de Overleafs inloggningsformulär i stället för LDAP-/SAML-formuläret.

   Eftersom de kanske aldrig har haft något inbyggt Overleaf-lösenord måste de skapa ett. Varje användare bör:

   • Klicka på länken “Forgot your password?”.
   • Ange den e-postadress som är kopplad till kontot (den från LDAP/SAML).
   • Följa länken i e-postmeddelandet om lösenordsåterställning för att ange ett nytt lösenord.

   Om du inte redan har gjort det kan du läsa vår guide om hur du aktiverar e-postleverans.

   När det är klart kan de logga in med sin e-postadress och sitt nya Overleaf-specifika lösenord för att komma åt alla sina projekt.