Системный пользователь
Системный пользователь — это техническая учетная запись. Как и обычный сотрудник, в Битрикс24 он существует на уровне пользователя, но работником компании не является и нужен только для работы интеграций.
Вебхуки и приложения привязаны к конкретному сотруднику. Если этот сотрудник увольняется, интеграции могут перестать работать. Чтобы этого избежать, при увольнении сотрудника интеграции можно автоматически перенести на системного пользователя — они продолжат работать без изменений.
Как работает перенос
При увольнении сотрудника с активными вебхуками или приложениями открывается диалог выбора. Администратор выбирает один из двух вариантов:
- Уволить и отключить интеграции — вебхуки и приложения перестают работать.
- Уволить и сохранить интеграции — создается системный пользователь, все активные вебхуки и приложения переносятся на него.
Если сотрудник отредактирует вебхук, работающий от имени системного пользователя, вебхук автоматически переходит к этому сотруднику.
Типы системных пользователей
Существует два типа системных пользователей.
| Тип | Когда создается |
|---|---|
Для вебхуков RESOURCE_TYPE: WEBHOOK |
При переносе вебхуков уволенного сотрудника |
Для приложений RESOURCE_TYPE: APP |
При переносе приложения из Маркетплейса |
Системный пользователь наследует группы доступа уволенного сотрудника — вебхуки и приложения продолжают работать с теми же правами. Приложение работает с клоном пользователя, чьи токены авторизации оно использовало. Права сохраняются, перенос прозрачен для приложения.
Для локальных приложений перенос на системного пользователя не поддерживается.
Параметры создаваемого пользователя
| Поле | Тип | Для вебхука | Для приложения |
|---|---|---|---|
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.