Web 渗透测试
经授权的 Web 应用程序渗透测试——涵盖信息收集、漏洞分析、基于证据的漏洞利用与专业报告。改编自 Shannon 的"无利用,不报告"方法论,并对范围、授权和辅助客户端泄露设置了严格的防护栏。仅对你拥有或已获得书面授权的运行中的应用程序进行主动测试。
Skill 元数据
| Source | Optional — install with kopi skills install official/security/web-pentest |
| Path | optional-skills/security/web-pentest |
| Platforms | linux, macos |
参考:完整 SKILL.md
以下是触发此 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 激活时 agent 所看到的指令。
Web 应用程序渗透测试
针对运行中 Web 应用的分阶段渗透测试工作流。改编自 Shannon 的流水线(Keygraph,AGPL——仅借鉴概念,未借用任何代码)。围绕三条规则构建:
- 无利用,不报告——每一条发现都必须附带可复现的证据。
- 范围受限——每一次主动请求都必须指向操作者预先声明的目标。拒绝访问范围之外的主机。
- 先穷尽绕过手段,再判定为误报——一个"被拦截"的 payload 在你尝试完绕过集合之前,并不等于安全无虞。
⚠️ 严格防护栏——每次执行任务前必读
违反其中任何一条都会导致本次测试失效,并且可能违法。
-
授权关口。 在会话中执行第一次主动扫描之前,你必须以书面形式与用户确认:该用户拥有目标的所有权或已获得书面测试授权。将该确认记录到
engagement/authorization.md中(见模板)。没有确认 → 不进行主动扫描。用curl读取公开页面没问题;发送 payload 则不可以。 -
范围白名单。 维护
engagement/scope.txt——每行一个主机名或 CIDR。每一个nmap、curl、whatweb、浏览器导航或携带 payload 的请求必须指向 scope 中的条目。如果目标将你重定向到范围之外(3xx 到不同主机、HTML 中的链接),停止并先与用户确认再继续。 -
没有书面文件就不碰生产环境。 如果用户没有明确告诉你"是的,生产环境在范围内,且我有书面批准",就默认不在范围内。默认目标应为 staging、本地 docker、专用测试实例。
-
默认禁止探测云元数据。 除非本次任务明确将 SSRF 探测元数据列为目标且目标是你控制的,否则不要探测
169.254.169.254、metadata.google.internal、100.100.100.200、[fd00:ec2::254]或同类端点。agent 的浏览器工具可以从你自己的基础设施内部访问到这些地址——但不要这么做。 -
破坏性 payload 需要批准。 会 DROP/DELETE 的 SQLi payload、写文件的 SSTI、带
rm/shutdown/mkfs的命令注入,以及任何超出单条测试行范围的变更 → 先问再做。approval.py系统会拦截其中一部分;但不要仅依赖它。 -
辅助客户端泄露风险(Kopi Agent 特有)。 此 skill 会产生大量包含 SQLi/XSS/RCE payload、捕获的凭据、JWT token 的会话。Kopi Agent 的压缩和标题生成流程会将历史记录重放到辅助客户端(通常是主模型)。你写入对话的任何敏感内容都可能在下一次压缩时离开本机。缓解措施:
- 在将捕获的 token/凭据记录到任何消息中之前,将其脱敏为仅保留最后 6 个字符。完整值写入
engagement/evidence/文件,绝不进入聊天历史。 - 如果本次任务敏感,在会话的
~/.kopi/config.yaml中设置auxiliary.title_generation.enabled: false。
- 在将捕获的 token/凭据记录到任何消息中之前,将其脱敏为仅保留最后 6 个字符。完整值写入
-
自我限速。 对同一主机的主动请求之间默认间隔 200ms。recon-scan.sh 脚本会强制执行此规则。未经操作者批准,不要绕过它。
-
报告的效力边界。 此 skill 产出的是一份安全评估,而不是"通过"结论。即使全程干净,结论也应表述为"在时间 T 内、使用方法 Y、在范围 X 内未发现可利用问题"——而不是"该应用程序是安全的"。报告中的措辞要与此保持一致。
阶段 0:任务准备
在任何扫描开始之前,创建任务目录并记录授权确认。
ENGAGEMENT=engagement-$(date +%Y%m%d-%H%M%S)
mkdir -p "$ENGAGEMENT"/{evidence,findings,reports}
cd "$ENGAGEMENT"
-
向用户提问(原文照引):
"Confirm: (a) the target URL is [X], (b) you own this application or have written authorization to test it, and (c) the engagement may run for up to [N] hours starting now. Reply 'authorized' to proceed."
-
等待明确的
authorized回复。 任何其他回答都意味着停止。 -
将授权记录到
engagement/authorization.md,使用templates/authorization.md中的模板。包括:- 目标 URL 和 IP
- 授权依据(所有权 / 来自 $name 的书面授权)
- 任务时间窗口
- 范围外事项(生产环境、第三方服务等)
- 操作者姓名(驱动本次会话的用户)
-
构建 scope.txt:
localhost
127.0.0.1
staging.example.com
192.168.1.0/24 # internal lab only, with operator OK -
在发出第一个主动请求之前,阅读
references/scope-enforcement.md——该文档包含在每条命令/URL 发出前你都要应用的主机提取规则。
阶段 1:预侦察(代码分析,可选)
如果没有源代码访问权限(黑盒测试),请跳过此阶段。
如果你拥有应用源代码的读取权限:
- 梳理架构 — 框架、路由、中间件栈
- 清点 sink(敏感汇聚点) — 每个
execute(、os.system(、eval(、 模板渲染、文件读写、重定向目标 - 梳理认证机制 — 会话 cookie 还是 JWT、OAuth 流程、密码重置、 特权端点
- 识别信任边界 — 哪些需要认证,哪些不需要,
哪些来自
request.* - 从每个 sink 向请求来源做反向污点分析。当发现适当的净化措施时(参数化查询、允许列表、
shlex.quote、成熟的转义器),即可提前终止。
输出:evidence/pre-recon.md —— 架构图、sink 清单、
疑似存在漏洞的代码路径。
这是离线工作。不会向目标发送任何流量。
阶段 2:侦察(实时、只读)
映射攻击面。所有请求均为对公开页面的 GET 请求,暂不发送 载荷。仍然受范围约束。
-
验证范围。 将每个目标主机名解析为 IP。确认 IP 在范围内 (避免"DNS 指向意料之外的位置"的陷阱)。
-
网络面(仅在范围允许端口扫描时):
nmap -sT -T3 --top-ports 100 -oN evidence/nmap.txt $TARGET使用
-T3(默认),不要使用-T4/-T5。更隐蔽,且可避免在共享环境中 触发 IDS/IPS。 -
技术指纹识别:
whatweb -v $TARGET_URL > evidence/whatweb.txt
curl -sIk $TARGET_URL > evidence/headers.txt -
端点发现:
- 使用浏览器工具爬取应用(
browser_navigate、browser_get_images,跟随链接)。 - 检查
robots.txt、sitemap.xml、.well-known/*。 - 通过浏览器工具的开发者工具网络面板捕获 XHR/fetch 调用。
- 使用浏览器工具爬取应用(
-
认证面: 识别登录、注册、密码重置、 会话 cookie 名称、token 格式。暂时不要发送凭据 —— 仅做观察。
-
与预侦察结果关联(如果你有源代码)。对于每个
evidence/pre-recon.md发现,标记实时面是否 确认其可达。
输出:evidence/recon.md —— 端点、技术、认证模型、
输入向量。
阶段 3:漏洞分析
每个漏洞类别使用一个 delegate_task。每个 agent 读取
evidence/recon.md(如果有 evidence/pre-recon.md 则一并读取),使用 templates/exploitation-queue.json
生成 findings/<class>-queue.json。
使用 delegate_task 配合以下专项子 agent(尽可能并行):
| 类别 | 目标 | 参考 |
|---|---|---|
injection | SQL 注入、命令注入、路径遍历、SSTI、LFI/RFI、反序列化 | references/vuln-taxonomy.md(槽位类型) |
xss | 反射型、存储型、基于 DOM 的 | references/vuln-taxonomy.md(渲染上下文) |
auth | 登录绕过、JWT 混淆、会话固定、OAuth 缺陷 | references/exploitation-techniques.md |
authz | IDOR、垂直/水平越权、业务逻辑 | references/exploitation-techniques.md |
ssrf | 内部可达性、元数据、协议走私 | 除非明确授权,否则跳过元数据 |
infra | 错误配置、信息泄露、默认凭据、暴露的管理后台 | references/exploitation-techniques.md |
每个队列条目包含:id、漏洞类别、来源(如果已知则为 file:line)、
端点、参数、槽位类型、疑似防御措施、判定结果
(identified / partial / confirmed / critical)、见证载荷、
置信度(0-1)、备注。
分析阶段尚不发送恶意载荷 —— 仅准备它们。 利用阶段才会真正发出。
阶段 4:利用(基于证据,有条件执行)
仅在分析队列中存在可操作条目(identified 或 partial)
时,才为该类别运行子 agent。
对于每个候选项:
- 发送前检查 —— 主机在范围内吗?认证门槛满足了吗? 若为破坏性载荷,是否已获批准?
- 发送见证载荷 —— 最小化证明。SQL 注入:先
' AND 1=1--再' AND 1=2--。XSS:使用一个无害标记,例如<svg/onload=console.log("HERMES-PENTEST-XSS")>。在存储型 XSS 中绝不使用alert(1)—— 在共享环境中它会触发到其他用户。 - 验证见证载荷生效 —— 对于盲注入,使用 sleep
探测(
SLEEP(5))并测量响应时间。对于 SSRF,使用你自己 控制的测试者回调主机(在敏感项目中不要使用 webhook.site 之类的公共服务 —— 存在数据外泄路径风险)。 - 提升等级:
- L1 已识别 —— 模式匹配成功,无行为变化
- L2 部分 —— sink 被触及,但存在防御措施
- L3 已确认 —— 载荷以可观察的方式改变了应用行为
- L4 严重 —— 提取了数据、执行了代码、提升了权限
- 在判定为 FP 之前先穷尽绕过手段。 对于每个被阻断的候选项:
尝试至少
references/bypass-techniques.md中该类别的绕过集合。 仅当该集合穷尽后,才可写入verdict: false_positive。 - 为每个 L3/L4 记录证据:
- 完整请求(方法、URL、headers、body)
- 响应(状态码、headers、相关 body 摘录)
- 复现命令(curl 单行命令)
- 影响说明
输出:findings/exploitation-evidence.md
证据文件中的脱敏处理:
- 任何捕获到的凭据/token → 在聊天中仅保留最后 6 个字符;
完整值写入
findings/secrets-vault.md(已 gitignore)。 - 其他用户的 PII → 脱敏。
- 你自己的测试凭据 → 可以保留。
阶段 5:报告
使用 templates/pentest-report.md 生成最终报告。章节如下:
- 执行摘要
- 测试范围(来自
engagement/scope.txt) - 授权信息(来自
engagement/authorization.md) - 发现(仅限 L3/L4 —— 必须有证据)。每个发现包含:
- 标题、严重程度(CVSS 3.1)、CWE
- 受影响的端点
- 证据(请求 + 响应摘录)
- 复现步骤
- 影响
- 修复建议
- 未利用的候选项(L1/L2,附上关于阻断原因的备注)
- 范围外观察
- 方法论 / 使用的工具
- 局限性以及未测试的内容
严重程度策略: 仅对 L3/L4 使用 CVSS。L1/L2 标记为"待验证候选" —— 不要为未经验证的发现分配 CVSS。
何时停止
- 用户撤销了授权。
- 某个候选发现明显影响到生产数据,而你并未获准进行破坏性测试 —— 立即停止并询问。
- 目标开始返回 503/429 风暴 —— 退避,与操作者重新沟通确认。
- 你发现了超出约定范围的问题(例如,在测试某个无关端点时发现了一个暴露的客户数据库)。立即停止,做好记录,并向操作者报告。未经明确批准,不得转移测试目标 —— 这种擅自转移正是让渗透测试变成违法行为的关键。
本 Skill 不涵盖的内容
- 端口扫描之外的网络层渗透测试(不包括 Metasploit、Cobalt Strike、AD 攻击、网络协议 fuzzing)。
- 逆向工程 / 二进制分析(参见 issue #383)。
- 仅针对源代码的静态分析(参见 issue #382)。
- 主动社会工程 / 钓鱼攻击。
- 任何针对操作者未预先授权的系统的行为。
如果任务需要上述任何内容,请升级给专业渗透测试人员处理。本 skill 是对专业渗透测试的补充,而非替代。
延伸阅读
references/scope-enforcement.md— 如何为每个主动请求设定边界references/vuln-taxonomy.md— slot 类型、渲染上下文、OWASP 映射references/exploitation-techniques.md— 按漏洞类别划分的 payload 模式references/bypass-techniques.md— 常见的 WAF/过滤器绕过手法templates/authorization.md— 渗透测试授权模板templates/pentest-report.md— 最终报告模板templates/exploitation-queue.json— 按漏洞类别的发现队列 schemascripts/recon-scan.sh— 带速率限制的 nmap+whatweb+headers 封装脚本