API. Параметры для интеграции
Со стороны Экзамуса заказчик получает examus_url, integration_name и jwt_secret. Также присутствуют дополнительные параметры, не являщиеся обязательными, эндпоинт которых создаёт заказчик на стороне системы тестирования:
- review_url — для получения результатов прокторинга внутри системы тестирования;
- schedule_url — для получения событий из Календаря (пользователь записался, отписался и т.д)
- warning_url. — для получения получения нарушений в реальном времени внутри системы тестирования.
Процедура прокторинга
- Перед началом экзамена пользователь должен войти в систему заказчика, где ему должна быть доступна кнопка “Начать тест” (или любая кнопка, которая открывает этот тест).
- Кнопка должна перенаправить тестируемого на уникальный URL, после перехода по которому произойдет авторизация в Экзамусе.
- Экзамус ожидает POST-запрос с единственным параметром — подписанным JWT-токеном, в котором содержится вся информация о пользователе и предстоящем тестировании. Подпись позволит проверить, что запрос идет именно от системы заказчика.
- После авторизации пользователю будут выданы краткие инструкции к дальнейшим действиям.
- В случае если прокторинг асинхронный, пользователь перейдет непосредственно к тестированию сразу после необходимых проверок и идентификации в Экзамусе.
- При синхронном прокторинге (с проктором-человеком) нужно будет дождаться разрешения проктора начать тест.
Веб-приложение открывает страницу экзамена в iframe. Если для доступа к странице экзамена пользователь должен быть авторизован в системе заказчика, cookies должны иметь атрибуты SameSite=None; Secure=True, чтобы состояние авторизации сохранялось в iframe.
При использовании веб-приложения можно запретить доступ к странице экзамена без прокторинга, для этого необходимо добавить на страницу экзамена специальный скрипт. Детально механизм защиты описан в этом документе.
Когда пользователь завершает тестовое испытание, система заказчика делает специальный запрос к API Экзамуса, чтобы отметить текущий сеанс завершенным и прекратить запись видео. После выставления результата сессии прокторинга Экзамус отсылает его с помощью специального запроса в систему заказчика, подписывая заголовки JWT-токеном. Все взаимодействия осуществляются по протоколу HTTPS.