> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 sitt i stedet for de gamle Overleaf-legitimasjonsopplysningene, uten å miste noe av arbeidet sitt. Slik får du det til.

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

{% stepper %}
{% step %}

### Be brukerne dine oppdatere e-postadressene sine

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

I vårt eksempel ville du bedt 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 oppdatere din egen e-postadresse også.
{% 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å på bryteren! Du må angi de riktige miljøvariablene for den nye autentiseringsmetoden din og deretter gjenskape **sharelatex** containeren ved å bruke `bin/up -d` kommandoen.

Dette bytter ut det vanlige Overleaf-innloggingsskjemaet med ditt nye LDAP- eller SAML-skjema.

{% hint style="info" %}
Du finner relevant informasjon for å aktivere 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 for å logge inn, vil de se det nye skjemaet.

![LDAP/Active Directory-innloggingsside](/files/89b1c722e53a40581c736111a8fbbc33f66f4008)

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

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

![SAML-innloggingsside](/files/1b139f9a013e72c3c7a95232066b104a6128f7cd)

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

og gjenskape **sharelatex** containeren ved å bruke `bin/up -d` kommandoen. Brukerne vil deretter 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 innebygd autentisering

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

{% stepper %}
{% step %}

### Sjekk at alles e-postadresser er riktige

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

{% step %}

### Deaktiver LDAP- eller SAML-modulen

Bare fjern eller nullstill LDAP/SAML-konfigurasjonsinnstillingene og gjenskape **sharelatex** containeren ved å bruke `bin/up -d` kommandoen. Dette vil bringe tilbake det innebygde Overleaf-innloggingsskjemaet for e-post og passord.

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

{% step %}

### Be brukerne om å tilbakestille passordene sine

Når brukerne dine besøker innloggingssiden nå, vil de se Overleafs innloggingsskjema i stedet for LDAP/SAML-skjemet.

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

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

{% hint style="info" %}
Hvis du ikke allerede har gjort det, kan du 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 sitt 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://ayakaleaf-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.