Siirry pääsisältöön
Tuettuja todennustapoja on kolme. Määrityksen jälkeen voit kirjautua seuraavilla vaihtoehdoilla alla olevan kuvan mukaisesti.
Suosittelemme lämpimästi OIDC:n käyttöä, koska se on yleisin menetelmä.

OIDC-todennus

SAML-todennus

LDAP-todennus

Julkinen pääsy

reCAPTCHA

Salasanarajoitukset

Yleinen määritys

Ympäristömuuttuja EXTERNAL_AUTH vaaditaan tietyn todennusmoduulin käyttöönottoon. Tämä ympäristömuuttuja määrittää, mitkä ulkoiset todennustavat ovat käytössä. Käytettävissä olevat vaihtoehdot ovat (pienillä kirjaimilla):
  • saml
  • ldap
  • oidc
Jos haluat, että käyttäjät voivat kirjautua sisään vain näillä tavoilla, aseta OVERLEAF_DISABLE_LOCAL_LOGIN=true. Tämä piilottaa sähköpostiosoitteella ja salasanalla kirjautumisen. Asetuksella ei ole vaikutusta, ellei EXTERNAL_AUTH ota käyttöön vähintään yhtä tapaa (lisätty versiossa 6.3.1).

Tilit ja salasanat

Kun EXTERNAL_AUTH on asetettu, instanssilla voi olla tilejä paikallisella salasanalla ja ilman. Se, saako tili asettaa tai vaihtaa salasanan, riippuu vain tästä: tili, jolla on paikallinen salasana, hallitsee sitä; tili ilman paikallista salasanaa kirjautuu vain SSO:n kautta eikä voi saada salasanaa ylläpitäjältä. Instanssilla, jonka ainoa menetelmä on OIDC, se voi asettaa salasanan itse palautussähköpostilla, ellei OVERLEAF_DISABLE_LOCAL_LOGIN=true.
  • LDAP ja SAML ottavat ensimmäisellä kirjautumisella haltuunsa paikallisen tilin, jolla on sama sähköpostiosoite, ja poistavat sen paikallisen salasanan jokaisella kirjautumisella. Eri sähköpostiosoitteella ne luovat uuden tilin ja jättävät paikallisen tilin ennalleen.
  • Ensimmäinen LDAP-, SAML- tai OIDC-kirjautuminen, jonka sähköpostiosoite on toisen tilin toissijainen sähköpostiosoite, hylätään: se ei kirjaudu kyseiselle tilille.
  • OIDC linkittyy tiliin ja säilyttää sen salasanan, joten OIDC:hen linkitetty paikallinen tili voi kirjautua kummallakin tavalla. Se linkitetään asetussivun Link-painikkeella tai ensimmäisellä OIDC-kirjautumisella, kun sähköpostiosoite täsmää. Katso linkittämisestä OIDC-todennus.
  • Tili, jonka ylläpitäjä luo paikalliseksi tiliksi, saa aktivointisähköpostin: aktivointi asettaa sen salasanan samalla tavalla kuin palautus sähköpostitse.
  • Kun useita menetelmiä on käytössä, esim. EXTERNAL_AUTH=ldap saml oidc, yllä olevat säännöt pysyvät samoina: vain tilin paikallinen salasana ratkaisee, eikä tili ilman paikallista salasanaa voi asettaa sellaista, ei myöskään OIDC:n luoma tili.
  • Jos IdP sulkee tilejä, joiden pitää menettää pääsy, kuten entisten työntekijöiden tilejä, aseta OIDC-instanssissa OVERLEAF_DISABLE_LOCAL_LOGIN=true: muuten paikallisen salasanan asettanut henkilö voi yhä kirjautua sisään sen jälkeen, kun IdP on sulkenut tilin.
  • Sähköpostipalautus vaatii sähköpostiasetukset (OVERLEAF_EMAIL_*). Ilman niitä sähköpostia ei lähetetä, vaikka sivu niin väittää: ylläpitäjä kopioi sen sijaan palautuslinkin tai asettaa salasanan kohdassa Admin → Manage Users.
  • OVERLEAF_DISABLE_LOCAL_LOGIN=true piilottaa sähköpostiosoitteella ja salasanalla kirjautumisen, mutta säilyttää salasanat: ne toimivat taas, kun kirjautuminen näytetään uudelleen.
  • Kun EXTERNAL_AUTH on asetettu, käyttäjät eivät voi kirjoittaa uutta sähköpostiosoitetta asetussivulle menetelmästä riippumatta: käyttäjän ensimmäinen OIDC-kirjautuminen linkittää tilin, jolla on käyttäjän sähköpostiosoite. Ylläpitäjät vaihtavat sähköpostiosoitteita kohdassa Admin → Manage Users. Sähköpostiasetusten avulla käyttäjät lisäävät sähköpostiosoitteita, jotka he vahvistavat koodilla, ja voivat tehdä yhdestä ensisijaisen instanssilla, jossa ei ole LDAP:ta eikä SAML:ia.
  • Instanssissa, jossa on OIDC, käytä rekisteröitymistä aktivointisähköpostilla, kuten arvoa OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@<domain> tai @* (aktivointisähköposti todistaa osoitteen), arvon true sijaan, tai älä salli julkista rekisteröitymistä lainkaan: arvolla true kuka tahansa voisi rekisteröityä kollegan sähköpostiosoitteella ennen kollegan ensimmäistä OIDC-kirjautumista, jolloin kollega linkitettäisiin kyseiseen tiliin.

Q&A

Vastaus: Kyllä, versiosta v6.4.0 alkaen. Aseta RECAPTCHA_SITE_KEY ja RECAPTCHA_SECRET_KEY reCAPTCHA v2 invisible -avaimesta, katso reCAPTCHA. Se kattaa sähköpostiosoitteella ja salasanalla kirjautumisen, LDAP-kirjautumisen, rekisteröitymisen ja salasanan palautuksen. Aiemmissa versioissa tälle ei ole asetusta; kirjautumisyrityksiä rajoitetaan kaikissa versioissa: 20 yritystä minuutissa IP-osoitetta kohden ja 10 yritystä kahdessa minuutissa sähköpostiosoitetta kohden.
Viimeksi muokattu 13. marraskuuta 2026