Поделиться через

Настройка подключаемых модулей Moodle LMS

  • Статья

Из этой статьи вы узнаете, как установить и настроить подключаемые модули Moodle LMS для интеграции Microsoft Teams с интерфейсом Moodle.

Предварительные требования

Ниже приведены предварительные требования для настройки установленного Moodle для работы с Microsoft Teams:

  • Учетные данные администратора Moodle.
  • Microsoft Entra учетные данные администратора.
  • Подписка Azure, в которой можно создавать новые ресурсы.

1. Установите подключаемые модули Microsoft 365 Moodle

Интеграция Moodle с Microsoft Teams осуществляется на основе набора подключаемых модулей Microsoft 365 Moodle открытый код.

Необходимые приложения и подключаемые модули

Скачайте и установите следующие элементы:

  1. Текущая стабильная версия Moodle.

    Важно!

    Если у вас нет сайта Moodle, перейдите в репозиторий Moodle в Azure и быстро разверните экземпляр Moodle и настройте его в соответствии со своими потребностями.

  2. Скачайте и сохраните подключаемые модули Moodle OpenID Connect и интеграции с Microsoft 365 на локальном компьютере.

    Примечание.

    Для интеграции с Teams требуется установка подключаемых модулей OpenID Connect и интеграции с Microsoft 365.

    Кроме того, рекомендуется установить подключаемый модуль темы Microsoft 365 Teams .

Установка подключаемых модулей

  1. Скачайте подключаемые модули, извлеките их и отправьте в соответствующие папки.
    • Извлеките подключаемый модуль OpenID Connect (auth_oidc) в папку с именем oidc и отправьте в папку проверки подлинности корневого каталога документа Moodle.
    • Извлеките подключаемый модуль интеграции Microsoft 365 (local_o365) в папку с именем o365 и отправьте в локальную папку корневого каталога документов Moodle.
  2. Войдите на сайт Moodle в качестве администратора и выберите Администрирование сайта.
  3. После обнаружения новых подключаемых модулей, которые необходимо установить, Moodle перенаправляет вас на страницу установки новых подключаемых модулей. Если этого не происходит, на странице Администрирование сайта выберите Уведомления на вкладке Общие . Это действие должно активировать установку подключаемых модулей.
  4. После установки новых подключаемых модулей Moodle отобразит страницу со всеми новыми конфигурациями из установленных подключаемых модулей. Эту страницу можно спокойно пропустить, применив параметры по умолчанию. Подключаемые модули будут настроены на следующих шагах.

2. Включение подключаемого модуля проверки подлинности OpenID Connect

Чтобы подключаемые модули Moodle взаимодействовали со службами Майкрософт, необходимо включить и настроить подключаемый модуль проверки подлинности OpenID Connect.

  1. Перейдите в разделПроверка подлинностиподключаемых> модулей администрирования> сайта и выберите Управление проверкой подлинности.

  2. Найдите подключаемый модуль проверки подлинности OpenID Connect и щелкните значок глаза , чтобы включить его.

  3. Выберите Параметры для подключаемого модуля, чтобы проверить конечные точки авторизации и маркера .

    1. Значения по умолчанию должны быть следующими:
      1. Конечная точка авторизации: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Конечная точка токена: https://login.microsoftonline.com/common/oauth2/token.

  4. Запишите URI перенаправления для последующего использования.

    Примечание.

    Он не требуется для всех пользователей Moodle в качестве метода проверки подлинности с помощью подключаемого модуля проверки подлинности OpenID Connect. Однако если они используют другие методы проверки подлинности, их учетные записи Moodle должны быть подключены к соответствующим учетным записям Майкрософт, прежде чем они смогут использовать определенные функции в интеграции Teams, такие как синхронизация владения и членства в Teams.

3. Настройка подключения между подключаемыми модулями Microsoft 365 и службами Майкрософт

Прежде чем они смогут работать вместе, необходимо настроить подключение между подключаемыми модулями Microsoft 365 и службами Майкрософт.

Примечание.

