Интеграция с WebSoft HCM (WebTutor)

1. Настройка WebTutor

1.1 Общая информация

Интеграция с СДО WebTutor произведена в процессе совместной работы разработчиков WebSoft и ProctorEdu. Система прокторинга представлена в СДО WebTutor (начиная с версии 3.4.60) в качестве одного из внешних источников.

Найти систему прокторинга в СДО можно в меню "Системное администрирование" → "Внешние источники" → "Системы прокторинга":

При двойном клике на ProctorEdu появится меню настроек, где следует заполнить значения переменных:

url — адрес сервера прокторинга, который должен заканчиваться на "/api". Следует указать адрес в поле "Значение", например: https://your.proctoring.online/api

secret_key — секретный ключ интеграции с сервером прокторинга, который берется в системных параметрах сервера прокторинга. Следует взять значение параметра authorizer.link.secretOrKey и указать его в поле "Значение", например: 1368bbc340d447889afc813cf37b6e2d

1.2 Настройка под менеджером

Для корректной работы интеграции с WebTutor необходимо добавить параметры конфигурации. Для этого под учетной записью manager необходимо внести изменения. Сохраните конфигурацию в формате json:

Внесите следующие изменения в полученный json-файл:

{
  "id": "63d7c...",
  "key": "eyJhbGciOiJS...",
  "params": {
    "webhooks": {
      "link": {
        "authorizer": "jwt",
        "integrator": "generic",
        "secretOrKey": "secret_key",
        "profile": {
          "group": "payload.group",
          "lang": "payload.lang",
          "nickname": "[payload.lastname,payload.firstname].join(' ')",
          "username": "payload.username.replace(/[^A-Za-z0-9_-]+/g,'_')",
          "labels": "payload.email",
          "role": "payload.role",
          "referrer": "payload.referrer || payload.referer"
        },
        "register": {
          "template": "payload.template || 'default'",
          "tags": "[payload.email,payload.lastname,payload.firstname]",
          "timeout": "payload.timeout || payload.duration",
          "deadline": "payload.deadline",
          "url": "payload.url",
          "api": "payload.api",
          "subject": "payload.subject",
          "identifier": "payload.id || payload.openId"
        },
        "submit": {
          "method": "POST",
          "uri": "room.api",
          "headers": {
            "X-Access-Token": "secret_key"
          },
          "body": {
            "openId": "room.identifier",
            "verification": "100-room.averages.c4",
            "comment": "room.comment",
            "subject": "room.subject",
            "duration": "room.duration",
            "conclusion": "room.conclusion",
            "fromDate": "room.startedAt",
            "evaluation": "room.score",
            "toDate": "room.stoppedAt"
          }
        }
      }
    }
  }
}

где secret_key - ключ интеграции, например, 1368bbc340d447889afc813cf37b6e2d из п 1.1.

Загрузите полученный json:

В результате конфигурация должна выглядеть так:

1.3 Настройка HTTPS

Система прокторинга ProctorEdu требует использования защищенного протокола соединения HTTPS, поэтому необходимо дополнительно настроить приложение WebSoft HCM Administrator на его использование.

1.4 Настройка плеера

Для корректной работы необходимо выбрать третью версию плеера:

2. Настройка модуля прокторинга

2.1 Настройка курса

При создании нового или в уже существующем курсе или тесте, автор может выбрать систему прокторинга ProctorEdu. Для этого надо перейти на вкладку "Прокторинг" в карточке курса\теста:

Далее следует поставить флажок в поле "Использовать прокторинг":

После этого, нажать на кнопку "...", выбрать ProctorEdu и закрепить выбор нажатием на "Применить":

2.2 Назначение курса

При назначении курса или теста, следует повторно убедиться, что опция "Использовать прокторинг" включена: