PotatoTool AI渗透引擎深度解析:Skill技能体系、ScopeGuard范围守卫与审批策略如何协同

原创2026-10-15 20:24:371,346 阅读
文章标签:网络安全应用安全密码学渗透测试漏洞扫描桌面应用逆向工程

PotatoTool AI渗透引擎深度解析:Skill技能体系、ScopeGuard范围守卫与审批策略如何协同

PotatoTool 是一款面向红蓝对抗的网络安全综合工具,其 AI 渗透引擎通过 Skill 技能体系、ScopeGuard 范围守卫与 ApprovalPolicy 审批策略三层协同,让 AI 自动渗透测试既高效又可控。本文带你快速看懂这套机制的设计思路与关键源码位置。

PotatoTool 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 步:

  1. 归一化:通过 TargetNormalizer 清洗目标格式;
  2. 黑名单优先:命中 denied 规则直接拒绝;
  3. 白名单匹配:支持精确匹配、子域名后缀匹配(.example.com)、CIDR 网段匹配;
  4. 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 输出的解释文本被网页内容污染,它也无法改变任何执行决策——所有审批与范围判定发生在纯规则代码中。

新手快速上手清单

  1. 在 AI 渗透工作台创建 Mission,填入仅限授权范围内的目标;
  2. 保持 allowActiveScan 默认关闭,先跑只读/被动技能熟悉流程;
  3. 需要主动扫描时再显式开启,并配合白名单精确框定范围;
  4. 任务结束后在报告中查看每一步的审批状态与 ScopeGuard 判定,理解"哪些被放行、哪些被拦截"。

小结

PotatoTool AI 渗透引擎的设计哲学可以概括为一句话:AI 负责解释,规则负责决定。Skill 技能体系让能力标准化、可审计;ScopeGuard 用双名单 + 网络区分类守住目标边界;ApprovalPolicy 用五级风险分级守住操作边界。三层机制相互独立又层层叠加,既释放了自动化渗透的效率,也把"越界"的可能性压到最低。想深入阅读源码,建议从 aiPentest/ 目录下的 scope/、approval/、skill/ 三个子包入手。

登录后查看全文
PotatoTool