При настройке интеграции оставьте страницу конфигурации Microsoft 365 Moodle Integration открытой на отдельной вкладке браузера, так как вам нужно вернуться к этому набору страниц на протяжении всего процесса.

Создание приложения Azure

  1. Перейдите в раздел Администрирование> сайтаПодключаемые> модулиЛокальные подключаемые модули и выберите Интеграция Microsoft 365. Откроется страница конфигурации интеграции с Microsoft 365.

  2. На странице Конфигурация интеграции с Microsoft 365 выберите вкладку Настройка .

  3. Нажмите кнопку Скачать сценарий PowerShell и сохраните его в ВИДЕ ZIP-папки на локальном компьютере.

    Примечание.

    При выполнении сценария создается новое приложение Microsoft Entra в клиенте Microsoft 365, которое настраивает необходимые URL-адреса и разрешения ответа, предоставляет необходимые разрешения и возвращает AppID и Key.

    Сценарий PowerShell работает только в операционных системах Windows.

  4. Подготовьте сценарий PowerShell из ZIP-файла следующим образом:

    1. Скачайте и извлеките Moodle-AzureAD-Powershell.zip файл.
    2. Откройте извлеченную папку.
    3. Щелкните файл правой Moodle-AzureAD-Script.ps1 кнопкой мыши и выберите Пункт Свойства.
    4. На вкладке Общие окно свойств установите Unblock флажок рядом с атрибутом Безопасность, расположенным в нижней части окна.
    5. Нажмите ОК.
    6. Скопируйте путь к каталогу в извлеченную папку.

  5. Запустите PowerShell от имени администратора:

    1. В Windows нажмите кнопку Пуск.
    2. Тип PowerShell.
    3. Щелкните правой кнопкой мыши Windows PowerShell.
    4. Выберите Запуск от имени администратора.

  6. Перейдите в распакованный каталог, введя cd .../.../Moodle-AzureAD-Powershell , где .../... — путь к каталогу.

  7. Выполните сценарий PowerShell:

    1. Введите ./Moodle-AzureAD-Script.ps1.
    2. При появлении запроса войдите в учетную запись администратора Microsoft 365 во всплывающем окне.
    3. При появлении запроса введите имя Microsoft Entra приложения, например Подключаемые модули Moodle или Moodle.
    4. При появлении запроса введите URL-адрес сервера Moodle.
    5. При запросе введите URL-адрес ответа, скопированный на странице конфигурации подключаемого модуля проверки подлинности OpenID Connect. По сути, это URL-адрес вашего сайта Moodle, за которым следует \auth\oidc\.
    6. Вам может быть предложено войти в учетную запись Microsoft 365 еще раз во всплывающем окне процесса. Это необходимо для предоставления согласия администратора на разрешения, добавленные в приложение для вашей организации.
    7. После завершения выполнения скрипта скопируйте идентификатор приложения (AppID) и ключ приложения(Key), созданные скриптом, и сохраните их.

Настройка сведений о приложении Azure в Moodle

  1. Вернитесь на страницу конфигурации подключаемого модуля проверки подлинности OpenID Connect.
  2. AppID Вставьте значение в поле Идентификатор приложения, а Key значение — в поле Ключ, а затем выберите Сохранить изменения.

Настройка подключения между подключаемыми модулями Майкрософт и службами Майкрософт

  1. На странице Конфигурация интеграции с Microsoft 365 выберите вкладку Настройка .
  2. В разделе Выбор метода подключения выберите Доступ к приложению, а затем снова нажмите кнопку Сохранить изменения .
  3. После обновления страницы вы увидите еще один новый раздел Администратор согласия & дополнительные сведения.
    1. Выберите ссылку Предоставить Администратор согласие, введите учетные данные глобального администратора Microsoft 365, а затем примите, чтобы предоставить разрешения.
    2. Рядом с полем клиента Microsoft Entra нажмите кнопку Обнаружить.
    3. Рядом с URL-адресом OneDrive для бизнеса нажмите кнопку Обнаружить.
    4. После заполнения полей снова нажмите кнопку Сохранить изменения .
  4. Нажмите кнопку Обновить , чтобы проверить установку. Если на этом этапе не сообщается об ошибке, это означает, что подключаемые модули Майкрософт могут взаимодействовать с сервером Майкрософт через API Microsoft Graph.

