> 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-cs/sprava-uzivatelu-a-projektu/user-management/migrating-to-ldap-or-saml.md).

# Migrace na LDAP nebo SAML

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

Nyní chcete integraci s LDAP/Active Directory systémem vaší firmy. V tomto systému jsou údaje o Alici následující:

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

Vaším cílem je, aby se Alice přihlašovala svým LDAP uživatelským jménem (`alicejones`) a heslem místo svých starých přihlašovacích údajů do Overleafu, aniž by přišla o jakoukoli svou práci. Takhle toho dosáhnete.

{% hint style="warning" %}
Tento proces bude vyžadovat znovuvytvoření **sharelatex** kontejneru, což způsobí určitý výpadek. Důrazně doporučujeme, abyste se s tímto procesem nejprve seznámili na testovacím/stagingovém prostředí.
{% endhint %}

{% stepper %}
{% step %}

### Požádejte uživatele, aby aktualizovali své e-mailové adresy

Účty Overleaf jsou navázané na e-mailové adresy, takže prvním krokem je sladit e-maily vašich uživatelů v Overleafu s jejich LDAP nebo SAML e-maily.

V našem příkladu byste požádali Alici, aby se přihlásila ke svému účtu Overleaf a změnila svůj e-mail z `alice@example.com` na `alicejones@tech.example.com`.

{% hint style="warning" %}
Nezapomeňte ani na sebe! Pokud jste administrátor, budete muset aktualizovat i svou vlastní e-mailovou adresu.
{% endhint %}

{% hint style="success" %}
Pokud máte hodně uživatelů, můžete použít [Migrace uživatelských jmen](/on-premises/on-premises-cs/sprava-uzivatelu-a-projektu/user-management/username-migration.md) skript ke hromadné změně primární e-mailové adresy uživatele.
{% endhint %}
{% endstep %}

{% step %}

### Povolte modul LDAP nebo SAML

Jakmile budou e-mailové adresy všech aktualizované, je čas přepnout! Budete muset nastavit správné proměnné prostředí pro svou novou metodu ověřování a pak znovu vytvořit **sharelatex** kontejner pomocí `bin/up -d` příkazu.

Tím se standardní přihlašovací formulář Overleafu nahradí vaším novým LDAP nebo SAML formulářem.

{% hint style="info" %}
Příslušné informace pro povolení LDAP najdete [zde](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/authentication/ldap-authentication.md), a SAML 2.0 [zde](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

### Uživatelé se nyní mohou přihlašovat přes LDAP nebo SAML

Až se Alice příště půjde přihlásit, uvidí nový formulář.

![Přihlašovací stránka LDAP/Active Directory](/files/69f12c9ecc7ce0b56dab2b0c6e2ae04967bd2b28)

Mohou zadat své LDAP uživatelské jméno (`alicejones`) a heslo, a protože se jejich e-mailová adresa nyní shoduje s tou v LDAP, budou přihlášeni přímo do svého stávajícího účtu Overleaf. Všechny jejich projekty budou přesně tam, kde je nechali.

Pokud jste povolili SAML 2.0, uživatelé uvidí tlačítko, které je po kliknutí přesměruje k vašemu IdP, aby zadali své přihlašovací údaje. Po úspěšném ověření budou přesměrováni zpět do vaší instance Overleaf a přihlášeni ke svému účtu.

![Přihlašovací stránka SAML](/files/6cd62b1e8688dac7fabc64e87e3a1643f0363776)

{% hint style="info" %}
Viz [Proměnné prostředí](broken://pages/7032811494e0197360851b99088110b0a3cd1079) stránka s informacemi o přizpůsobení vzhledu a chování přihlašovací stránky.

A pokud budete někdy potřebovat vrátit změny, stačí zakomentovat konfiguraci LDAP/SAML a znovu vytvořit **sharelatex** kontejner pomocí `bin/up -d` příkaz. Uživatelé se pak budou moci přihlásit pomocí své aktuální e-mailové adresy a hesla specifického pro Overleaf.
{% endhint %}
{% endstep %}
{% endstepper %}

## A naopak: Přechod z LDAP/SAML zpět na nativní ověřování

Co když už LDAP nebo SAML nějakou dobu používáte a chcete přejít na vestavěný přihlašovací systém Overleafu (třeba jste LDAP zrušili)? Žádný problém! Takhle můžete přepnout.

{% stepper %}
{% step %}

### Zkontrolujte, že jsou e-mailové adresy všech správné

Účty vašich uživatelů jsou už propojené s jejich LDAP nebo SAML e-mailovými adresami. To je e-mail, který budou od nynějška používat k přihlašování, takže jen zkontrolujte, že vše vypadá správně.
{% endstep %}

{% step %}

### Zakázat modul LDAP nebo SAML

Jednoduše odstraňte nebo zrušte nastavení konfigurace LDAP/SAML a znovu vytvořte **sharelatex** kontejner pomocí `bin/up -d` příkaz. Tím se obnoví nativní přihlašovací formulář Overleafu pro e-mail a heslo.

![Přihlašovací stránka nativního ověřování](/files/ee9d3ef9f539ee8e2d55edcd666eb0546699718f)
{% endstep %}

{% step %}

### Požádejte uživatele, aby si resetovali hesla

Když uživatelé nyní navštíví přihlašovací stránku, uvidí formulář Overleafu místo LDAP/SAML formuláře.

Protože možná nikdy neměli nativní heslo do Overleafu, budou si muset jedno vytvořit. Každý uživatel by měl:

* Kliknout na odkaz „Zapomněli jste heslo?“.
* Zadat e-mailovou adresu spojenou s jejich účtem (tu z LDAP/SAML).
* Podle odkazu v e-mailu pro obnovení hesla si nastavit nové heslo.

{% hint style="info" %}
Pokud jste to ještě neudělali, podívejte se na náš průvodce povolením [doručování e-mailů](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/email-delivery.md).
{% endhint %}

Jakmile je hotovo, mohou se přihlásit pomocí svého e-mailu a nového hesla specifického pro Overleaf, aby měli přístup ke všem svým projektům.
{% 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-cs/sprava-uzivatelu-a-projektu/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.
