PotatoTool AI渗透引擎深度解析:Skill技能体系、ScopeGuard范围守卫与审批策略如何协同
PotatoTool AI渗透引擎深度解析:Skill技能体系、ScopeGuard范围守卫与审批策略如何协同
PotatoTool 是一款面向红蓝对抗的网络安全综合工具,其 AI 渗透引擎通过 Skill 技能体系、ScopeGuard 范围守卫与 ApprovalPolicy 审批策略三层协同,让 AI 自动渗透测试既高效又可控。本文带你快速看懂这套机制的设计思路与关键源码位置。
为什么 AI 渗透测试需要"三件套"
让 AI 自动执行渗透测试,最大的担忧是:AI 会不会越界? 比如扫描到授权范围之外的目标、执行高危操作、或被网页内容中的提示注入"带偏"。
PotatoTool 的答案是把"智能"和"权限"彻底分离:
| 组件 | 职责 | 一句话理解 |
|---|---|---|
| Skill 技能体系 | 定义"能做什么" | 每个能力都是一个带风险等级的标准化技能 |
| ScopeGuard 范围守卫 | 定义"能对谁做" | 目标必须命中白名单,回环地址与 OOB 域名直接拦截 |
| ApprovalPolicy 审批策略 | 定义"允不允许做" | 按技能风险等级决定是否放行 |
三者都不依赖 AI 的判断,即使 AI 出错或输出被投毒,控制流也不会被绕过。这一点在 AiPentestAdvisor.java 的设计契约中写得很清楚:AI 只生成"显示给用户的解释字段",不选 Skill、不绕 ScopeGuard、不覆盖 ApprovalPolicy。
Skill 技能体系:把渗透能力"插件化"
每个技能都有标准"身份证"
所有技能都实现统一的 SkillAdapter 接口,并提供一个 SkillDescriptor 描述符,包含技能 ID、类别、风险等级、是否需要范围约束、是否需要审批、输入/输出 Schema 等元信息。
技能类别由 SkillCategory 划分为 RECON(侦察)、SCAN(扫描)、VULNERABILITY(漏洞)、REPORT(报告)、UTILITY(工具)五类。
五级风险分级是核心设计
风险等级定义在 SkillRiskLevel.java 中,从低到高共五级:
READONLY → PASSIVE → ACTIVE → INTRUSIVE → DANGEROUS
(只读) (被动) (主动) (侵入) (危险)
风险等级直接决定审批结果(详见下文),这是整个引擎"分级管控"的基石。
内置技能清单
SkillRegistry.createDefault() 注册了 16+ 个内置技能,覆盖完整的渗透测试流程:
| 技能 | 作用 |
|---|---|
| PortScanSkillAdapter | 端口扫描,发现开放服务 |
| AssetMappingSkillAdapter | 资产映射 |
| VulnScanSkillAdapter | 漏洞扫描 |
| HttpReplaySkillAdapter | HTTP 请求重放 |
| HeadlessCaptureSkillAdapter | 无头浏览器页面捕获 |
| SourceScanSkillAdapter | 源码路由与风险分析 |
| PocSearchSkillAdapter | POC 检索 |
| Blue*SkillAdapter 系列 | 蓝队解密、反编译、IP 富化等 |
| ReportSkillAdapter | 报告生成 |
此外还支持通过 extension/ 目录加载用户自定义扩展技能(草稿态)。
ScopeGuard 范围守卫:给目标上"白名单"
双名单机制
每个 Mission 的 Scope 配置包含两组规则:
- allowedTargets:允许访问的目标白名单(域名、IP、CIDR 网段)
- deniedTargets:明确排除的目标黑名单
ScopeGuard.validate() 的校验逻辑可以概括为 4 步:
- 归一化:通过
TargetNormalizer清洗目标格式; - 黑名单优先:命中 denied 规则直接拒绝;
- 白名单匹配:支持精确匹配、子域名后缀匹配(
.example.com)、CIDR 网段匹配; - DNS 反解校验:对域名类目标做 DNS 解析,防止用域名绕过 IP 白名单。
三类目标"一票否决"
无论白名单怎么写,以下目标永远被拒绝(见 classify()):
- 回环地址(127.x):防止打到自己;
- 链路本地地址(169.254.x):防止攻击云元数据服务;
- OOB 域名:
oast.pro、interact.sh、dnslog.cn等 14 个带外回显平台,防止数据外带。
被拦截时返回 ScopeViolation,附带拒绝原因(DENIED / NOT_ALLOWED / LOOPBACK_TARGET / OOB_TARGET),全部落库留痕。
ApprovalPolicy 审批策略:风险等级决定命运
ApprovalPolicy.evaluate() 的规则简洁而严格:
| 技能风险等级 | 审批结果 |
|---|---|
| 已禁用 | ❌ 直接拒绝 |
| INTRUSIVE / DANGEROUS | ❌ 拒绝并永久禁用该技能 |
| ACTIVE 或需审批 | ⚠️ 仅当任务开启 allowActiveScan 时放行(本 Mission 有效) |
| 其他(只读/被动) | ✅ 单次放行 |
决策类型定义在 ApprovalDecision.java:ALLOW_ONCE(单次允许)、ALLOW_FOR_MISSION(本任务允许)、DENY(拒绝)、DENY_AND_DISABLE_SKILL(拒绝并禁用)。
任务侧的开关在 MissionConfig 中:allowActiveScan、allowIntrusiveScan、allowDangerousAction 三级开关,默认全部关闭——想执行主动扫描,必须用户显式勾选。
三者如何协同:一次 Mission 的完整流水线
MissionService 是总调度器,每次技能调用都走同一条"安检线":
用户启动 Mission
│
├─① ScopeGuard 校验全部 targets(<a href="https://link.gitcode.com/i/56885a0732c80a43b7760996fa6f824f" target="_blank">validateConfig</a>)
│
├─② PreflightService 预检 10 项检查(目标格式、范围覆盖、
│ 限流合理性、浏览器候选等)
│
├─③ ApprovalPolicy 对每个技能逐个审批
│ └─ 被拒 → 落库 + 抛出 MissionValidationException,技能不执行
│
├─④ SkillAdapter 执行,产出 Evidence / Finding
│ └─ 输出经 AiPentestOutputSanitizer 脱敏后展示
│
└─⑤ 全部调用记录存入 AiPentestDatabase,全程可审计
几个关键细节值得新手注意:
- 范围校验不止一次:技能执行过程中遇到的每个新目标(如 HttpReplayService 的跳转目标、HeadlessCaptureService 的最终 URL)都会再次过 ScopeGuard,防止"顺藤摸瓜"式越界;
- 场景预设收敛权限:ScenarioPreset 定义了 6 种场景(如 WEB_ENTRY_SAFETY、DATA_EXPOSURE_SENSITIVE_OUTPUT),每个场景绑定固定的技能优先级列表与默认风险族,用户不需要(也无法)自由组合高危技能;
- 预检前置:PreflightService 在任务启动前跑完 TargetFormatCheck、ScopeCoverageCheck、ScopeDeniedHitCheck 等检查,把配置问题挡在执行之前;
- AI 永远只是"解说员":即使 AI 输出的解释文本被网页内容污染,它也无法改变任何执行决策——所有审批与范围判定发生在纯规则代码中。
新手快速上手清单
- 在 AI 渗透工作台创建 Mission,填入仅限授权范围内的目标;
- 保持
allowActiveScan默认关闭,先跑只读/被动技能熟悉流程; - 需要主动扫描时再显式开启,并配合白名单精确框定范围;
- 任务结束后在报告中查看每一步的审批状态与 ScopeGuard 判定,理解"哪些被放行、哪些被拦截"。
小结
PotatoTool AI 渗透引擎的设计哲学可以概括为一句话:AI 负责解释,规则负责决定。Skill 技能体系让能力标准化、可审计;ScopeGuard 用双名单 + 网络区分类守住目标边界;ApprovalPolicy 用五级风险分级守住操作边界。三层机制相互独立又层层叠加,既释放了自动化渗透的效率,也把"越界"的可能性压到最低。想深入阅读源码,建议从 aiPentest/ 目录下的 scope/、approval/、skill/ 三个子包入手。
