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

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

***

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

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

{% stepper %}
{% step %}

* Войдите как администратор.
* Нажмите Admin -> Manage 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 %}

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

{% 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 (электронную почту, имя, фамилию и генерировать ссылку для сброса пароля).
  * Обычные пользователи могут обновлять свои данные через 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://ayakaleaf-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.