Частые вопросы по работе с API в Kaspersky Anti Targeted Attack Platform
Показать приложения и версии, к которым применима статья
- Kaspersky Anti Targeted Attack Platform 8.0;
- Kaspersky Anti Targeted Attack Platform 7.1;
- Kaspersky Anti Targeted Attack Platform 7.0.
В этой статье мы ответим на часто задаваемые вопросы о работе с интерфейсом API в Kaspersky Anti Targeted Attack Platform (далее KATA).
Что делать, если при отправке запроса возникает ошибка авторизации системы
Если вы столкнулись с проблемой интеграции по API и при выполнении запроса возникает ошибка авторизации, удалите запись внешней системы из веб-интерфейса KATA и выполните повторное подключение по инструкции.
Что делать, если запрос содержит специальные символы в значениях полей и неправильно обрабатывается
Если значения полей (например, сгенерированный токен) в запросе содержат специальные символы (=, +, /, @, # и другие), это может изменить поведение API и повлиять на результат вывода.
Перед отправкой такого запроса следует выполнить URL-кодирование одним из способов:
- с помощью сервиса URL-кодирования, например urlencoder;
- с помощью параметра
--data-urlencode, добавленного в cURL-команду.
Специальные символы будут преобразованы в безопасный формат и могут использоваться для отправки запроса.
Пример неправильного значения со специальными символами:
Пример преобразованного значения после кодирования:
Почему количество событий в веб-интерфейсе KATA отличается от количества событий, полученных по Events API
В разделе Поиск угроз веб-интерфейса KATA версии 7.1 и ниже используются данные из Elasticsearch. Events API получает события из топика Kafka, где они хранятся не более двух часов.
Поскольку данные поступают из разных источников и имеют разное время хранения, количество событий в веб-интерфейсе и в ответе Events API может не совпадать.
Можно ли с помощью Events API повторно получить события из KATA по времени их появления
Такая возможность не предусмотрена.
В KATA версии 7.1 и ниже Events API получает события из топика Kafka, а не из Elasticsearch. Если, например, события были вычитаны из Kafka, но из-за сбоя не были переданы во внешнюю систему, повторно получить тот же набор событий по времени их появления не получится.
Почему Scanner API возвращает ошибку 429 (Too Many Requests) и как ее исправить
Ошибка 429 (Too Many Requests) при использовании Scanner API может возникать, если превышено установленное количество одновременно выполняемых запросов. За это количество отвечает параметр max_tasks_per_client. Пример конфигурации:
"top_priority": false,
"wait_for_sb_background_queue": true,
"max_tasks_per_client": 50
}
При возникновении ошибки создайте запрос в техническую поддержку «Лаборатории Касперского» через Kaspersky CompanyAccount.
