跳到主要内容

Web 渗透测试

经授权的 Web 应用程序渗透测试——涵盖信息收集、漏洞分析、基于证据的漏洞利用与专业报告。改编自 Shannon 的"无利用,不报告"方法论,并对范围、授权和辅助客户端泄露设置了严格的防护栏。仅对你拥有或已获得书面授权的运行中的应用程序进行主动测试。

Skill 元数据​

SourceOptional — install with kopi skills install official/security/web-pentest
Pathoptional-skills/security/web-pentest
Platformslinux, macos

参考:完整 SKILL.md​

信息

以下是触发此 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 激活时 agent 所看到的指令。

Web 应用程序渗透测试

针对运行中 Web 应用的分阶段渗透测试工作流。改编自 Shannon 的流水线(Keygraph,AGPL——仅借鉴概念,未借用任何代码)。围绕三条规则构建:

  1. 无利用,不报告——每一条发现都必须附带可复现的证据。
  2. 范围受限——每一次主动请求都必须指向操作者预先声明的目标。拒绝访问范围之外的主机。
  3. 先穷尽绕过手段,再判定为误报——一个"被拦截"的 payload 在你尝试完绕过集合之前,并不等于安全无虞。

⚠️ 严格防护栏——每次执行任务前必读​

违反其中任何一条都会导致本次测试失效,并且可能违法。

  1. 授权关口。 在会话中执行第一次主动扫描之前,你必须以书面形式与用户确认:该用户拥有目标的所有权或已获得书面测试授权。将该确认记录到 engagement/authorization.md 中(见模板)。没有确认 → 不进行主动扫描。用 curl 读取公开页面没问题;发送 payload 则不可以。

  2. 范围白名单。 维护 engagement/scope.txt——每行一个主机名或 CIDR。每一个 nmap、curl、whatweb、浏览器导航或携带 payload 的请求必须指向 scope 中的条目。如果目标将你重定向到范围之外(3xx 到不同主机、HTML 中的链接),停止并先与用户确认再继续。

  3. 没有书面文件就不碰生产环境。 如果用户没有明确告诉你"是的,生产环境在范围内,且我有书面批准",就默认不在范围内。默认目标应为 staging、本地 docker、专用测试实例。

  4. 默认禁止探测云元数据。 除非本次任务明确将 SSRF 探测元数据列为目标且目标是你控制的,否则不要探测 169.254.169.254、metadata.google.internal、100.100.100.200、[fd00:ec2::254] 或同类端点。agent 的浏览器工具可以从你自己的基础设施内部访问到这些地址——但不要这么做。

  5. 破坏性 payload 需要批准。 会 DROP/DELETE 的 SQLi payload、写文件的 SSTI、带 rm/shutdown/mkfs 的命令注入,以及任何超出单条测试行范围的变更 → 先问再做。approval.py 系统会拦截其中一部分;但不要仅依赖它。

  6. 辅助客户端泄露风险(Kopi Agent 特有)。 此 skill 会产生大量包含 SQLi/XSS/RCE payload、捕获的凭据、JWT token 的会话。Kopi Agent 的压缩和标题生成流程会将历史记录重放到辅助客户端(通常是主模型)。你写入对话的任何敏感内容都可能在下一次压缩时离开本机。缓解措施:

    • 在将捕获的 token/凭据记录到任何消息中之前,将其脱敏为仅保留最后 6 个字符。完整值写入 engagement/evidence/ 文件,绝不进入聊天历史。
    • 如果本次任务敏感,在会话的 ~/.kopi/config.yaml 中设置 auxiliary.title_generation.enabled: false。
  7. 自我限速。 对同一主机的主动请求之间默认间隔 200ms。recon-scan.sh 脚本会强制执行此规则。未经操作者批准,不要绕过它。

  8. 报告的效力边界。 此 skill 产出的是一份安全评估,而不是"通过"结论。即使全程干净,结论也应表述为"在时间 T 内、使用方法 Y、在范围 X 内未发现可利用问题"——而不是"该应用程序是安全的"。报告中的措辞要与此保持一致。


阶段 0:任务准备​

在任何扫描开始之前,创建任务目录并记录授权确认。

ENGAGEMENT=engagement-$(date +%Y%m%d-%H%M%S)
mkdir -p "$ENGAGEMENT"/{evidence,findings,reports}
cd "$ENGAGEMENT"
  1. 向用户提问(原文照引):

    "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."

  2. 等待明确的 authorized 回复。 任何其他回答都意味着停止。

  3. 将授权记录到 engagement/authorization.md,使用 templates/authorization.md 中的模板。包括:

    • 目标 URL 和 IP
    • 授权依据(所有权 / 来自 $name 的书面授权)
    • 任务时间窗口
    • 范围外事项(生产环境、第三方服务等)
    • 操作者姓名(驱动本次会话的用户)
  4. 构建 scope.txt:

    localhost
    127.0.0.1
    staging.example.com
    192.168.1.0/24 # internal lab only, with operator OK
  5. 在发出第一个主动请求之前,阅读 references/scope-enforcement.md——该文档包含在每条命令/URL 发出前你都要应用的主机提取规则。


阶段 1:预侦察(代码分析,可选)​

如果没有源代码访问权限(黑盒测试),请跳过此阶段。

