GenerateRelayPollerScript - AI Red Teaming 生成内网 Agent 接入脚本

更新时间:
复制 MD 格式

AI Red Teaming 为 enterprise_relay 类型的扫描目标生成一次性安装脚本,仅支持 Linux 平台,脚本内含一次性接入码

接口说明

为指定扫描目标生成企业内网 Agent(relay-poller)的安装脚本。

  • 目标必须为 enterprise_relay 连接方式(见 CreateAttackTarget),否则返回 400;目标不存在或归属其他租户时统一返回 400,不暴露资源是否存在;

  • 平台仅支持 Linux:Platform 取"操作系统-架构"格式,仅接受 linux-amd64 与 linux-arm64(架构兼容 amd64、x86_64、x86、arm64、aarch64 写法;仅传架构时操作系统默认 linux);macOS、Windows 等其他操作系统一律返回 400;不传默认为 linux-amd64;

  • 脚本内含一次性接入码:每次调用都会新签发一个接入码,旧码自然失效,即"重新下载脚本 = 新接入码";请使用最新生成的脚本进行安装;

  • 脚本内含 poller 二进制的临时下载链接(有效期 1 小时的签名链接)与校验值;二进制仅提供 Linux 双架构版本;

  • 脚本不包含目标真实端点与凭据:由安装人员在脚本运行时交互输入,平台不持有;

  • 安装完成后 poller 自动完成注册并进入轮询循环(注册与轮询接口由脚本自动调用,无需手动调用);端到端连通性可调用 TestConnectivity 验证。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

TargetId

string

否

扫描目标的唯一标识;必须为 enterprise_relay 连接方式的目标(见 CreateAttackTarget),否则返回 400;目标不存在或归属其他租户时统一返回 400,不暴露资源是否存在;登记为选填但实际必填。

target-abc123def4567

Platform

string

否

目标平台,取"操作系统-架构"格式;仅支持 linux-amd64 与 linux-arm64(架构兼容 amd64、x86_64、x86、arm64、aarch64 写法;仅传架构时操作系统默认 linux);macOS、Windows 等其他操作系统一律返回 400;不传默认为 linux-amd64。

枚举值:

  • linux-amd64 :

    Linux x86 64 位

  • linux-arm64 :

    Linux ARM 64 位

linux-amd64

返回参数

名称

类型

描述

示例值

object

Schema of Response

Data

object

生成结果,包含目标标识、归一化平台与安装脚本。

Platform

string

归一化后的目标平台(操作系统-架构格式)。

linux-amd64

Script

string

安装脚本内容(bash),内含一次性接入码、poller 二进制临时下载链接(1 小时签名)与校验值;不包含目标真实端点与凭据(安装时交互输入)。脚本具有接入凭据语义,请经可信渠道传输,使用后重新下载获取新脚本。

#!/bin/bash

TargetId

string

请求中扫描目标标识的回显。

target-abc123def4567

RequestId

string

本次请求的唯一标识,用于问题排查与日志追踪。

1EBD0C05-6C1F-4C95-9C63-B7AB7B5A9C8E

示例

正常返回示例

JSON格式

{
  "Data": {
    "Platform": "linux-amd64",
    "Script": "#!/bin/bash",
    "TargetId": "target-abc123def4567"
  },
  "RequestId": "1EBD0C05-6C1F-4C95-9C63-B7AB7B5A9C8E"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。