> 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/on-premises-no/bruker-og-prosjektadministrasjon/user-management/migrating-to-ldap-or-saml.md).

# Migrering til LDAP eller SAML

```
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

Nå ønsker du å integrere med selskapets LDAP/Active Directory-system. I det systemet er Alices detaljer:

```
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

Målet ditt er at Alice skal logge inn med LDAP-brukernavnet sitt (`alicejones`) og passordet i stedet for de gamle Overleaf-opplysningene, uten å miste noe av arbeidet sitt. Slik gjør du det.

{% hint style="warning" %}
Denne prosessen krever at du gjenskaper **sharelatex** containeren, noe som vil føre til noe nedetid. Vi anbefaler på det sterkeste at du gjør deg kjent med denne prosessen ved å gå gjennom den i et test-/stagingmiljø først.
{% endhint %}

{% stepper %}
{% step %}

### Be brukerne dine oppdatere e-postadressene sine

Overleaf-kontoer er knyttet til e-postadresser, så første steg er å få Overleaf-e-postene til brukerne dine synkronisert med LDAP- eller SAML-e-postene deres.

I vårt eksempel vil du be Alice om å logge inn på Overleaf-kontoen sin og endre e-postadressen sin fra `alice@example.com` til `alicejones@tech.example.com`.

{% hint style="warning" %}
Ikke glem deg selv! Hvis du er administrator, må du også oppdatere din egen e-postadresse.
{% endhint %}

{% hint style="success" %}
Hvis du har mange brukere, kan du bruke [Migrering av brukernavn](/on-premises/on-premises-no/bruker-og-prosjektadministrasjon/user-management/username-migration.md) skriptet til å endre en brukers primære e-postadresse i bulk.
{% endhint %}
{% endstep %}

{% step %}

### Aktiver LDAP- eller SAML-modulen

Når alles e-postadresser er oppdatert, er det på tide å slå om bryteren! Du må sette de riktige miljøvariablene for din nye autentiseringsmetode og deretter gjenskape **sharelatex** containeren ved å bruke `bin/up -d` kommandoen.

Dette bytter ut standard innloggingsskjema i Overleaf med ditt nye LDAP- eller SAML-skjema.

{% hint style="info" %}
Du finner relevant informasjon om hvordan du aktiverer LDAP [her](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/authentication/ldap-authentication.md), og SAML 2.0 [her](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

### Brukere kan nå logge inn via LDAP eller SAML

Neste gang Alice går til innlogging, vil de se det nye skjemaet.

![Innloggingsside for LDAP/Active Directory](/files/89b1c722e53a40581c736111a8fbbc33f66f4008)

De kan skrive inn LDAP-brukernavnet sitt (`alicejones`) og passordet, og siden e-postadressen deres nå samsvarer med den i LDAP, blir de logget rett inn på sin eksisterende Overleaf-konto. Alle prosjektene deres vil være akkurat der de lot dem.

Hvis du har aktivert SAML 2.0, vil brukerne se en knapp som, når den klikkes, videresender dem til IdP-en din for å skrive inn påloggingsopplysningene sine. Når autentiseringen er vellykket, blir de sendt tilbake til din Overleaf-instans og logget inn på kontoen sin.

![Innloggingsside for SAML](/files/1b139f9a013e72c3c7a95232066b104a6128f7cd)

{% hint style="info" %}
Se [Miljøvariabler](broken://pages/c0ffc56ce41ad234a342dad5f6b8b7a1aef2e1df) side for informasjon om hvordan du tilpasser opplevelsen på innloggingssiden.

Og hvis du noen gang trenger å rulle tilbake, er det bare å kommentere ut LDAP/SAML-konfigurasjonen og gjenskape **sharelatex** containeren ved å bruke `bin/up -d` kommandoen. Brukere vil da kunne logge inn med sin nåværende e-postadresse og sitt Overleaf-spesifikke passord.
{% endhint %}
{% endstep %}
{% endstepper %}

## Den andre veien: Bytte fra LDAP/SAML tilbake til opprinnelig autentisering

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

{% stepper %}
{% step %}

### Sjekk at alles e-post er riktig

Brukernes kontoer er allerede koblet til deres LDAP- eller SAML-e-postadresser. Dette er e-postadressen de vil bruke for å logge inn fra nå av, så sørg bare for at alt ser riktig ut.
{% endstep %}

{% step %}

### Deaktiver LDAP- eller SAML-modulen

Fjern eller opphev ganske enkelt LDAP/SAML-konfigurasjonsinnstillingene og gjenskap **sharelatex** containeren ved å bruke `bin/up -d` kommandoen. Dette vil bringe tilbake det opprinnelige Overleaf-innloggingsskjemaet for e-post og passord.

![Innloggingsside for opprinnelig autentisering](/files/f8440ce587314ec48e216e431c5e32efb83e8d1c)
{% endstep %}

{% step %}

### Be brukerne tilbakestille passordene sine

Når brukerne dine besøker innloggingssiden nå, vil de se Overleaf-innloggingsskjemaet i stedet for LDAP/SAML-skjemaet.

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

* Klikke på lenken «Glemt passordet ditt?».
* Skrive inn e-postadressen som er knyttet til kontoen deres (den fra LDAP/SAML).
* Følge lenken i e-posten om tilbakestilling av passord for å sette et nytt passord.

{% hint style="info" %}
Hvis du ikke allerede har gjort det, se guiden vår om å aktivere [E-postlevering](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/email-delivery.md).
{% endhint %}

Når det er gjort, kan de logge inn med e-posten sin og det nye Overleaf-spesifikke passordet for å få tilgang til alle prosjektene sine.
{% 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/on-premises-no/bruker-og-prosjektadministrasjon/user-management/migrating-to-ldap-or-saml.md?ask=<question>&goal=<endgoal>
```

`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.