GenerateRelayPollerScript - AI Red Teaming 生成内网 Agent 接入脚本
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代码示例。
调试
授权信息
请求语法
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 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。