Для создания запроса на проверку объектов используется HTTP-метод POST
. Создать запрос можно, например, с помощью утилиты командной строки cURL.
Вы можете задавать параметры выполнения команды cURL с помощью дополнительных ключей (см. таблицу ниже).
Подробную информацию о ключах команд cURL см. в документации cURL.
Синтаксис команды
curl --cert <путь к файлу TLS-сертификата> --key <путь к файлу закрытого ключа> -X POST "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/scanner/v1/sensors/<идентификатор sensorId>/scans?sensorInstanceId=<идентификатор sensorInstanceId>" -F "content=<путь к файлу, который вы хотите проверить>" -F scanId=<идентификатор запроса на проверку> -F "objectType=file"
При успешной обработке запроса отобразится статус "OK"
.
Параметры
Параметр |
Тип |
Описание |
---|---|---|
|
string |
Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform. |
|
file |
Содержимое проверяемого объекта. |
|
string |
Уникальный идентификатор запроса на проверку. Должен быть сформирован на стороне внешней системы. Не может содержать пробелы и специальные символы. Не используйте имена файлов в качестве идентификатора запроса на проверку. Если этот параметр не указан, просмотр результатов проверки недоступен. |
|
string |
Тип проверяемого объекта. Возможное значения параметра: |
|
string |
Уникальный идентификатор экземпляра внешней системы. Экземплярами внешней системы считаются также серверы, объединенные в кластер. Параметр не является обязательным. |
Возвращаемое значение
Код возврата |
Описание |
---|---|
|
Проверка выполнена успешно. |
|
Требуется авторизация. |
|
Превышено количество запросов. Повторите запрос позднее. |
|
Внутренняя ошибка сервера. Повторите запрос позднее. |
Пример ввода команды с параметрами
|