用途:把 ROE 中的 in_scope_targets 与 out_of_scope_targets 从模糊叙述转为机器可读、经语法校验和冲突检查的产物,避免漏测或越界探测。
主要能力:输出三类交付物——规范化目标清单(区分主机、CIDR、URL 路径、云账号、SaaS 租户并标注类型)、可直接粘贴到扫描器的扁平 IP 允许列表、冲突报告。报告可标记语法错误、范围内外重叠、保留地址段(RFC1918、链路本地、组播)、未单独授权的第三方 SaaS 基础设施、重复目标与通配符子域。技能本身不做 DNS 解析或网络探测。
使用方式:需 Python 3.9+,默认读取 ./roe.yaml,可用 --roe FILE 指定。运行 python3 ./scripts/define_scope.py --roe engagements/acme-2026-q2/roe.yaml。选项包括 --emit-allowlist FILE、--emit-targets FILE、--extension FILE、--output FILE、--format json|jsonl|markdown、--min-severity SEV。允许列表每行一个 IP/CIDR,可用于 nmap -iL、Burp 范围或 WAF 规则。退出码:0 干净,1 存在 high/critical,2 错误。
适用场景:新项目范围定义、中期范围扩展校验、扫描前验证门禁。
限制:不执行 DNS 解析或网络探测;CRITICAL 重叠须在扫描前由客户授权方解决;HIGH 项需明确确认或记录理由;缺失 ROE 或范围内为空会报 CRITICAL 并退出 1;超大 IPv6 掩码(如 ::/0)拒绝展开。具体收费与平台支持暂未提供。