Подключение LMS
Как ИТ-служба подключает платформу к Moodle по LTI 1.3 — какие значения обменять, что включить и как проверить, что всё работает.
После подключения студенты и преподаватели попадают на платформу по ссылке из своего курса в LMS — без отдельного логина и без кода приглашения. Работает с любой LMS, которая поддерживает LTI 1.3: Moodle, Canvas, Blackboard. Ниже шаги для Moodle: на нём подключение проверено целиком — вход, состав группы и оценки в журнале.
Понадобятся права администратора Moodle и организатор потока на платформе: вы обмениваетесь значениями, каждый вписывает свои. Вместе это минут пятнадцать.
Способ входа по коду не отменяется
Подключение LMS добавляет второй вход рядом с кодом приглашения. Если что-то пойдёт не так, поток продолжает работать как раньше.
Шаг 1. Взять адреса у платформы
Организатор потока открывает на платформе «Организатору → Вход из LMS». В блоке «это вписывают в LMS» четыре адреса:
| на платформе | вид адреса |
|---|---|
| Tool URL | https://<адрес платформы>/course |
| Initiate login URL | https://<адрес платформы>/api/lti/login |
| Redirection URI | https://<адрес платформы>/api/lti/launch |
| Public keyset URL | https://<адрес платформы>/api/lti/jwks |
Адреса не секретные, их можно переслать почтой.
Шаг 2. Завести инструмент в Moodle
«Администрирование → Плагины → Модули деятельности → Внешний инструмент → Управление инструментами», затем «настроить инструмент вручную». Поля ниже названы так, как они подписаны в русском интерфейсе Moodle 5.
| поле в Moodle | что указать |
|---|---|
| Название инструмента | Disputa |
| Базовый URL-адрес инструмента | Tool URL |
| Версия LTI | LTI 1.3 |
| Тип открытого ключа | URL-адрес набора ключей |
| Открытый набор ключей | Public keyset URL |
| URL-адрес инициирования входа | Initiate login URL |
| URI перенаправления | Redirection URI |
| Показать при создании элементов | Показать в выборе элемента и как предварительно настроенный инструмент |
| Контейнер для запуска инструмента по умолчанию | Новое окно |
Контейнер — «Новое окно». Платформа открывается своей страницей, а не встраивается в страницу курса. Так и задумано: у преподавателя на защите вся ширина экрана, а не окошко внутри Moodle.
В разделе «Службы»:
| служба | значение | зачем |
|---|---|---|
| Службы заданий и оценок IMS LTI | Использовать эту службу для синхронизации оценок и управления столбцами | оценки попадают в журнал Moodle |
| Предоставление имен и ролей IMS LTI | Использовать эту службу для получения информации об участниках… | организатор видит, кто из группы ещё не дошёл до платформы |
В разделе «Секретность»:
| поле | значение | зачем |
|---|---|---|
| Определять полное имя пользователя, запускающего инструмент | Всегда | в составе группы видны фамилии, а не номера |
| Определять адрес электронной почты пользователя… | Никогда | платформе почта не нужна |
Сохраните инструмент.
Шаг 3. Передать ответ Moodle организатору
В списке инструментов у карточки Disputa откройте сведения о конфигурации. Moodle покажет шесть значений — подписи у них по-английски, так же, как на платформе:
- Platform ID
- ID клиента (на платформе — Client ID)
- Deployment ID
- Public keyset URL
- Access token URL
- Authentication request URL
Организатор вписывает их в блок «это LMS выдаёт в ответ» и сохраняет. Если значение не похоже на нужное — адрес не адрес, поле пустое, — платформа при сохранении назовёт поле. Значения тоже не секретные: это идентификаторы и адреса, по которым платформа узнаёт ваш Moodle.
Шаг 4. Проверить
- «проверить связь» на экране платформы: она запрашивает у Moodle открытые ключи, по которым потом проверяет каждый вход. Ответ «связка на месте» значит, что адрес Public keyset URL верный и Moodle отвечает.
- Элемент в курсе. Преподаватель добавляет в курс элемент «Внешний инструмент» и выбирает Disputa.
- Первый вход. Кто-нибудь из курса нажимает элемент — платформа открывается в новом окне.
- «состав группы» на экране платформы: сколько человек в курсе, сколько уже дошло и кто не дошёл поимённо. Работает после первого входа: адрес состава Moodle сообщает только при входе.
Что увидят студенты и преподаватели
- Студент нажимает элемент в курсе и попадает в свой поток. При первом входе один раз связывает учётную запись с GitHub — работы сдаются через репозитории, — дальше вход сразу.
- Преподаватель и администратор курса в Moodle получают на платформе роль проверяющего.
- Оценка уходит в журнал Moodle, только когда проверяющий подтвердил работу на платформе. В журнале появятся столбцы «Работа 1», «Работа 2» и так далее — по одному на работу, а не один на элемент курса. Предупредите преподавателей, иначе столбцы выглядят как чужие.
Если журнал Moodle не ответил, приёмка работы на платформе всё равно завершается: оценку можно перенести руками.
Если не заработало
| что видно | в чём дело |
|---|---|
| платформа открылась внутри страницы курса и не пускает | контейнер запуска не «Новое окно» — поменяйте в настройках инструмента |
| при сохранении платформа называет поле | значение скопировано не целиком или не из того инструмента |
| «проверить связь» не находит ключей | неверен Public keyset URL или Moodle недоступен с сервера платформы |
| вход отклоняется, хотя всё вписано верно | часы сервера Moodle ушли: пропуск входа проверяется по времени, включите синхронизацию времени (NTP) |
| состав группы не приходит | в курсе ещё никто не входил, или служба «Предоставление имен и ролей» не включена |
| оценки не появляются в журнале | не включена служба «Службы заданий и оценок», или работа ещё не подтверждена проверяющим |
Спецификация LTI 1.3 требует HTTPS: вузовский Moodle обычно так и работает, а на тестовом стенде без него могут не пройти вход и службы.
Не нашли ответа — напишите в Telegram, разберёмся по вашему Moodle.