API. Параметры для интеграции #151

  • Просмотров: 55

API. Параметры для интеграции

Со стороны Экзамуса заказчик получает examus_url, integration_name и jwt_secret. Также присутствуют дополнительные параметры, не являщиеся обязательными, эндпоинт которых создаёт заказчик на стороне системы тестирования:

  1. review_url — для получения результатов прокторинга внутри системы тестирования;
  2. schedule_url — для получения событий из Календаря (пользователь записался, отписался и т.д)
  3. warning_url. — для получения получения нарушений в реальном времени внутри системы тестирования.

Процедура прокторинга

  1. Перед началом экзамена пользователь должен войти в систему заказчика, где ему должна быть доступна кнопка “Начать тест” (или любая кнопка, которая открывает этот тест).
  2. Кнопка должна перенаправить тестируемого на уникальный URL, после перехода по которому произойдет авторизация в Экзамусе.
  3. Экзамус ожидает POST-запрос с единственным параметром — подписанным JWT-токеном, в котором содержится вся информация о пользователе и предстоящем тестировании. Подпись позволит проверить, что запрос идет именно от системы заказчика.
  4. После авторизации пользователю будут выданы краткие инструкции к дальнейшим действиям.
  5. В случае если прокторинг асинхронный, пользователь перейдет непосредственно к тестированию сразу после необходимых проверок и идентификации в Экзамусе.
  6. При синхронном прокторинге (с проктором-человеком) нужно будет дождаться разрешения проктора начать тест.

Веб-приложение открывает страницу экзамена в iframe. Если для доступа к странице экзамена пользователь должен быть авторизован в системе заказчика, cookies должны иметь атрибуты SameSite=None; Secure=True, чтобы состояние авторизации сохранялось в iframe.

При использовании веб-приложения можно запретить доступ к странице экзамена без прокторинга, для этого необходимо добавить на страницу экзамена специальный скрипт. Детально механизм защиты описан в этом документе.

Когда пользователь завершает тестовое испытание, система заказчика делает специальный запрос к API Экзамуса, чтобы отметить текущий сеанс завершенным и прекратить запись видео. После выставления результата сессии прокторинга Экзамус отсылает его с помощью специального запроса в систему заказчика, подписывая заголовки JWT-токеном. Все взаимодействия осуществляются по протоколу HTTPS.