Migrere til LDAP eller SAML

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

Nå vil du integrere med bedriftens LDAP-/Active Directory-system. I det systemet er Alices opplysninger:

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

Målet ditt er at Alice skal logge inn med LDAP-brukernavnet sitt (alicejones) og passordet sitt i stedet for den gamle Overleaf-påloggingen, uten å miste noe av arbeidet sitt. Slik får du det til.

Denne prosessen krever at sharelatex-containeren gjenopprettes, noe som vil føre til noe nedetid. Vi anbefaler sterkt at du gjør deg kjent med prosessen ved først å gå gjennom den i et test-/stagingmiljø.

1. Be brukerne dine oppdatere e-postadressene sine

   Overleaf-kontoer er knyttet til e-postadresser, så det første trinnet er å synkronisere brukernes e-postadresser i Overleaf med e-postadressene deres i LDAP eller SAML.

   I eksemplet vårt ville du bedt Alice om å logge inn på Overleaf-kontoen sin og endre e-postadressen fra [e-mail] til [e-mail].

   Ikke glem deg selv! Hvis du er administrator, må du også oppdatere din egen e-postadresse.

   Hvis du har mange brukere, kan du bruke skriptet for migrering av brukernavn til å endre brukernes primære e-postadresse samlet.

2. Aktiver LDAP- eller SAML-modulen

   Når alles e-postadresser er oppdatert, er det på tide å slå på bryteren! Du må sette de riktige miljøvariablene for den nye autentiseringsmetoden og deretter gjenopprette sharelatex-containeren med kommandoen bin/up -d.

   Dette bytter ut det vanlige påloggingsskjemaet i Overleaf med det nye LDAP- eller SAML-skjemaet.

   Du finner relevant informasjon om hvordan du aktiverer LDAP her, og SAML 2.0 her.

3. Brukerne kan nå logge inn via LDAP eller SAML

   Neste gang Alice skal logge inn, ser hun det nye skjemaet.

   

   Hun kan skrive inn LDAP-brukernavnet sitt (alicejones) og passordet, og fordi e-postadressen hennes nå samsvarer med den i LDAP, blir hun logget rett inn på sin eksisterende Overleaf-konto. Alle prosjektene hennes vil være akkurat der hun forlot dem.

   Hvis du har aktivert SAML 2.0, ser brukerne en knapp som, når den klikkes, sender dem videre til IdP-en din for å oppgi påloggingsinformasjonen. Etter vellykket autentisering blir de sendt tilbake til Overleaf-instansen og logget inn på kontoen sin.

   

   Se siden Miljøvariabler for informasjon om hvordan du tilpasser påloggingssiden.

   Og hvis du noen gang må rulle tilbake, kommenterer du bare ut LDAP/SAML-konfigurasjonen og gjenoppretter sharelatex-containeren med kommandoen bin/up -d. Brukerne kan da logge inn med sin nåværende e-postadresse og sitt Overleaf-spesifikke passord.

​

Motsatt vei: bytte fra LDAP/SAML tilbake til innebygd autentisering

Hva om du har brukt LDAP eller SAML en stund og vil gå over til Overleafs innebygde påloggingssystem (kanskje du har faset ut LDAP)? Ikke noe problem! Slik gjør du byttet.

1. Kontroller at alles e-postadresse er riktig

   Brukernes kontoer er allerede knyttet til e-postadressene deres i LDAP eller SAML. Dette er e-postadressen de skal bruke til å logge inn fra nå av, så sørg bare for at alt ser riktig ut.

2. Deaktiver LDAP- eller SAML-modulen

   Fjern ganske enkelt LDAP/SAML-konfigurasjonsinnstillingene, eller la dem være usatt, og gjenopprett sharelatex-containeren med kommandoen bin/up -d. Dette gjenoppretter det innebygde påloggingsskjemaet i Overleaf med e-post og passord.

   
3. Be brukerne tilbakestille passordene sine

   Når brukerne nå besøker påloggingssiden, ser de Overleafs påloggingsskjema i stedet for LDAP/SAML-skjemaet.

   Siden de kanskje aldri har hatt et eget Overleaf-passord, må de opprette ett. Hver bruker bør:

   • Klikke på lenken “Forgot your password?”.
   • Skrive inn e-postadressen som er knyttet til kontoen (den fra LDAP/SAML).
   • Følge lenken i e-posten for tilbakestilling av passord for å angi et nytt passord.

   Hvis du ikke allerede har gjort det, kan du se veiledningen vår om hvordan du aktiverer E-postlevering.

   Når det er gjort, kan de logge inn med e-postadressen og det nye Overleaf-spesifikke passordet for å få tilgang til alle prosjektene sine.