Настройка интеграции #751

Просмотров: 52

Вашу панель администрирования jango можно найти после установки по адресу: ваш сервер/admin

Интеграция с Moodle (Simple plugin)

Новый тип плагина Examus для Moodle работает с API как обычная Simple-интеграция.

В начале работы с данным видом интеграции устанавливается плагин Examus availability_examus2 для Moodle. Если ранее была Moodle интеграция на старом плагине, нужно обязательно перед установкой нового удалить старые OAuth provider local_oauth и availability_examus. При интеграции происходит связка между Moodle и системой «Экзамус», при которой пользователь при попытке пройти назначенный ему тест в системе заказчика (LMS) перенаправляется в «Экзамус» с помощью специальной ссылки, внутри которой с помощью JWT-токена зашифрована ссылка на тест и другая информация о студенте, назначенном ему экзамене, дате проведения, почты, ФИО и т.д.
Перед началом интеграции убедитесь, что:
1. Сайт разрешает встраивание в IFrame.
2. Сайт переведён на HTTPS и имеет полный SSL-сертификат.
3. Сайт имеет атрибуты SameSite=None; Secure=True для успешного сохранения состояния авторизации в IFrame. Версия Moodle подходящая. Список версий, совместимых с плагином Экзамус, в которых отсутствует проблема с cookie:
3.8.2+
3.9+
3.10+
4.0+

Добавить в django-админке на Simple-интеграцию:

Ввести данные:

Friendly name - название ВУЗ`а или клиента, необходимо для отличия.
Name (или integration_name) - имя интеграции Важно уникальное название, чтобы не возникало конфликта с другими интеграциями.
User group - аналогично Name.
Review api url - адрес, на который будут отправляться результаты прокторинга (ревью). Обратите внимание, что Moodle URL может быть не обязательно основной страницей домена вида https://example.com и возможен вариант, когда Moodle является подразделом сайта, вида https://example.com/lms. Создаётся по маске: review_url: [URL]/availability/condition/examus2/api.php?method=review
Schedule api url - адрес, на который передается информация о событиях записи и отмены записи на экзамен.Обратите внимание, что Moodle URL может быть не обязательно основной страницей домена вида https://example.com и возможен вариант, когда Moodle является подразделом сайта, вида https://example.com/lms. Создаётся по маске: shedule_url: [URL]/availability/condition/examus2/api.php?method=schedule
Secret Key (или jwt_secret) - секретный ключ шифрования. Необходимо самостоятельно сгенерировать 32 случайных символа. Можно пользоваться веб-сервисом: https://www.lastpass.com/password-generator

Выбрать способ захода:

Webapp url - адрес webapp'а, на котором будет сдаваться тест. Например, https://student.examus.net. Основной способ сдачи - webapp. Остальные режимы прописываются ситуативно.
LDB mode- режимы Lock Down Browser`браузеров.
- Disable - выключен,
- Enable - открывается, если от клиента приходит флаг "ldb" в JWT (включен параметр Использовать защищенный браузер в Moodle)
- Force - открыть принудительно (всегда будет открываться)
LDB browser - какой браузер открывается.
Active Browser - приложение Examus. Если включен режим Active Browser, то поле Webapp url также должно быть заполнено.
Respondus - Respondus.
SEB - Safe Exam Browser.
Active Browser security level - уровень защиты - Basic или High.
Allow mobile devices - если необходимо включить сдачу с мобильных устройств. Дополнительно должно быть включено в веб-приложении: Работа с мобильными устройствами
Biometric identification provider - провайдер биоидентфикации.

После настройки в карточке интеграции использовать три параметра из настроенной в django-админки карточки:

examus_url - домен сервера Examus.
integration_name - Name в django-админке.
jwt_secret - Secret Key в django-админке.

Эти параметры прописываются в Moodle по пути: Администрирование → Плагины → Ограничения доступности → Прокторинг “Экзамус”.

После настройки интеграции, использую учётную запись, протестировать общую работоспособность интеграции.

Тестирование интеграции

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

Создание учётной записи администратора, проктора

Необходимо создать учётные записи администратора и проктора, в зависимости от типа прокторинга.

Интеграция по API

Интеграция по API представляет собой связку между LMS и системой «Экзамус», при которой пользователь при попытке пройти назначенный ему тест в системе заказчика (LMS) перенаправляется в «Экзамус» с помощью специальной ссылки, внутри которой с помощью JWT-токена зашифрована ссылка на тест и другая информация о студенте, назначенном ему экзамене, дате проведения, почты, ФИО и т.д.

Перед началом интеграции убедитесь, что:

Сайт разрешает встраивание в IFrame.
Сайт переведён на HTTPS и имеет полный SSL-сертификат.
Сайт имеет атрибуты SameSite=None; Secure=True для успешного сохранения состояния авторизации в IFrame.
Обязательно протестировать полный путь.

Добавить в django-админке на Simple-интеграцию:

Ввести данные

Friendly name - название ВУЗ`а или клиента, необходимо для отличия.
Name (или integration_name) - имя интеграции, из которого будет присваиваться название компании. Важно уникальное название, чтобы не возникало конфликта с другими интеграциями, в т.ч с Moodle-интеграцией.
User group - аналогично Name.
Review api url - адрес, на который будут отправляться результаты прокторинга (ревью).
Secret Key (или jwt_secret) - секретный ключ шифрования. Необходимо самостоятельно сгенерировать 32 случайных символа.

Выбрать способ захода:

Biometric identification provider - провайдер биоидентфикации.
- Examus - наша идентификация по фотографии из Moodle.
- Luna - VisionLabs. Идентификация по фотографию паспорта и фотографии лица.
- EBS - идентификация по биометрии ЕБС.

После настройки в карточке интеграции применить на платформе тестирования параметры из настроенной в django-админки карточки:

examus_url - домен сервера Examus. Например, moon.examus.net

integration_name - Name в django-админке.

jwt_secret - Secret Key в django-админке.

После настройки интеграции, используя учётную запись тестируемого, протестировать общую работоспособность интеграции.