Настройка синхронизации пользователей и курсов

  1. Синхронизация пользователей между сервером Moodle и Microsoft Entra ID. В зависимости от среды на этом этапе можно выбрать различные параметры. Для начала сделайте следующее:

    1. На странице Конфигурация интеграции с Microsoft 365 выберите вкладку Параметры синхронизации .

    2. В параметре Синхронизация пользователей с Microsoft Entra ID установите флажки, которые применяются к вашей среде. Необходимо выбрать следующие параметры:
      ✔ Создание учетных записей в Moodle для пользователей в Microsoft Entra ID. ✔ Обновите все учетные записи в Moodle для пользователей в Microsoft Entra ID.

    3. В разделе Ограничение для создания пользователей можно настроить фильтр для ограничения Microsoft Entra пользователей, синхронизированных с Moodle.

    Примечание.

    Не требуется включать синхронизацию пользователей; однако это значительно упростит подключение пользователей Moodle с учетными записями Microsoft 365.

    Синхронизация пользователей выполняется путем запуска запланированной задачи Синхронизация пользователей с Microsoft Entra ID.

  2. В разделе Синхронизация курсов можно выбрать параметр настройки синхронизации курсов , чтобы включить автоматическое создание Teams для некоторых или всех существующих курсов Moodle.

    Примечание.

    Синхронизация курсов выполняется путем выполнения запланированной задачи синхронизации курсов Moodle с Microsoft Teams .

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

  4. Чтобы проверить конфигурацию синхронизации, необходимо запустить запланированные задачи вручную в первый раз, перейдите в разделЗадачи>сервера>администрирования> сайтаЗапланированные задачи.

    1. Прокрутите вниз, найдите задачу Синхронизация пользователей с Microsoft Entra ID и выберите Запустить сейчас.
      1. Это приведет к синхронизации Microsoft Entra пользователей с сайтом Moodle в соответствии с параметрами синхронизации пользователей.
    2. Затем найдите задачу Синхронизация курсов Moodle с Microsoft Teams и выберите Запустить сейчас.
      1. Эта задача создаст группы для всех курсов Moodle с включенным параметром синхронизации, а также Teams, если владелец команды можно найти в курсе.
      2. Задача также будет синхронизировать пользователей Moodle, зарегистрированных в курсе, с Teams в качестве владельцев или участников.
        1. Владелец команды — это пользователь Moodle, который
          1. подключен к учетной записи Microsoft 365, и
          2. регистрируется в курсе, AND
          3. local/o365:teamowner имеет возможность в контексте курса.
        2. Аналогичным образом участником команды является пользователь Moodle, который
          1. подключен к учетной записи Microsoft 365, и
          2. регистрируется в курсе, AND
          3. local/o365:teamember имеет возможность в контексте курса.
        3. Роль преподавателя по умолчанию имеет local/o365:teamowner возможность, а роль Учащийся по умолчанию — local/o365:teammember возможность.

Примечание.

Запланированные задачи активируются Moodle Cron, которое необходимо настроить для частого выполнения. Каждая запланированная задача может иметь расписание по умолчанию, которое можно настроить.

  • Расписание по умолчанию для задачи Синхронизация пользователей с Microsoft Entra ID составляет каждую минуту.
  • Расписание по умолчанию для задачи синхронизации курсов Moodle с Microsoft Teams ежедневно в 1:00 в часовом поясе сервера Moodle по умолчанию.

После установки и настройки подключаемых модулей вы можете:

Документация по дополнительному модулю Moodle

Если вы хотите ознакомиться с руководствами по интеграции Moodle с Microsoft 365 и заметками о выпуске, ознакомьтесь со следующими ресурсами: