Коннектор Moodle#
- Настройки в Moodle
- Создание коннектора
- Настройка парольной политики
- Настройка правил сопоставления
- Настройка синхронизации
- Включение коннектора
Настройки в Moodle#
Для настройки взаимодействия с системой Moodle необходимо получить токен.
🔍 Подробная информация по использованию ключей (токенов) размещена на портале Moodle.
- Перейдите на вкладку Администрирование → Сервер.
-
В разделе Веб-службы выберите Внешние службы.
Можно использовать веб-службу
Moodle mobile web service
, которая создана по умолчанию, либо можно создать новую веб-службу для Trusted IDM. -
После создания веб-службы для Trusted IDM необходимо выставить определенные разрешения. Для этого необходимо нажать на ссылку Функции для выбранной веб-службы.
-
В перечень функций веб-службы нужно добавить названия функций, которые фактически являются разрешениями на операции через REST API.
Название функции Описание действий core_cohort_add_cohort_members Adds cohort members. core_cohort_create_cohorts Creates new cohorts. core_cohort_delete_cohort_members Deletes cohort members. core_cohort_get_cohorts Returns cohort details. core_cohort_get_cohort_members Returns cohort members. core_course_get_categories Return category details core_group_get_groups Returns group details. core_session_touch Keep the users session alive. core_user_create_users Create users. core_user_delete_users Delete users. core_user_get_users Search for users matching the parameters. core_user_update_users Update users. core_webservice_get_site_info Return some site info / user info / list web service functions. Все эти функции должны быть добавлены в созданную веб-службу:
-
После завершения настройки веб-службы, необходимо перейти на страницу Управление протоколами. На странице требуется разрешить использование протокола REST (по умолчанию он может быть отключен)
-
Далее необходимо создать ключ (токен). Для этого нужно перейти на страницу Управление ключами и создать новый ключ.
📌 В качестве пользователя нужно указать существующего пользователя с правами администратора. Если при создании веб-службы был указан режим Авторизованные пользователи, то этого пользователя потребуется добавить в список зарегистрированных пользователей веб-сервиса.
-
Скопируйте созданный ключ.
Создание коннектора#
В IDM необходимо создать коннектор по шаблону Bitrix.
Чтобы создать коннектор:
- Перейдите в раздел Администрирование → Коннекторы.
- Нажмите Создать коннектор.
-
В выпадающем меню выберите тип коннектора Bitrix.
-
Откроется форма создания коннектора.
-
На вкладке Параметры подключения укажите:
- Название коннектора,
- Адрес сервера,
- Токен авторизации.
📌 Подробное описание параметров приведено в разделе Параметры подключения
-
При необходимости выберите группу в блоке Ограничить группой IDM, если необходимо выполнять синхронизацию только по тем пользователям, которые входят в состав выбранной группы.
-
Введите ключ в поле Лицензионный код.
📌 Подробнее про лицензирование читайте в инструкции.
-
Нажмите Сохранить.
💡 При необходимости выполните проверку подключения.
Параметры подключения#
Параметр | Обязательность | Описание |
---|---|---|
Название коннектора | Да | Название для отображения в интерфейсе системы IDM |
Адрес сервиса | Да | Адрес системы Moodle в формате https://{адрес Moodle}/ webservice/rest/server.php |
Токен авторизации | Да | Ключ, созданный в Moodle |
Фильтр поиска | Нет | Фильтр поиска пользователей |
Ограничить группой IDM | Нет | Синхронизация будет осуществляться только по тем пользователям, которые входят в состав выбранной группы |
Лицензионный код | Да | - |
Настройка парольной политики#
- Перейдите на вкладку Пароли в форме с настройками коннектора.
-
При необходимости активируйте флаг Генерировать один пароль для новых пользователей на вкладке Пароли.
💡 Система IDM позволяет установить единый пароль для пользователей, которые добавлены из внешней системы. Это означает, что пользователи смогут входить в системы, используя один и тот же пароль.
-
Введите пароль или нажмите на Сгенерировать для автоматического создания пароля в соответствии с парольными политиками IDM:
Новый пароль должен содержать буквы латинского алфавита, не менее 8 знаков, в том числе не менее 1 цифры, не менее 1 буквы в верхнем регистре и не менее 1 специального символа (~!@-_#$).
По кнопке Показать
можно посмотреть сгенерированный пароль.
-
При необходимости активируйте флаг Запретить смену пароля в системе при изменении пароля в Trusted.IDM.
💡 Система IDM позволяет установить запрет на изменение пароля в подключенной системе, если этот пароль был изменён в самой IDM.
-
Сохраните изменения.
Настройка правил сопоставления#
Общая информация#
🔍 Описание атрибутов профиля пользователя в системе Moodle представлено в документации.
Стандартные параметры привязки полей представлены в таблице:
Атрибут Trusted.IDM | Атрибут Moodle |
---|---|
Логин (login) | username |
Имя (givenName) | firstname |
Фамилия (surname) | lastname |
Электронная почта (email) | |
Телефон (mobile) | phone2 |
Организация (company) | institution |
Отдел (department) | department |
Адрес проживания (streetAddress) | address |
Должность (jobTitle) | |
СНИЛС (snils) | idnumber |
Фото (photo) |
При настройке сопоставления полей нужно понимать, что корректная передача данных возможна, если на стороне Moodle в API веб-сервиса будут реализованы функции, обеспечивающие получение и отдачу соответствующих данных. Например, передачу фото аватара пользователя невозможно организовать в Moodle при текущем состоянии API, поскольку там не реализована функция загрузки и сохранения изображения, но в обратную сторону (из Moodle в Trusted IDM) эта передача вполне возможна.
Настройка правил#
📌 Значение поля должно быть уникальным в обеих системах.
Чтобы настроить сопоставление полей:
- Перейдите на вкладку Сопоставление полей в форме с настройками коннектора.
- Активируйте флаг в колонке Связать по напротив атрибута, который будет использоваться для сопоставления пользователей в системе IDM и во внешней системе.
- Введите значение поля во внешней системе в колонке Внешнее поле.
- Сохраните изменения.
Настройка синхронизации#
Порядок синхронизации#
📌 Если настроена одинаковая операция в обе стороны, то приоритетной будет внешняя система.
- Перейдите на вкладку Правила синхронизации в форме с настройками коннектора.
-
Настройте порядок синхронизации.
Установите флаг напротив необходимых пунктов:
-
В блоке 1 для настройки операций с пользователями и группами, которые будут выполняться в системе IDM в соответствии с данным из подключенной системы.
-
В блоке 2 для настройки операций с пользователями и группами, которые будут выполняться в подключенной системе в соответствии с данным из системы IDM.
-
-
При необходимости установите флаг Синхронизировать группы для выполнения синхронизации групп.
-
Настройте расписание синхронихзации:
В блоке Настройки синхронизации установите флаг напротив одного из пунктов:
- При выборе Каждые укажите промежуток времени в минутах или часах,
- При выборе Ежедневно введите время в формате чч:мм или выберите значение из выпадающего меню,
- При выборе Еженедельно укажите день недели и время в формате чч:мм или выберите значение из выпадающего меню,
-
При необходимости установите флаг При изменении в Trusted.IDM для автоматического запуска синхронизации при возникновении изменений в IDM.
- Сохраните изменения.
Включение коннектора#
После создания коннектор по умолчанию имеет статус Неактивен. Это означает, что синхронизация с внешней системой не выполняется.
Чтобы включить коннектор:
- Перейдите в раздел Администрирование → Коннекторы.
-
Вызовите контекстное меню для коннектора, который необходимо включить, и выберите действие Включить или активируйте флаг Включить в форме редактирования коннектора.
-
Подтвердите действие в модальном окне.
После подтверждения действия:
- Коннектор изменит статус на Включен
- Будет автоматически запущена синхронизация данных с внешней системой в соответствии с заданными правилами синхронизации и расписанием.
💡 При необходимости синхронизацию можно запустить вручную через действие Синхронизировать в контекстном меню коннектора.