Перейти к содержанию

Коннектор Moodle#


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

Для настройки взаимодействия с системой Moodle необходимо получить токен.

🔍 Подробная информация по использованию ключей (токенов) размещена на портале Moodle.

  1. Перейдите на вкладку АдминистрированиеСервер.
  2. В разделе Веб-службы выберите Внешние службы.

    Можно использовать веб-службу Moodle mobile web service, которая создана по умолчанию, либо можно создать новую веб-службу для Trusted IDM.

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

  3. После создания веб-службы для Trusted IDM необходимо выставить определенные разрешения. Для этого необходимо нажать на ссылку Функции для выбранной веб-службы.

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

  4. В перечень функций веб-службы нужно добавить названия функций, которые фактически являются разрешениями на операции через 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.

    Все эти функции должны быть добавлены в созданную веб-службу:

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

  5. После завершения настройки веб-службы, необходимо перейти на страницу Управление протоколами. На странице требуется разрешить использование протокола REST (по умолчанию он может быть отключен)

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

  6. Далее необходимо создать ключ (токен). Для этого нужно перейти на страницу Управление ключами и создать новый ключ.

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

    📌 В качестве пользователя нужно указать существующего пользователя с правами администратора. Если при создании веб-службы был указан режим Авторизованные пользователи, то этого пользователя потребуется добавить в список зарегистрированных пользователей веб-сервиса.

  7. Скопируйте созданный ключ.

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


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

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

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

  1. Перейдите в раздел АдминистрированиеКоннекторы.
  2. Нажмите Создать коннектор.
  3. В выпадающем меню выберите тип коннектора Bitrix.

    Выбор типа коннектора

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Настройки коннектора

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

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

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

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


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

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

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

Стандартные параметры привязки полей представлены в таблице:

Атрибут Trusted.IDM Атрибут Moodle
Логин (login) username
Имя (givenName) firstname
Фамилия (surname) lastname
Электронная почта (email) email
Телефон (mobile) phone2
Организация (company) institution
Отдел (department) department
Адрес проживания (streetAddress) address
Должность (jobTitle)
СНИЛС (snils) idnumber
Фото (photo)

При настройке сопоставления полей нужно понимать, что корректная передача данных возможна, если на стороне Moodle в API веб-сервиса будут реализованы функции, обеспечивающие получение и отдачу соответствующих данных. Например, передачу фото аватара пользователя невозможно организовать в Moodle при текущем состоянии API, поскольку там не реализована функция загрузки и сохранения изображения, но в обратную сторону (из Moodle в Trusted IDM) эта передача вполне возможна.

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

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

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

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

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

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

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

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

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

    Настройки коннектора

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

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

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

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

    Настройки коннектора

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

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

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

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

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

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

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

    Окно подтверждения

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

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