Коннектор Bitrix#

• Настройки в Битрикс
• Создание коннектора
• Настройка парольной политики
• Настройка правил сопоставления
• Настройка синхронизации
• Включение коннектора

Настройки в Битрикс#

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

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

1. Перейдите в раздел Разработчикам (Приложения → Разработчикам, вкладка "Готовые сценарии" → Другое → Входящий вебхук).

2. В открывшейся форме укажите права доступа, разрешив выполнять запросы для работы с пользователями (user) и структуры компании (department).

   

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

   

   URL состоит из:

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

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

Создание коннектора#

В IDM необходимо создать коннектор по шаблону Bitrix.

Чтобы создать коннектор:

1. Перейдите в раздел Администрирование → Коннекторы.
2. Нажмите Создать коннектор.

3. В выпадающем меню выберите тип коннектора Bitrix.

   

4. Откроется форма создания коннектора.

5. На вкладке Параметры подключения укажите:

   • Название коннектора,
   • Адрес сервера,
   • Токен авторизации,
   • Фильтр поиска.

   📌 Подробное описание параметров приведено в разделе Параметры подключения

6. При необходимости выберите группу в блоке Ограничить группой IDM, если необходимо выполнять синхронизацию только по тем пользователям, которые входят в состав выбранной группы.

7. Введите ключ в поле Лицензионный код.

   📌 Подробнее про лицензирование читайте в инструкции.

8. Нажмите Сохранить.

💡 При необходимости выполните проверку подключения.

Параметры подключения#

Настройка парольной политики#

1. Перейдите на вкладку Пароли в форме с настройками коннектора.

2. При необходимости активируйте флаг Генерировать один пароль для новых пользователей на вкладке Пароли.

   💡 Система IDM позволяет установить единый пароль для пользователей, которые добавлены из внешней системы. Это означает, что пользователи смогут входить в системы, используя один и тот же пароль.

3. Введите пароль или нажмите на Сгенерировать для автоматического создания пароля в соответствии с парольными политиками IDM:

   Новый пароль должен содержать буквы латинского алфавита, не менее 8 знаков, в том числе не менее 1 цифры, не менее 1 буквы в верхнем регистре и не менее 1 специального символа (~!@-_#$).

   

   По кнопке Показать можно посмотреть сгенерированный пароль.

4. При необходимости активируйте флаг Запретить смену пароля в системе при изменении пароля в Trusted.IDM.

   💡 Система IDM позволяет установить запрет на изменение пароля в подключенной системе, если этот пароль был изменён в самой IDM.

5. Сохраните изменения.

Настройка правил сопоставления#

Общая информация#

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

Настройка правил#

📌 Значение поля должно быть уникальным в обеих системах.

Чтобы настроить сопоставление полей:

1. Перейдите на вкладку Сопоставление полей в форме с настройками коннектора.
2. Активируйте флаг в колонке Связать по напротив атрибута, который будет использоваться для сопоставления пользователей в системе IDM и во внешней системе.
3. Введите значение поля во внешней системе в колонке Внешнее поле.
4. Сохраните изменения.

Настройка синхронизации#

Порядок синхронизации#

📌 Если настроена одинаковая операция в обе стороны, то приоритетной будет внешняя система.

1. Перейдите на вкладку Правила синхронизации в форме с настройками коннектора.

2. Настройте порядок синхронизации.

   Установите флаг напротив необходимых пунктов:

   • В блоке 1 для настройки операций с пользователями и группами, которые будут выполняться в системе IDM в соответствии с данным из подключенной системы.

     • Создание,
     • Редактирование,
     • Удаление,
     • Комбинация правил.

   • В блоке 2 для настройки операций с пользователями и группами, которые будут выполняться в подключенной системе в соответствии с данным из системы IDM.

     • Создание,
     • Редактирование,
     • Удаление,
     • Комбинация правил.

   

3. При необходимости установите флаг Синхронизировать группы для выполнения синхронизации групп.

4. Настройте расписание синхронихзации:

   В блоке Настройки синхронизации установите флаг напротив одного из пунктов:

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

   

5. При необходимости установите флаг При изменении в Trusted.IDM для автоматического запуска синхронизации при возникновении изменений в IDM.

6. Сохраните изменения.

Включение коннектора#

После создания коннектор по умолчанию имеет статус Неактивен. Это означает, что синхронизация с внешней системой не выполняется.

Чтобы включить коннектор:

1. Перейдите в раздел Администрирование → Коннекторы.

2. Вызовите контекстное меню для коннектора, который необходимо включить, и выберите действие Включить или активируйте флаг Включить в форме редактирования коннектора.

3. Подтвердите действие в модальном окне.

   

После подтверждения действия:

• Коннектор изменит статус на Включен
• Будет автоматически запущена синхронизация данных с внешней системой в соответствии с заданными правилами синхронизации и расписанием.

💡 При необходимости синхронизацию можно запустить вручную через действие Синхронизировать в контекстном меню коннектора.