REST API

В KUMA можно обращаться из сторонних решений с помощью API. KUMA REST API работает через HTTP и представляет набор методов запрос/ответ.

Поддерживается версия REST API v3.

Запросы REST API необходимо отправлять по следующему адресу:

https://<FQDN Ядра KUMA>:<Порт REST API>/api/<Версия API>/<запрос>

Пример

https://kuma.example.com:7223/api/v3

По умолчанию для запросов используется порт 7223. При необходимости порт можно изменить.

Чтобы изменить порт, используемый для запросов REST API:

Войдите в операционную систему сервера, на котором установлено Ядро KUMA.
В файле /etc/systemd/system/multi-user.target.wants/kuma-core.service измените следующую строку, подставив нужный порт:
ExecStart=/opt/kaspersky/kuma/kuma core --external :7220 --internal :7210 --rest <требуемый номер порта для запросов REST API>
Перезапустите KUMA, выполнив последовательно следующие команды:
systemctl daemon-reload

systemctl restart kuma-core

Для запросов REST API используется новый порт.

Убедитесь, что порт доступен и не закрыт межсетевым экраном.

Заголовок для аутентификации:

Authorization: Bearer <токен>

Формат данных по умолчанию: JSON

Формат даты и времени: RFC 3339

Интенсивность запросов: не ограничена

В этом разделе справки