Siirtyminen LDAP:hen tai SAML:ään

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

Nyt haluat integroida järjestelmän yrityksesi LDAP-/Active Directory -järjestelmään. Siinä järjestelmässä Alicen tiedot ovat:

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

Tavoitteenasi on, että Alice kirjautuu LDAP-käyttäjänimellään (alicejones) ja salasanallaan vanhojen Overleaf-tunnustensa sijaan menettämättä mitään töistään. Näin se onnistuu.

Tämä prosessi edellyttää sharelatex-kontin uudelleenluontia, mikä aiheuttaa jonkin verran käyttökatkoa. Suosittelemme vahvasti, että tutustut prosessiin käymällä sen ensin läpi testi-/staging-ympäristössä.

1. Pyydä käyttäjiä päivittämään sähköpostiosoitteensa

   Overleaf-tilit on sidottu sähköpostiosoitteisiin, joten ensimmäinen vaihe on saada käyttäjien Overleaf-sähköpostiosoitteet vastaamaan heidän LDAP- tai SAML-sähköpostiosoitteitaan.

   Esimerkissämme pyytäisit Alicea kirjautumaan Overleaf-tililleen ja vaihtamaan sähköpostiosoitteensa [e-mail] osoitteeksi [e-mail].

   Älä unohda itseäsi! Jos olet ylläpitäjä, sinun on päivitettävä myös oma sähköpostiosoitteesi.

   Jos käyttäjiä on paljon, voit vaihtaa käyttäjien ensisijaisia sähköpostiosoitteita joukkona Username migration -skriptillä.

2. Ota LDAP- tai SAML-moduuli käyttöön

   Kun kaikkien sähköpostiosoitteet on päivitetty, on aika kääntää kytkintä! Aseta uuden todennustavan edellyttämät ympäristömuuttujat ja luo sitten sharelatex-kontti uudelleen komennolla bin/up -d.

   Tämä korvaa Overleafin tavallisen kirjautumislomakkeen uudella LDAP- tai SAML-lomakkeella.

   LDAP:n käyttöönottoon liittyvät tiedot löydät täältä ja SAML 2.0:n tiedot täältä.

3. Käyttäjät voivat nyt kirjautua LDAP:n tai SAML:n kautta

   Kun Alice seuraavan kerran kirjautuu, hän näkee uuden lomakkeen.

   

   Hän voi syöttää LDAP-käyttäjänimensä (alicejones) ja salasanansa, ja koska hänen sähköpostiosoitteensa vastaa nyt LDAP:n osoitetta, hän kirjautuu suoraan olemassa olevalle Overleaf-tililleen. Kaikki projektit ovat juuri siellä, mihin hän ne jätti.

   Jos olet ottanut SAML 2.0:n käyttöön, käyttäjät näkevät painikkeen, joka napsautettaessa ohjaa heidät IdP:hen syöttämään tunnuksensa. Onnistuneen todennuksen jälkeen heidät ohjataan takaisin Overleaf-instanssiisi ja kirjataan sisään tililleen.

   

   Katso Ympäristömuuttujat-sivulta tietoja kirjautumissivun mukauttamisesta.

   Jos joskus tarvitset palautuksen aiempaan, kommentoi LDAP-/SAML-määritys pois ja luo sharelatex-kontti uudelleen komennolla bin/up -d. Käyttäjät voivat sen jälkeen kirjautua nykyisellä sähköpostiosoitteellaan ja Overleaf-kohtaisella salasanallaan.

​

Toiseen suuntaan: paluu LDAP:stä/SAML:stä alkuperäiseen todennukseen

Entä jos olet käyttänyt LDAP:tä tai SAML:ää jonkin aikaa ja haluat siirtyä Overleafin sisäänrakennettuun kirjautumisjärjestelmään (ehkä olet luopunut LDAP:stä)? Ei hätää! Näin voit tehdä vaihdon.

1. Tarkista, että kaikkien sähköpostiosoitteet ovat oikein

   Käyttäjiesi tilit on jo linkitetty heidän LDAP- tai SAML-sähköpostiosoitteisiinsa. Tätä osoitetta he käyttävät kirjautumiseen jatkossa, joten varmista vain, että kaikki näyttää oikealta.

2. Poista LDAP- tai SAML-moduuli käytöstä

   Poista LDAP-/SAML-määritysasetukset tai jätä ne asettamatta ja luo sharelatex-kontti uudelleen komennolla bin/up -d. Tämä palauttaa Overleafin alkuperäisen sähköposti- ja salasanakirjautumislomakkeen.

   
3. Pyydä käyttäjiä nollaamaan salasanansa

   Kun käyttäjät nyt avaavat kirjautumissivun, he näkevät Overleafin kirjautumislomakkeen LDAP-/SAML-lomakkeen sijaan.

   Koska heillä ei ehkä ole koskaan ollut Overleafin omaa salasanaa, heidän on luotava sellainen. Jokaisen käyttäjän tulee:

   • Napsauttaa “Forgot your password?” -linkkiä.
   • Syöttää tiliinsä liitetty sähköpostiosoite (LDAP:stä/SAML:stä peräisin oleva).
   • Asettaa uusi salasana salasanan palautusviestin linkin kautta.

   Jos et ole vielä tehnyt niin, tutustu oppaaseemme sähköpostin toimituksen käyttöönotosta.

   Kun tämä on tehty, he voivat kirjautua sähköpostiosoitteellaan ja uudella Overleaf-kohtaisella salasanallaan ja käyttää kaikkia projektejaan.