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

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

  • Статья

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

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

Чтобы настроить и настроить установленный Open LMS для работы с Microsoft Teams, выполните следующие действия:

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

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

Примечание.

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

Включение подключаемого модуля проверки подлинности 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 перенаправления для последующего использования.

Примечание.

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

Реквизиты

Зарегистрируйте Open LMS в качестве приложения в Microsoft Entra ID с помощью скрипта PowerShell. Скрипт подготавливает следующие элементы:

  • Новое приложение Microsoft Entra для клиента Microsoft 365, которое используется подключаемыми модулями Microsoft 365 Moodle.
  • Приложение для клиента Microsoft 365 настраивает необходимые URL-адреса ответа и разрешения для подготовленного приложения и возвращает AppID и Key.
  • В операционных системах, которые не являются Windows, следует зарегистрировать экземпляр Open LMS в Azure только вручную. Дополнительные сведения см. в разделе Важное оповещение ниже.

Важно!

Дополнительные сведения о регистрации экземпляра Open LMS вручную см. в статье Регистрация экземпляра Open LMS в качестве приложения.

После регистрации приложения убедитесь, что применяются все разрешения приложения Azure. Дополнительные сведения см. в статье Разрешения приложений Azure.

Регистрация приложения в Azure с помощью PowerShell

Шаг 1. Создание приложения 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. Например, откройте подключаемые модули LMS, Moodle или Moodle.
    4. При запросе введите URL-адрес сервера Open LMS.
    5. При запросе введите URL-адрес ответа, скопированный на странице конфигурации подключаемого модуля проверки подлинности OpenID Connect. Это URL-адрес сайта Open LMS, за которым следует \auth\oidc\.
    6. Вам может быть предложено войти в учетную запись Microsoft 365 еще раз во всплывающем окне процесса. Это необходимо для предоставления согласия администратора на разрешения, добавленные в приложение для вашей организации.
    7. После завершения выполнения скрипта скопируйте идентификатор приложения (AppID) и ключ приложения(Key), созданные скриптом, и сохраните их.

Шаг 2. Настройка сведений о приложении Azure в OpenID Connect

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

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

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

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

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

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

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

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

      Примечание.

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

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

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

    Примечание.

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

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

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

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

Примечание.

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

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

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

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

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