> 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/ru/upravlenie-polzovatelyami-i-proektami/user-management.md).

# Управление пользователями

## Создание пользователя-администратора

Развертывания 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 %}

Развертывания на устаревшем docker-compose.yml:

{% code title="Устаревший 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 %}

Команда создаст пользователя с указанным адресом электронной почты, если он ещё не существует, и сделает его администратором. В выводе команды будет URL, по которому можно перейти, чтобы задать пароль для этого пользователя и впервые войти в систему.

{% hint style="info" %}
Для программного подхода вы можете использовать тот же скрипт для создания обычных пользователей, а также администраторов. Для обычных пользователей опустите флаг --admin.
{% endhint %}

Если вы используете внутренние учетные записи для аутентификации и вам нужно повысить существующего пользователя до администратора экземпляра или отозвать права администратора, выполните следующее:

{% stepper %}
{% step %}

### Через интерфейс администратора

* Войдите как существующий администратор.
* Нажмите Admin -> Manage Users.
* Найдите пользователя и нажмите на его адрес электронной почты.
* Прокрутите вниз до раздела Site Admin и нажмите ссылку (show).
* Установите флажок Is Site Admin.
* Нажмите Save, чтобы завершить.
  {% endstep %}
  {% endstepper %}

***

## Удаление пользователей

Как объясняется в нашем руководстве по [пониманию использования лицензии](broken://pages/edd77350c12e1752f99e49a5abfaf5edcba4c1fe), обычно не рекомендуется удалять учетные записи, если они больше не нужны. Удаление учетной записи удаляет саму учетную запись и приводит к тому, что соавторы теряют доступ к проектам. В настоящее время нет способа деактивировать учетные записи — они либо существуют, и их данные сохраняются, либо удаляются.

По умолчанию учетные записи помечаются как удалённые. Информацию о том, как окончательно удалить пользователей из вашего экземпляра, см. `ENABLE_CRON_RESOURCE_DELETION` в [Переменные окружения](broken://pages/14e3a99831712fbed641777e9989c81f73f12a3c) в руководстве.

{% hint style="info" %}
По умолчанию учетные записи помечаются как удалённые. См. `ENABLE_CRON_RESOURCE_DELETION` о поведении при окончательном удалении.
{% endhint %}

### Через Admin -> Manage Users

{% stepper %}
{% step %}

* Войдите как администратор.
* Нажмите Admin -> Manage Users.
* Найдите пользователя и установите флажок рядом с его адресом электронной почты.
* Нажмите значок корзины.
* Нажмите Delete, чтобы подтвердить.
  {% endstep %}
  {% endstepper %}

### Через командную строку

Учетные записи пользователей (и их проекты) можно удалить с помощью следующих команд.

Развертывания 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 %}

Развертывания на устаревшем docker-compose.yml:

{% code title="Устаревший 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" %}
Скрипт удаления использует жестко заданную опцию force, которая гарантирует продолжение удаления, даже если не удается отправить письмо об удалении учетной записи (например, когда адрес электронной почты пользователя больше не обслуживается).
{% endhint %}

{% hint style="info" %}
Начиная с версии 5.5.0, можно использовать опцию --skip-email, чтобы не отправлять информационное письмо удалённому пользователю.
{% endhint %}

***

## Восстановление логически удалённого пользователя

Если пользователь был только логически удалён, вы можете восстановить его учетную запись и проекты.

{% stepper %}
{% step %}

* Войдите как администратор.
* Нажмите Admin -> Manage Users.
* Найдите пользователя, которого хотите восстановить.
* Нажмите кнопку Display deleted users.
* Нажмите на адрес электронной почты удалённого пользователя.
* Нажмите Recover This Account.
* Нажмите Recover, чтобы подтвердить.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Когда ENABLE\_CRON\_RESOURCE\_DELETION установлен в true, логически удалённые учетные записи можно восстановить в течение 90-дневного окна. По истечении 90 дней восстановление учетной записи невозможно.
{% endhint %}

***

## Подсчёт пользователей

Вы можете получить количество пользователей через интерфейс администратора по адресу <https://you-instance-url/admin/user#license>. Для программных проверок и экспорта могут помочь следующие примеры.

Общее число пользователей:

{% code title="Общее число пользователей" %}

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

{% endcode %}

Общее число пользователей, используя конечную точку метрик:

{% code title="Число активных пользователей из метрик" %}

```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 %}

Общее число активных пользователей (например: пользователи, активные за последние 365 дней):

{% code title="Общее число активных пользователей" %}

```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 %}

***

## Обновление информации об учетной записи пользователя

То, как выполняются обновления учетной записи, зависит от того, включен ли SSO.

* Если SSO не используется:
  * Администраторы могут изменять информацию учетной записи пользователя через Admin -> Manage Users (email, имя, фамилию и генерировать ссылку для сброса пароля).
  * Обычные пользователи могут обновлять свои данные через Account -> Account Settings (в том числе менять пароль и генерировать токены аутентификации Git).
* Если используется SSO:
  * Server Pro можно настроить так, чтобы при входе обновлялись имя и фамилия пользователя на основе системы аутентификации.
  * Когда OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN или OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN имеют значение true, форма данных пользователя на <https://your-instance-url/user/settings> отключается, и имя/фамилию можно задавать только в вашей системе управления идентификацией.

Для получения дополнительных сведений см.:

* Конфигурация SAML 2.0: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* Конфигурация LDAP: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

Последнее обновление 4 месяца назад

Эта страница документации содержит ссылки на внешние руководства и страницы конфигурации. Все ссылки и параметры запроса сохранены в том виде, в котором они представлены в исходном содержимом.


---

# 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/ru/upravlenie-polzovatelyami-i-proektami/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.