Запрос на вывод информации об алертах
Вы можете создать запрос на получение информации об алертах, созданных в результате проверки следующими технологиями:
- Anti-Malware Engine.
- Sandbox.
- YARA.
- URL Reputation.
- Intrusion Detection System.
- Intrusion Detection System (NDR).
- Aggregated Alerts (NDR).
Для создания запроса на вывод информации об алертах Kaspersky Anti Targeted Attack Platform используется HTTP-метод GET. Создать запрос можно, например, с помощью утилиты командной строки cURL.
Синтаксис команды
curl --cert <путь к файлу TLS-сертификата> --key <путь к файлу закрытого ключа> -X GET "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/scanner/v1/sensors/<идентификатор sensorId>/detects?detect_type=<одна или несколько технологий, при проверке которыми создан алерт>&limit=<количество алертов в ответе на запрос>&token=<идентификатор запроса>"
При успешной обработке запроса отобразится список алертов, созданных приложением Kaspersky Anti Targeted Attack Platform на сервере внешней системы.
Параметры
Параметр | Тип | Описание |
|---|---|---|
| String | Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform. |
| Array | Технология, при проверке которой создан алерт. Возможно указать несколько технологий через запятую. Возможные значения:
Если параметр не указан, предоставляется информация обо всех перечисленных выше алертах. |
| Integer | Количество объектов, информация о которых будет предоставлена в ответ на запрос. Допустимые значения: целые числа от 1 до 10000. По умолчанию установлено значение |
| String | Идентификатор запроса. При указании этого параметра в повторном запросе не отображается информация об обнаружениях, полученная в предыдущих запросах. Это позволяет избежать дублирования информации об одних и тех же алертах при повторных запросах. Если этот параметр не указан, предоставляется информация обо всех алертах. |
Ответ
HTTP-код: 200
Формат: JSON
|
Возвращаемое значение
Код возврата | Описание |
|---|---|
| Ошибка ввода параметров. |
| Превышено количество запросов. |
| Требуется авторизация. |
| Внутренняя ошибка сервера. Повторите запрос позднее. |
Пример ввода команды с параметрами
|