Kaspersky Anti Targeted Attack (KATA) Platform

请求扫描结果

2024年6月26日

ID 176830

要创建接收扫描结果的请求,请使用 HTTP GET方法。例如,您可以使用 cURL 命令行实用程序创建请求。

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

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

命令语法

curl --cert <TLS证书文件路径> --key <私钥文件路径> -X GET <中央节点组件服务器的URL>:<端口,默认443>/kata/scanner/ v1/sensors/<sensorId> /scans/状态? sensorInstanceId=<sensorInstanceId> &state=<您想要在扫描结果中显示的一个或多个扫描状态> "

如果请求发送成功,则会显示扫描对象的请求列表以及扫描这些对象的结果。扫描结果将按您在state参数中指定的状态进行筛选。例如,如果您在扫描结果请求中指定state=processing,detect,则应用程序将仅显示正在被处理或应用程序在其中检测到威胁的对象扫描请求。

设置

参数

类型

描述

sensorId

string

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

状态

阵列(字符串元素类型)

对象扫描状态。定义此参数后,将按状态筛选扫描结果。

指示一种或多种状态,以逗号分隔。

可以使用以下参数值:

  • detect
  • not detected
  • processing
  • timeout
  • error

sensorInstanceId

string

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

Response

HTTP 代码:200

格式:JSON

type Response []Scans

 

type Scans struct {

ScanID integer `json:"scanId"`

State array `json:"state"`

}

返回值

返回码

描述

204

没有内容。

404

未找到指定 ID 的扫描结果。

500

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

如果要在扫描结果中显示所有对象扫描状态时输入带有开关的命令的示例

curl --cert /root/cert.pem --key /root/server.key -X GET "https://10.10.10.1:443/kata/scanner/v1/sensors/dd11a1ee-a00b-111c-b11a-11001b1f1111/scans/state?sensorInstanceId=instance1&state=detect,not detected,processing,error,timeout"

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.