> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/fi/kayttajien-ja-projektien-hallinta/user-management/migrating-to-ldap-or-saml.md). # Siirtyminen LDAPiin tai SAMLiin ``` { _id: '123', email: 'alice@example.com' first_name: 'Alice', last_name: 'Jones' } ``` Nyt haluat integroida yrityksesi LDAP-/Active Directory -järjestelmään. Tässä järjestelmässä Alicen tiedot ovat: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Tavoitteesi on, että Alice kirjautuu sisään LDAP-käyttäjätunnuksellaan (`alicejones`) ja salasanallaan vanhojen Overleaf-kirjautumistietojensa sijaan menettämättä mitään työstään. Näin saat sen tapahtumaan. {% hint style="warning" %} Tämä prosessi edellyttää **sharelatex** säilön luomista uudelleen, mikä aiheuttaa jonkin verran käyttökatkoa. Suosittelemme vahvasti, että tutustut tähän prosessiin käymällä sen ensin läpi testi-/välivaiheympäristössä. {% endhint %} {% stepper %} {% step %} ### Pyydä käyttäjiäsi päivittämään sähköpostiosoitteensa Overleaf-tilit on sidottu sähköpostiosoitteisiin, joten ensimmäinen vaihe on synkronoida käyttäjiesi Overleaf-sähköpostiosoitteet heidän LDAP- tai SAML-sähköpostiosoitteidensa kanssa. Esimerkissämme pyytäisit Alicea kirjautumaan Overleaf-tililleen ja vaihtamaan sähköpostiosoitteensa osoitteesta `alice@example.com` versioon `alicejones@tech.example.com`. {% hint style="warning" %} Älä unohda itseäsi! Jos olet ylläpitäjä, sinun on päivitettävä myös oma sähköpostiosoitteesi. {% endhint %} {% hint style="success" %} Jos käyttäjiä on paljon, voit käyttää [Käyttäjätunnuksen siirto](/on-premises/fi/kayttajien-ja-projektien-hallinta/user-management/username-migration.md) komentosarjaa käyttäjän ensisijaisen sähköpostiosoitteen joukkovaihtamiseen. {% endhint %} {% endstep %} {% step %} ### Ota LDAP- tai SAML-moduuli käyttöön Kun kaikkien sähköpostiosoitteet on päivitetty, on aika kytkeä toiminto päälle! Sinun on määritettävä oikeat ympäristömuuttujat uudelle todennusmenetelmällesi ja luotava sitten uudelleen **sharelatex** säilö käyttämällä `bin/up -d` komentoa. Tämä korvaa tavallisen Overleaf-kirjautumislomakkeen uudella LDAP- tai SAML-lomakkeellasi. {% hint style="info" %} Löydät LDAP:n käyttöönottoa koskevat olennaiset tiedot [tässä](/on-premises/fi/maaritys/overleaf-toolkit/authentication/ldap-authentication.md), ja SAML 2.0:n [tässä](/on-premises/fi/maaritys/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Käyttäjät voivat nyt kirjautua sisään LDAP:n tai SAML:n kautta Seuraavan kerran, kun Alice kirjautuu sisään, hän näkee uuden lomakkeen. ![LDAP/Active Directory -kirjautumissivu](/files/1168586bc9334e1566f16293096907b8aff992fd) He voivat antaa LDAP-käyttäjätunnuksensa (`alicejones`) ja salasanansa, ja koska heidän sähköpostiosoitteensa vastaa nyt LDAP:ssa olevaa osoitetta, he kirjautuvat suoraan olemassa olevalle Overleaf-tililleen. Kaikki heidän projektinsa ovat täsmälleen siellä, mihin he ne jättivät. Jos olet ottanut SAML 2.0:n käyttöön, käyttäjät näkevät painikkeen, jota napsauttamalla heidät ohjataan IdP-palveluusi syöttämään kirjautumistietonsa. Onnistuneen todennuksen jälkeen heidät ohjataan takaisin Overleaf-instanssiisi ja kirjaudutaan sisään heidän tililleen. ![SAML-kirjautumissivu](/files/902e10a7083f731ec41cc39affbff31f47a59047) {% hint style="info" %} Katso [Ympäristömuuttujat](broken://pages/21973f574b41e6ba323df98d218222a9b2512364) sivulta saat tietoa kirjautumissivun käyttökokemuksen mukauttamisesta. Jos sinun täytyy joskus palauttaa aiempi tila, kommentoi vain LDAP/SAML-määritykset pois käytöstä ja luo uudelleen **sharelatex** säilö käyttämällä `bin/up -d` komennolla. Käyttäjät voivat sitten kirjautua sisään nykyisellä sähköpostiosoitteellaan ja Overleaf-kohtaisella salasanallaan. {% endhint %} {% endstep %} {% endstepper %} ## Toiseen suuntaan: vaihtaminen LDAP/SAML:stä takaisin natiiviin todennukseen Entä jos olet käyttänyt LDAP:ia tai SAML:ia jo jonkin aikaa ja haluat siirtyä Overleafin sisäänrakennettuun kirjautumisjärjestelmään (ehkä poistit LDAP:n käytöstä)? Ei ongelmaa! Näin voit tehdä vaihdon. {% stepper %} {% step %} ### Tarkista, että kaikkien sähköpostiosoite on oikein Käyttäjiesi tilit on jo liitetty heidän LDAP- tai SAML-sähköpostiosoitteisiinsa. Tätä sähköpostiosoitetta he käyttävät kirjautumiseen jatkossa, joten varmista vain, että kaikki näyttää oikealta. {% endstep %} {% step %} ### Poista LDAP- tai SAML-moduuli käytöstä Poista tai poista käytöstä LDAP/SAML-määritysasetukset ja luo uudelleen **sharelatex** säilö käyttämällä `bin/up -d` komennolla. Tämä palauttaa Overleafin natiivin sähköposti- ja salasanakirjautumislomakkeen. ![Natiivin todennuksen kirjautumissivu](/files/0907847c6dadccb03a865dcce278e6e856634017) {% endstep %} {% step %} ### Pyydä käyttäjiä vaihtamaan salasanansa Kun käyttäjäsi nyt vierailevat kirjautumissivulla, he näkevät LDAP/SAML-lomakkeen sijaan Overleaf-kirjautumislomakkeen. Koska heillä ei ehkä ole koskaan ollut natiivia Overleaf-salasanaa, heidän on luotava sellainen. Jokaisen käyttäjän tulisi: * Napsauttaa "Unohditko salasanasi?" -linkkiä. * Syöttää tiliinsä liitetyn sähköpostiosoitteen (LDAP/SAML-osoitteen). * Seurata salasanan palautussähköpostissa olevaa linkkiä asettaakseen uuden salasanan. {% hint style="info" %} Jos et ole vielä tehnyt niin, tutustu oppaaseemme, joka käsittelee toiminnon käyttöönottoa [Sähköpostin toimitus](/on-premises/fi/maaritys/overleaf-toolkit/email-delivery.md). {% endhint %} Kun se on tehty, he voivat kirjautua sisään sähköpostiosoitteellaan ja uudella Overleaf-kohtaisella salasanallaan päästäkseen kaikkiin projekteihinsa. {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/fi/kayttajien-ja-projektien-hallinta/user-management/migrating-to-ldap-or-saml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.