TrustExam ProctoringИнтеграция с Moodle
Интеграция с платформой TrustExam

Прокторинг для Moodle

Два готовых плагина подключают онлайн-прокторинг к тестам Moodle. Программировать не нужно: установите плагины, укажите домен и ключ, включите прокторинг для теста.

Обзор

Порядок действий

Шесть шагов от установки до первого отчёта. Подробности — в разделах ниже.

1

Скачайте два архива из комплекта поставки.

2

Установите оба плагина через «Установку плагинов» Moodle.

4

Включите способ входа «Proctoring Auth Keys» и поднимите его наверх списка.

5

В тесте создайте задание и включите прокторинг на платформе.

6

Студенты проходят тест, отчёты появляются на платформе.

Схема

Последовательность взаимодействия

ПОДГОТОВКА один раз на тест ЗАПУСК ЭКЗАМЕН ЗАВЕРШЕНИЕ Одна вкладка в браузере студента Moodle сайт + плагины прокторинга TrustExam API api.trustexam.ai Приложение прокторинга app.trustexam.ai Студент браузер создать задание кнопка в настройках теста настройки прокторинга меняются на платформе открывает тест создать сессию Secret Key ссылка на сессию кнопка «Запустить прокторинг» переход по ссылке проверка камеры и экрана идентификация студента открывает тест в своём окне вход без пароля — одноразовый ключ видео · экран · нарушения пока студент отвечает на вопросы «Отправить всё и завершить тест» тест сдан попытка закрыта возврат в Moodle отчёт на платформе видео, нарушения, оценка риска
ваш Moodle TrustExam студент — стрелка: запрос или ответ рамка: одна вкладка браузера
Подготовка делается один раз на тест: задание создаётся кнопкой в Moodle, прокторинг включается и настраивается на платформе. Дальше всё автоматически — Moodle сам получает ссылку на сессию, студент проходит проверку в приложении прокторинга, и тест открывается прямо в его окне. После сдачи студент возвращается в Moodle, отчёт остаётся на платформе.
Каждый запуск теста — новая сессия прокторинга: перезапуски не смешиваются в одном отчёте.
Установка

Комплект поставки

Два архива плагинов и данные для подключения.

oqylyq-moodle-5.2-sdk-embed.zip
Основной плагин: прокторинг в тестах, контроль доступа к попытке.
Скачать
oqylyq-moodle-auth.zip
Вспомогательный плагин: вход студента в тест без повторного ввода пароля.
Скачать
Домен и Secret Key
Домен — trustexam.ai или oqylyq.kz. Secret Key выдаётся вместе с архивами.
Куда вводить
Одна сборка на все версии Moodle 3.6–5.2 — выбирать архив под свою версию не нужно.
Secret Key — это секрет. Он даёт доступ к прокторингу от имени вашей организации: не публикуйте его и не пересылайте по открытым каналам.
Установка

Требования

ТребованиеЧто нужно
Версия Moodle3.6–5.2
ПраваАдминистратор сайта Moodle
Адрес сайтаОткрывается из интернета и работает по HTTPS — без него браузер не даст камеру и экран
Встраивание во фреймВключено: Site administration → Security → HTTP security → «Allow frame embedding»
Элемент курсаПрокторинг подключается к элементу «Тест»
Установка

Установка плагинов

Сначала установите oqylyq-moodle-5.2-sdk-embed.zip, затем теми же шагами — oqylyq-moodle-auth.zip.

1

Войдите администратором

Вход в панель администратора Moodle
Панель администрирования
2

Откройте установку плагинов

Администрирование → Плагины → «Install plugins».

Раздел Plugins и ссылка Install plugins
3

Выберите файл

Нажмите «Выбрать файл».

Кнопка выбора файла на странице установки плагина
4

Загрузите архив

«Upload a file» → выберите архив → «Upload this file».

Окно выбора файла: Upload a file, Upload this file
5

Запустите установку

Нажмите «Install plugin from the ZIP file».

