Kaspersky Anti Targeted Attack (KATA) Platform

请求将排除项添加到网络隔离规则

2024年6月26日

ID 227499

要将排除项添加到之前创建的网络隔离规则中,您必须创建添加排除项的请求。要创建请求,请使用 HTTP POST 方法。

命令设置以 JSON 格式在请求正文中传递。

命令语法

curl -k --cert <TLS 证书文件路径> --key <私钥文件路径> -X POST "<Central Node 服务器的 URL>:<端口,默认为 443>/kata/response_api/v1/<external_system_id >/settings?sensor_id=<sensor_id>&settings_type=network_isolation" -H 'Content-Type:application/json' -d '

{
"settings":
{"excludedRules": [
{
"direction": "<outbound、inbound 或 both>",
"protocol": <IP 协议编号>,
"remoteIpv4Address": "<具有 Endpoint Agent 组件的主机的 IP 地址,该组件的流量不得被阻止>",
"localPortRange":
{
"fromPort": <端口号>,
"toPort": <端口号>
}
}
,
{
"direction": "<outbound、inbound 或 both>",
"protocol": <IP 协议编号>,
"remoteIpv4Address": "<具有 Endpoint Agent 组件的主机的 IP 地址,该组件的流量不得被阻止>",
"remotePortRange":
{
"fromPort": <端口号>,
"toPort": <端口号>
}
}
,
{
"direction": "<outbound、inbound 或 both>",
"protocol": <IP 协议编号>,
"remoteIpv4Address": "<具有 Endpoint Agent 组件的主机的 IP 地址,该组件的流量不得被阻止>"
}
]
,
"autoTurnoffTimeoutInSec": <网络隔离时长>
}
}
'

如果请求处理成功,则会添加网络隔离规则的排除项。

设置

参数

类型

描述

external_system_id

UUID

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

sensor_id

UUID

具有 Endpoint Agent 组件的主机的唯一 ID。

direction

阵列

不得被阻止的网络流量方向。可能值:

  • inbound
  • outbound
  • both

如果您没有为此参数指定值,则默认值为“both”,这意味着应用程序在两个方向上传输流量。

protocol

integer

由互联网号码分配机构 (IANA) 分配的 IP 协议号

如果不指定此参数的值,则默认情况下,网络隔离将应用于所有协议。

remoteIpv4Address

string

具有 Endpoint Agent 组件的主机的 IP 地址,其流量不得被阻止

remotePortRange

string

目的端口。

仅当您选择了网络流量的出站方向时,才可以指定目标端口。无法为双向流量指定端口范围。

localPortRange

string

从其发起连接的端口。

仅当您选择了网络流量的入站方向时,才可以指定目标端口。无法为双向流量指定端口范围。

autoTurnoffTimeoutInSec

integer

网络隔离处于活动状态的时间段。

允许范围 - 1 到 9999 小时。网络隔离时间以秒为单位指定。例如,如果要启用主机网络隔离两个小时,则必须指定 7200 秒。

输入具有开关的命令的示例

curl -k --cert <TLS 证书文件路径> --key <私钥文件路径> -X POST "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/settings?sensor_id=DF64838B-B518-414B-B769-2B8BE341A2F0&settings_type=network_isolation" -H 'Content-Type: application/json' -d '

{
"settings":
{"excludedRules": [
{
"direction": "inbound",
"protocol": 6,
"remoteIpv4Address": "10.16.41.0",
"localPortRange":
{
"fromPort": 3389,
"toPort": 3389
}
}
,
{
"direction": "outbound",
"remoteIpv4Address": "10.16.41.1",
"remotePortRange":
{
"fromPort": 13957,
"toPort": 55409
}
}
,
{
"direction": "both",
"protocol": 6,
"remoteIpv4Address": "10.16.41.2"
}
]
,
"autoTurnoffTimeoutInSec": 7200
}
}
'

Response

HTTP 代码:200

格式:JSON

type Response []Settings
type Settings struct {
ExcludedRules array `json:"excludedRules"`
AutoTurnoffTimeoutInSec integer `json:"autoTurnoffTimeoutInSec"`
}
type ExcludedRules struct {
Direction array `json:"direction"`
Protocol integer `json:"autoTurnoffTimeoutInSec"`
RemotePortRange string `json:"remotePortRange"`
LocalPortRange string `json:"localPortRange"`
}

返回值

返回码

描述

400

参数不正确。

401

需要授权。

404

未找到具有 Endpoint Agent 组件的指定主机。

500, 502, 503, 504

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

如果要编辑已创建的排除项的设置,您必须创建一个新请求以添加具有新设置的排除项。

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.