Kaspersky Anti Targeted Attack (KATA) Platform

请求扫描对象

2024年6月26日

ID 176838

要创建扫描对象的请求,请使用 HTTP POST方法。例如,您可以使用 cURL 命令行实用程序创建请求。

您可以使用附加开关来设置执行 cURL 命令的参数(请参见下表)。

有关 cURL 命令开关的更多信息,请参阅 cURL 文档。

命令语法

curl --cert <TLS 证书文件路径> --key <私钥文件路径> -X POST "<中央节点组件服务器的 URL>:<端口,默认为 443>/kata/scanner /v1/sensors/<sensorId>/scans?sensorInstanceId=<sensorInstanceId>" -F "content=<要扫描的文件的路径>" -F scanId=<扫描请求 ID> -F "objectType=file"

如果请求得到成功处理,将显示OK状态。

设置

参数

类型

描述

sensorId

string

用于 Kaspersky Anti Targeted Attack Platform 授权的外部系统的唯一 ID。

content

文件

扫描对象的内容。

scanId

string

扫描请求的唯一 ID。它必须在外部系统中生成。它不能包含空格或特殊字符。请勿使用文件名作为扫描请求 ID。

如果未定义此参数,则无法查看扫描结果。

objectType

string

扫描对象的类型。

参数的可能值:文件

sensorInstanceId

string

外部系统实例的唯一 ID。组合成一个集群的服务器也被视为外部系统的实例。此参数是可选的。

返回值

返回码

描述

200

扫描成功完成。

401

需要授权。

429

超过的请求数。稍后重复该请求。

500

内部服务器错误。稍后重复该请求。

使用开关输入命令的示例

curl --cert /root/cert.pem --key /root/server.key -X POST "https://10.10.10.1:443/kata/scanner/v1/sensors/dd11a1ee-a00b-111c-b11a-11001b1f1111/scans?sensorInstanceId=instance1" -F "content=@/tmp/test" -F scanId=1 -F "objectType=file"

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.