› › ›

解除隔离的主机

编辑

解除隔离的主机

编辑

删除主机的隔离状态并允许其重新加入网络。

您必须具有主机隔离权限才能执行此操作。所有许可证级别均可使用。

请求 URL

编辑

POST <kibana 主机>:<端口>/api/endpoint/action/unisolate

（已弃用）POST <kibana 主机>:<端口>/api/endpoint/unisolate - 此 URL 将返回 308 永久重定向到 POST <kibana 主机>:<端口>/api/endpoint/action/unisolate

请求正文

编辑

一个包含以下字段的 JSON 对象

名称	类型	描述	必需
`endpoint_ids`	数组（字符串）	您要执行此操作的端点的 ID。	是
`agent_type`	字符串	主机运行的代理类型。接受的值为 `endpoint`（默认） `sentinel_one`（当前处于技术预览版）	否
`alert_ids`	数组（字符串）	如果此操作与任何警报关联，可以在此处指定它们。该操作将被记录在与指定警报相关的任何案例中。	否
`case_ids`	数组（字符串）	将记录执行操作的案例的 ID。	否
`comment`	字符串	将注释附加到此操作的日志。注释文本将显示在关联的案例中。	否

示例请求

编辑

使用 endpoint_id 值为 ed518850-681a-4d60-bb98-e22640cae2a8 解除单个主机的隔离

POST /api/endpoint/action/unisolate
{
  "endpoint_ids": ["ed518850-681a-4d60-bb98-e22640cae2a8"]
}

解除多个主机的隔离；包括注释

POST /api/endpoint/action/unisolate
{
  "endpoint_ids": [
  	"9972d10e-4b9e-41aa-a534-a85e2a28ea42",
  	"bc0e4f0c-3bca-4633-9fee-156c0b505d16",
  	"fa89271b-b9d4-43f2-a684-307cffddeb5a"
  ],
  "comment": "Benign process identified, releasing group"
}

解除与关联案例的主机的隔离；包括注释。

POST /api/endpoint/action/unisolate
{
  "endpoint_ids": [
  	"1aa1f8fd-0fb0-4fe4-8c30-92068272d3f0",
  	"b30a11bf-1395-4707-b508-fbb45ef9793e"
  ],
  "case_ids": ["4976be38-c134-4554-bd5e-0fd89ce63667"]
  "comment": "Remediation complete, restoring network"
}

响应代码

编辑

200: 指示调用成功。
403: 指示用户权限不足（需要主机隔离）。
500: 一般错误。响应消息将提供更多详细信息。

响应负载

编辑

一个 JSON 对象，其中包含引用已提交操作的 id。

示例响应

编辑

{
  "action": "233db9ea-6733-4849-9226-5a7039c7161d",
  "data": {
    "id": "233db9ea-6733-4849-9226-5a7039c7161d",
    "agents": ["ed518850-681a-4d60-bb98-e22640cae2a8"],
    "command": "suspend-process",
    "agentType": "endpoint",
    "isExpired": false,
    "isCompleted": true,
    "wasSuccessful": true,
    "errors": [],
    "startedAt": "2022-07-29T19:08:49.126Z",
    "completedAt": "2022-07-29T19:09:44.961Z",
    "outputs": {
      "ed518850-681a-4d60-bb98-e22640cae2a8": {
        "type": "json",
        "content": {
          "key": "value"
        }
      }
    },
    "createdBy": "myuser",
    "comment": "suspend the process",
    "parameters": {
      "entity_id": "abc123"
    }
  }
}

« 隔离主机终止进程 »