如果你拥有应用源代码的读取权限:

  1. 梳理架构 — 框架、路由、中间件栈
  2. 清点 sink(敏感汇聚点) — 每个 execute(、os.system(、eval(、 模板渲染、文件读写、重定向目标
  3. 梳理认证机制 — 会话 cookie 还是 JWT、OAuth 流程、密码重置、 特权端点
  4. 识别信任边界 — 哪些需要认证,哪些不需要, 哪些来自 request.*
  5. 从每个 sink 向请求来源做反向污点分析。当发现适当的净化措施时(参数化查询、允许列表、 shlex.quote、成熟的转义器),即可提前终止。

输出:evidence/pre-recon.md —— 架构图、sink 清单、 疑似存在漏洞的代码路径。

这是离线工作。不会向目标发送任何流量。


阶段 2:侦察(实时、只读)​

映射攻击面。所有请求均为对公开页面的 GET 请求,暂不发送 载荷。仍然受范围约束。

  1. 验证范围。 将每个目标主机名解析为 IP。确认 IP 在范围内 (避免"DNS 指向意料之外的位置"的陷阱)。

  2. 网络面(仅在范围允许端口扫描时):

    nmap -sT -T3 --top-ports 100 -oN evidence/nmap.txt $TARGET

    使用 -T3(默认),不要使用 -T4/-T5。更隐蔽,且可避免在共享环境中 触发 IDS/IPS。

  3. 技术指纹识别:

    whatweb -v $TARGET_URL > evidence/whatweb.txt
    curl -sIk $TARGET_URL > evidence/headers.txt
  4. 端点发现:

    • 使用浏览器工具爬取应用(browser_navigate、 browser_get_images,跟随链接)。
    • 检查 robots.txt、sitemap.xml、.well-known/*。
    • 通过浏览器工具的开发者工具网络面板捕获 XHR/fetch 调用。
  5. 认证面: 识别登录、注册、密码重置、 会话 cookie 名称、token 格式。暂时不要发送凭据 —— 仅做观察。

  6. 与预侦察结果关联(如果你有源代码)。对于每个 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(尽可能并行):

类别目标参考
injectionSQL 注入、命令注入、路径遍历、SSTI、LFI/RFI、反序列化references/vuln-taxonomy.md(槽位类型)
xss反射型、存储型、基于 DOM 的references/vuln-taxonomy.md(渲染上下文)
auth登录绕过、JWT 混淆、会话固定、OAuth 缺陷references/exploitation-techniques.md
authzIDOR、垂直/水平越权、业务逻辑references/exploitation-techniques.md
ssrf内部可达性、元数据、协议走私除非明确授权,否则跳过元数据
infra错误配置、信息泄露、默认凭据、暴露的管理后台references/exploitation-techniques.md

每个队列条目包含:id、漏洞类别、来源(如果已知则为 file:line)、 端点、参数、槽位类型、疑似防御措施、判定结果 (identified / partial / confirmed / critical)、见证载荷、 置信度(0-1)、备注。

分析阶段尚不发送恶意载荷 —— 仅准备它们。 利用阶段才会真正发出。


阶段 4:利用(基于证据,有条件执行)​

仅在分析队列中存在可操作条目(identified 或 partial) 时,才为该类别运行子 agent。

对于每个候选项:

  1. 发送前检查 —— 主机在范围内吗?认证门槛满足了吗? 若为破坏性载荷,是否已获批准?
  2. 发送见证载荷 —— 最小化证明。SQL 注入:先 ' AND 1=1-- 再 ' AND 1=2--。XSS:使用一个无害标记,例如 <svg/onload=console.log("HERMES-PENTEST-XSS")>。在存储型 XSS 中绝不使用 alert(1) —— 在共享环境中它会触发到其他用户。
  3. 验证见证载荷生效 —— 对于盲注入,使用 sleep 探测(SLEEP(5))并测量响应时间。对于 SSRF,使用你自己 控制的测试者回调主机(在敏感项目中不要使用 webhook.site 之类的公共服务 —— 存在数据外泄路径风险)。
  4. 提升等级:
    • L1 已识别 —— 模式匹配成功,无行为变化
    • L2 部分 —— sink 被触及,但存在防御措施
    • L3 已确认 —— 载荷以可观察的方式改变了应用行为
    • L4 严重 —— 提取了数据、执行了代码、提升了权限
  5. 在判定为 FP 之前先穷尽绕过手段。 对于每个被阻断的候选项: 尝试至少 references/bypass-techniques.md 中该类别的绕过集合。 仅当该集合穷尽后,才可写入 verdict: false_positive。
  6. 为每个 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 生成最终报告。章节如下:

  1. 执行摘要
  2. 测试范围(来自 engagement/scope.txt)
  3. 授权信息(来自 engagement/authorization.md)
  4. 发现(仅限 L3/L4 —— 必须有证据)。每个发现包含:
    • 标题、严重程度(CVSS 3.1)、CWE
    • 受影响的端点
    • 证据(请求 + 响应摘录)
    • 复现步骤
    • 影响
    • 修复建议
  5. 未利用的候选项(L1/L2,附上关于阻断原因的备注)
  6. 范围外观察
  7. 方法论 / 使用的工具
  8. 局限性以及未测试的内容

严重程度策略: 仅对 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 — 按漏洞类别的发现队列 schema
  • scripts/recon-scan.sh — 带速率限制的 nmap+whatweb+headers 封装脚本