> 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.md).

# Správa uživatelů

## Vytvoření uživatele správce

Nasazení Overleaf Toolkit:

{% code title="Overleaf Toolkit" overflow="wrap" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Nasazení staršího docker-compose.yml:

{% code title="Starší docker-compose" overflow="wrap" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Příkaz vytvoří uživatele se zadanou e-mailovou adresou, pokud ještě neexistuje, a udělá z něj správce. Výstup příkazu obsahuje adresu URL, na kterou můžete přejít a nastavit tomuto uživateli heslo a poprvé se přihlásit.

{% hint style="info" %}
Pro programatický přístup můžete stejný skript použít také k vytvoření běžných uživatelů i správců. U běžných uživatelů vynechte přepínač --admin.
{% endhint %}

Pokud používáte interní účty pro ověřování a potřebujete stávajícího uživatele povýšit na správce instance nebo mu odebrat oprávnění správce, proveďte následující:

{% stepper %}
{% step %}

### Přes administrační rozhraní

* Přihlaste se jako stávající správce.
* Klikněte na Admin -> Správa uživatelů.
* Vyhledejte uživatele a klikněte na jeho e-mailovou adresu.
* Sjeďte dolů do sekce Site Admin a klikněte na odkaz (show).
* Zaškrtněte políčko Is Site Admin.
* Klikněte na Uložit pro dokončení.
  {% endstep %}
  {% endstepper %}

***

## Mazání uživatelů

Jak je vysvětleno v našem průvodci na [pochopení využití licence](broken://pages/f830730eb361e67cc23e40a1ee3cb3365044e132), je obecně vhodné účty nemažat, pokud již nejsou potřeba. Smazání účtu odstraní účet a způsobí, že spolupracovníci ztratí přístup k projektům. V současnosti neexistuje způsob, jak účty deaktivovat — buď existují a jejich data jsou zachována, nebo jsou smazány.

Ve výchozím nastavení jsou účty mazány měkce. Informace o trvalém odstranění uživatelů z vaší instance viz `ENABLE_CRON_RESOURCE_DELETION` v [Proměnné prostředí](broken://pages/7032811494e0197360851b99088110b0a3cd1079) průvodce.

{% hint style="info" %}
Účty jsou ve výchozím nastavení mazány měkce. Viz `ENABLE_CRON_RESOURCE_DELETION` pro chování při trvalém smazání.
{% endhint %}

### Přes Admin -> Správa uživatelů

{% stepper %}
{% step %}

* Přihlaste se jako správce.
* Klikněte na Admin -> Správa uživatelů.
* Vyhledejte uživatele a zaškrtněte políčko vedle jeho e-mailové adresy.
* Klikněte na ikonu koše.
* Klikněte na Smazat pro potvrzení.
  {% endstep %}
  {% endstepper %}

### Přes příkazový řádek

Uživatelské účty (a jejich projekty) lze smazat pomocí následujících příkazů.

Nasazení Overleaf Toolkit:

{% code title="Overleaf Toolkit" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

Nasazení staršího docker-compose.yml:

{% code title="Starší docker-compose" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

{% hint style="danger" %}
Skript pro mazání používá pevně nastavenou možnost force, která zajistí pokračování mazání i v případě, že se e-mail o smazání účtu nepodaří odeslat (např. když e-mailová adresa uživatele již nefunguje).
{% endhint %}

{% hint style="info" %}
Od verze 5.5.0 lze použít možnost --skip-email, která zabrání odeslání informačního e-mailu smazanému uživateli.
{% endhint %}

***

## Obnovení měkce smazaného uživatele

Pokud byl uživatel pouze měkce smazán, můžete obnovit jeho účet a projekty.

{% stepper %}
{% step %}

* Přihlaste se jako správce.
* Klikněte na Admin -> Správa uživatelů.
* Vyhledejte uživatele, kterého chcete obnovit.
* Klikněte na tlačítko Zobrazit smazané uživatele.
* Klikněte na e-mailovou adresu smazaného uživatele.
* Klikněte na Obnovit tento účet.
* Klikněte na Obnovit pro potvrzení.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Když je ENABLE\_CRON\_RESOURCE\_DELETION nastaveno na true, účty smazané měkce lze obnovit v rámci 90denního okna. Po 90 dnech obnova účtu není možná.
{% endhint %}

***

## Počítání uživatelů

Počet uživatelů můžete získat přes administrační rozhraní na <https://you-instance-url/admin/user#license>. Pro programatické kontroly a exporty mohou pomoci následující příklady.

Celkový počet uživatelů:

{% code title="Celkový počet uživatelů" %}

```bash
echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 16
```

{% endcode %}

Celkový počet uživatelů pomocí koncového bodu metrik:

{% code title="Počet aktivních uživatelů z metrik" %}

```bash
docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users
# # HELP num_active_users num_active_users
# # TYPE num_active_users gauge
# num_active_users{app="web-api",host="b3ae4ff549d8"} 16
```

{% endcode %}

Celkový počet aktivních uživatelů (příklad: uživatelé aktivní za posledních 365 dní):

{% code title="Celkový počet aktivních uživatelů" %}

```bash
echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 10
```

{% endcode %}

***

## Aktualizace informací o uživatelském účtu

Způsob provádění aktualizací účtu závisí na tom, zda je povoleno SSO.

* Pokud se SSO nepoužívá:
  * Správci mohou upravovat informace o uživatelském účtu přes Admin -> Správa uživatelů (e-mail, jméno, příjmení a vygenerovat odkaz pro resetování hesla).
  * Běžní uživatelé mohou aktualizovat své údaje přes Účet -> Nastavení účtu (včetně změny hesla a generování ověřovacích tokenů Git).
* Pokud se používá SSO:
  * Server Pro lze nakonfigurovat tak, aby při přihlášení aktualizoval jméno a příjmení uživatele podle ověřovacího systému.
  * Když jsou OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN nebo OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN nastaveny na true, formulář s údaji uživatele na <https://your-instance-url/user/settings> je zakázán a jméno/příjmení lze nastavit pouze ve vašem systému správy identity.

Podrobnosti viz:

* Konfigurace SAML 2.0: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* Konfigurace LDAP: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

Aktualizováno před 4 měsíci

Tato dokumentační stránka obsahuje odkazy na externí průvodce a konfigurační stránky. Všechny odkazy a parametry dotazů jsou zachovány stejně jako v původním obsahu.


---

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