Системный пользователь
Системный пользователь — это техническая учетная запись. Как и обычный сотрудник, в Битрикс24 он существует на уровне пользователя, но работником компании не является и нужен только для работы интеграций.
Вебхуки и приложения привязаны к конкретному сотруднику. Если этот сотрудник увольняется, интеграции могут перестать работать. Чтобы этого избежать, при увольнении сотрудника интеграции можно автоматически перенести на системного пользователя — они продолжат работать без изменений.
Для приложений системный пользователь также может создаваться при установке. После создания или повторной активации системного пользователя приложение получает событие ONAPPUSERREADY с авторизацией этого пользователя.
Как работает перенос
При увольнении сотрудника с активными вебхуками или приложениями открывается диалог выбора. Администратор выбирает один из двух вариантов:
- Уволить и отключить интеграции — вебхуки и приложения перестают работать.
- Уволить и сохранить интеграции — создается системный пользователь, все активные вебхуки и приложения переносятся на него.
Если сотрудник отредактирует вебхук, работающий от имени системного пользователя, вебхук автоматически переходит к этому сотруднику.
Типы системных пользователей
Существует два типа системных пользователей.
| Тип | Когда создается |
|---|---|
Для вебхуков RESOURCE_TYPE: WEBHOOK |
При переносе вебхуков уволенного сотрудника |
Для приложений RESOURCE_TYPE: APP |
При установке приложения или при переносе приложения из Маркетплейса |
При переносе интеграций системный пользователь наследует группы доступа уволенного сотрудника — вебхуки и приложения продолжают работать с теми же правами. Приложение работает с клоном пользователя, чьи токены авторизации оно использовало. Права сохраняются, перенос прозрачен для приложения.
При установке приложения системный пользователь создается один раз для этого приложения и существует, пока приложение установлено. Битрикс24 берет у сотрудника, который установил приложение, часовой пояс, язык и группы доступа. Повышенные роли установившего сотрудника не наследуются: в оргструктуре системный пользователь получает роль обычного сотрудника.
При удалении приложения системный пользователь деактивируется. Вместе с ним отключаются связанные интеграции: приложение и его вебхуки.
Для локальных приложений перенос на системного пользователя не поддерживается.
Параметры создаваемого пользователя
| Поле | Тип | Для вебхука | Для приложения |
|---|---|---|---|
NAME |
string | Имя уволенного сотрудника | Название приложения |
LAST_NAME |
string | Фамилия уволенного сотрудника | Пустая строка |
GROUP_ID |
array | Наследуется от оригинала | Наследуется от оригинала |
TIME_ZONE |
string | Наследуется от оригинала | Наследуется от оригинала |
LANGUAGE_ID |
string | Наследуется от оригинала | Наследуется от оригинала |
EXTERNAL_AUTH_ID |
string | rest_system |
rest_system |
ACTIVE |
boolean | true |
true |
Видимость системного пользователя
Системный пользователь — технический объект. Он не отображается в списке сотрудников и не находится через поиск в Битрикс24.
Методы user.get и user.search системного пользователя не возвращают, в том числе при фильтрации по полю EXTERNAL_AUTH_ID.
Отдельного метода для получения системного пользователя приложения нет. Приложение узнает его идентификатор и авторизационные данные из события ONAPPUSERREADY.