Кнопка Install plugin from the ZIP file
6

Дождитесь проверки

Если проверка прошла — «Continue».

Результат проверки плагина и кнопка Continue
7

Обновите базу данных

Нажмите «Upgrade Moodle database now». Установка завершена.

Кнопка Upgrade Moodle database now
Повторите шаги 2–7 для второго архива — oqylyq-moodle-auth.zip.
Установка

Подключение

После установки основного плагина Moodle откроет страницу его настроек. Позже её можно найти в Администрирование → Плагины → Правила доступа к тесту → Proctoring Access Rules.

Настройки плагина: домен стенда и Secret Key
ПолеЧто указать
Домен стенда прокторингаtrustexam.ai или oqylyq.kz
Secret KeyКлюч из комплекта поставки
API URLОставьте пустым. Если вас попросили его указать: https://api.trustexam.ai/api или https://api.oqylyq.kz/api
Proxy URLОставьте пустым. Нужен, только если сервер Moodle выходит в интернет через прокси
Embed modeОставьте «Редирект + iframe»
SDK URLОставьте пустым
Вверху этой страницы видны установленные версии обоих плагинов — пригодятся при обращении в поддержку.
Установка

Активация Auth Keys

Вспомогательный плагин после установки выключен — его нужно включить и поднять наверх списка.

1

Откройте способы входа

Site administration → Plugins → Authentication → Manage authentication.

Раздел Authentication в панели администратора
2

Включите «Proctoring Auth Keys»

Нажмите на иконку иконка включения в строке «Proctoring Auth Keys».

Список способов аутентификации с Proctoring Auth Keys
3

Поднимите его наверх

Стрелкой «Вверх» поставьте «Proctoring Auth Keys» выше остальных включённых способов — сразу под «Ручная регистрация» и «Вход запрещён» (их не передвинуть). Сохранять не нужно.

Proctoring Auth Keys стоит выше остальных способов входа
Нужны оба шага — 2 и 3. Иначе студент вместо теста увидит ошибку входа или форму логина.
Работа

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

Прокторинг включается и настраивается на платформе (app.trustexam.ai или app.oqylyq.kz). В настройках теста Moodle раздел «Proctoring Plugin» показывает эти параметры только для просмотра.

1

Создайте и сохраните тест.

2

Откройте тест → «Редактировать настройки» → раздел «Proctoring Plugin» и нажмите «Create the assignment in the proctoring service» («Создать задание в сервисе прокторинга»).

Раздел Proctoring Plugin в настройках теста
3

На платформе включите прокторинг для этого задания и выберите нужные проверки.

4

Снова откройте настройки теста в Moodle — параметры подтянутся с платформы.

Не пропускайте шаг 4. Moodle узнаёт об изменениях на платформе, только когда открывают настройки теста — до этого студенты пройдут тест без прокторинга.
Работа

Настройки прокторинга

Что означают поля раздела «Proctoring Plugin». Меняются они на платформе, там же есть и дополнительные параметры.

Настройка в MoodleЧто делает
Require the use of Proctoring PluginВключён ли прокторинг для теста
Application TypeГде студент проходит тест: браузер, TrayApp или desktop-приложение
Frontal camera recordЗапись с камеры
Screen recordЗапись экрана
Second camera recordВторая камера — обычно телефон
Face IdentityСверка лица с фото
ID verificationФото удостоверения личности
Second Display CheckПроверка, что подключён только один монитор
Mirror Mode checkПоиск трансляции и дублирования экрана
Content ProtectionЗащита вопросов от скриншотов и удалённого управления
Fullscreen modeТест только в полноэкранном режиме
Extension detectorПоиск запрещённых расширений браузера
Mouse (focus) seekerУход с окна теста
Справка

Частые вопросы

Перед установкой

Нужен ли нам SDK, если у нас Moodle?

Нет. Плагины делают всё сами. SDK нужен только для подключения прокторинга к собственному приложению.

Какой архив выбрать под нашу версию Moodle?

