Коннектор Bitrix

Предварительные настройки в Битрикс

Для подключения коннектора Bitrix необходимо создать входящий вебхук. Входящий вебхук используется для работы с данными Bitrix через API.

Чтобы создать вебхук:

Перейдите в раздел Разработчикам (Приложения > Разработчикам, вкладка "Готовые сценарии" > Другое > Входящий вебхук).
В открывшейся форме укажите права доступа, разрешив выполнять запросы для работы с пользователями (user) и структуры компании (department).

В поле Вебхук для вызова rest api будет представлен образец URL, который будет использоваться в настройках коннектора IDM системы.

URL состоит из:
- test.bitrix.ru- адрес Битрикс;
- /rest - указание на то, что работа ведётся через rest с вебхуками
- /1 - идентификатор пользователя, создавшего вебхук
- /188gloryu42lvpjp - секретный код. Данный код является конфиденциальной информацией. Его необходимо держать в секрете.

Подробнее о создании вебхука на портале 1С–Битрикс Разработчикам.

Параметр	Обязательность	Описание
Название коннектора	Да	Название для отображения в интерфейсе системы IDM
Адрес сервиса	Да	Адрес системы 1С-Битрикс в формате https://{адрес Битрикс}/rest/{идентификатор пользователя, создавшего вебхук}
Токен авторизации	Да	Секретный код вебхука
Фильтр поиска	Нет	Фильтр поиска пользователей
Ограничить группой IDM	Нет	Синхронизация будет осуществляться только по тем пользователям, которые входят в состав выбранной группы
Лицензионный код	Да

Описание атрибутов профиля пользователя в Bitrix представлено в документации API.

Атрибут Trusted.IDM	Атрибут Bitrix
Логин (login)	ID
Имя (givenName)	NAME
Фамилия (surname)	LAST_NAME
Электронная почта (email)	E-Mail
Телефон (mobile)	PERSONAL_MOBILE
Организация (company)	WORK_COMPANY
Отдел (department)	UF_DEPARTMENT
Адрес проживания (streetAddress)
Должность (jobTitle)	PERSONAL_PROFESSION
СНИЛС (snils)
Фото (photo)	PERSONAL_PHOTO