Веб-служба

Веб-служба мониторинга предназначена для обмена данными о тестировании между Сервером Мониторинга и Агентами Мониторинга. Настроить Веб-службу возможно на любом экземпляре КриптоПро Центр Мониторинга, однако основной вариант использования подразумевает ее работу на Агентах, которые с ее помощью смогут отправлять информацию о тестах на Сервер Мониторинга. Сервер Мониторинга получает сведения от Веб-службы при помощи Теста состояния удаленного Агента Мониторинга.

Взаимодействие с Веб-службой осуществляется путем отправки к ней GET-запроса вида:

GET <Адрес службы>/<Имя экземпляра тестирования>/GetLastTestStatus

Пример запроса:

http://win-srv:8080/monitor/cprokey/GetLastTestStatus

Возможны два варианта ответа веб-службы:

  • HTTP 200 (успех);
  • HTTP 500 (ошибка).

Веб-служба вернет HTTP 200, если в предыдущем запуске тестов на Агенте, к которому делается запрос, для указанного экземпляра тестирования не произошло ошибок.

Веб-служба вернет HTTP 500, если в предыдущем запуске тестов на Агенте, к которому делается запрос, были ошибки. В данный ответ помещаются сведения о результатах последнего запуска тестирования в формате JSON (см. Таблица 8).

Таблица 8 — Ответ Веб-службы

Поле Тип Описание
DetailedInformation List<string> Список результатов последнего запуска тестов
ErrorMessage String Краткое описание ошибки. Допустимые значения:
* Тестирование экземпляра [Имя экземпляра] еще не проводилось;
* Один или несколько тестов завершились с ошибкой.
Time String Время форматирования данного сообщения в UTC.

Пример ответа:

{"DetailedInformation":
 ["cprokey -> Тестовая аутентификация -> успешно завершён",
 "cprokey -> Тестовая подпись -> успешно завершён",
 "cprokey -> Тест криптопровайдеров Сервиса Подписи КриптоПро Ключ -> успешно завершён",
 "cprokey -> Проверка сертификатов веб интерфейса КриптоПро Ключ -> успешно завершён",
 "cprokey -> Проверка сертификатов сервиса ЦИ КриптоПро Ключ -> завершён с ошибкой",
 "cprokey -> Проверка сертификатов сервиса подписи КриптоПро Ключ -> успешно завершён"],
"ErrorMessage":"КриптоПро Ключ: Один или несколько тестов завершились с ошибкой.",
"Time":"2019-01-29T10:18:04Z"}

Сервер Мониторинга также может получать результаты тестирования от Агента Мониторинга при помощи Веб-службы. Для этого используется Тест состояния удаленного Агента Мониторинга. Укажите следующие настройки данного теста:

  • Адрес веб-службы Агента Мониторинга — Адрес службы из настроек Веб-службы на Агенте (Например, http://win-srv:8080/monitor)
  • Имя экземпляра тестирования — Имя тестируемого экземпляра на Агенте (Например, cprokey).
  • Cохраните настройки теста при помощи кнопки «Сохранить».

web2.png