Выбирать не нужно: оба архива ставятся на любую версию Moodle 3.6–5.2.

Обязательно ли ставить оба плагина?

Да. Без «Proctoring Auth Keys» студент не сможет войти в тест из окна прокторинга.

Нужны ли публичный адрес и HTTPS?

Да. Тест открывается внутри окна прокторинга, поэтому сайт должен открываться из интернета, работать по HTTPS и разрешать встраивание во фрейм — см. Требования.

У нас Moodle во внутренней сети. Это помешает?

Браузер студента должен видеть и Moodle, и платформу прокторинга. Если сам сервер Moodle выходит в интернет только через прокси — укажите его в поле Proxy URL.

К каким элементам курса подключается прокторинг?

Только к элементу «Тест».

Установка и настройка

Куда вводить домен и Secret Key?

Администрирование → Плагины → Правила доступа к тесту → Proctoring Access Rules. Домен — trustexam.ai или oqylyq.kz, подробнее — в разделе Подключение.

Зачем поднимать Auth Keys наверх списка?

Moodle проверяет способы входа сверху вниз. Если «Proctoring Auth Keys» ниже другого способа, студент попадёт на форму входа вместо теста.

Почему поля прокторинга в тесте не редактируются?

Так задумано: настройки хранятся на платформе, Moodle их только показывает. Измените их на платформе и откройте настройки теста в Moodle — значения обновятся.

Как обновить плагины?

Как при установке: загрузите новый архив через «Установку плагинов» и подтвердите обновление базы. Настройки сохранятся. Актуальная версия указана в комплекте поставки, установленная — вверху страницы настроек плагина.

Мы обновляем Moodle до 5.1 — что учесть?

В Moodle 5.1 изменилась структура папок, и установленные ранее плагины могут перестать подхватываться без сообщения об ошибке. После обновления проверьте, что оба плагина есть в списке, при необходимости установите архивы заново.

Работа

Студент закрыл окно или потерял связь — что дальше?

Он запускает тест заново — создаётся новая сессия прокторинга. Сколько раз можно перезайти в тест, определяет обычная настройка попыток в Moodle.

Может ли сбой прокторинга испортить сдачу теста?

Нет. Ответы студента сохраняет Moodle, и только после этого прокторинг получает сигнал о завершении.

Какие данные уходят на платформу?

Имя, фамилия и e-mail студента и название теста — они нужны для отчёта. Внутренние идентификаторы Moodle не передаются.

Где смотреть отчёты?

На платформе прокторинга: видео, нарушения, скриншоты и оценка риска по каждой попытке.

Как временно отключить прокторинг для теста?

Выключите прокторинг у задания на платформе и откройте настройки теста в Moodle.

Что приложить к обращению в поддержку?

Версию Moodle, версии обоих плагинов (вверху страницы настроек плагина), время и логин студента, текст ошибки.

Справка

Диагностика

Что случилосьЧто сделать
В тесте нет раздела «Proctoring Plugin» Основной плагин не установлен. Проверьте список плагинов и установите архив заново.
Поля прокторинга не редактируются Так и должно быть — настройки меняются на платформе.
Прокторинг включили, а студент проходит тест без него Откройте настройки теста в Moodle — изменения подтянутся с платформы.
Нет кнопки «Create the assignment in the proctoring service» Сохраните тест. Если задание уже есть на платформе, а прокторинг в нём выключен, — включите его там.
Студент видит ошибку входа или форму логина «Proctoring Auth Keys» не включён или стоит не наверху — см. Активация Auth Keys.
Тест не запускается Проверьте домен и Secret Key. Если сервер Moodle работает через прокси — поле Proxy URL.
Не включаются камера или экран Сайт работает не по HTTPS или запрещено встраивание во фрейм — см. Требования.
Архив не проходит проверку при установке Версия Moodle ниже 3.6 или архив скачался не полностью. Скачайте заново.

Не помогло — напишите в поддержку: версия Moodle, версии плагинов, время, логин студента и текст ошибки.