Запрос на создание правила запрета

Для создания запроса используется HTTP-метод POST. Параметры команды передаются в теле запроса в формате JSON.

Синтаксис команды

curl -k --<путь к файлу TLS-сертификата> --key <путь к файлу закрытого ключа> -X POST "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/settings?sensor_id=<идентификатор sensor_id или all, если вы хотите создать правило запрета для всех хостов>&settings_type=prevention" -H 'Content-Type: application/json' -d '

{

"settings": {

"objects": [

{

"file": {

"<sha256 или md5>": "<SHA256- или MD5-хеш файла, запуск которого вы хотите запретить>"

}

},

{

"file": {

"<sha256 или md5>": "<SHA256- или MD5-хеш файла, запуск которого вы хотите запретить>"

}

'

При успешной обработке запроса правило запрета будет добавлено. Правило запрета действует с момента добавления.

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

Параметры

Параметр	Тип	Описание
external_system_id	UUID	Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform.
sensor_id	UUID	Уникальный идентификатор хоста Kaspersky Endpoint Agent.
objects	string	Тип объекта, запуск которого вы хотите запретить. Возможное значения параметра: file.
sha256 или md5	string	SHA256- или MD5-хеш объекта, запуск которого вы хотите запретить.

Пример ввода команды с параметрами

curl -k --example.cert --example.key -X POST "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/settings?sensor_id=all&settings_type=prevention" -H 'Content-Type: application/json' -d ' { "settings": { "objects": [ { "file": { "sha256": "830195824b742ee59390bc5b9302688c778fc95a64e7d597e28a74c03a04dd63" } "file": { "md5": "d8e577bf078c45954f4531885478d5a9" } '

Возвращаемое значение

Код возврата	Описание
200	Операция выполнена успешно.
400	Ошибка ввода параметров.
401	Требуется авторизация.
404	Не найден указанный хост Kaspersky Endpoint Agent.
500, 502, 503, 504	Внутренняя ошибка сервера. Повторите запрос позднее.

В начало