如何用 Shannon 的 vuln_classes 只运行指定漏洞类别的扫描?

原创2026-09-08 19:33:531,961 阅读
文章标签:网络安全渗透测试应用安全人工智能AI Agent自主智能体CLI漏洞扫描流程编排

如何用 Shannon 的 vuln_classes 只运行指定漏洞类别的扫描?

Shannon 默认会把全部五个漏洞类别(injection、xss、auth、authz、ssrf)的分析与利用代理都跑一遍。如果你的目标应用主要是一类风险(比如只关心注入和 XSS),可以在配置文件里用 vuln_classes 把本次扫描限定到指定类别,让对应类别以外的 vuln/exploit 代理和报告章节直接跳过。下面的操作路径基于 配置文档 和 示例配置,适用于 npx 模式与源码构建(local)模式。

准备条件

按 README 的 Quick Start 要求,运行前需要:

  • Docker(worker 容器运行必需);
  • Node.js 18+(npx 工作流);
  • AI 提供商凭证(Anthropic、OpenAI、xAI 或 AWS Bedrock),可通过 npx @keygraph/shannon setup 交互式配置,或导出环境变量,例如 export ANTHROPIC_API_KEY=...;
  • 只能对自己拥有或已获得明确书面授权测试的目标运行——Shannon 会真实执行利用动作,不要指向生产系统。

编写包含 vuln_classes 的配置文件

从仓库自带的示例配置起步:

cp configs/example-config.yaml ./my-app-config.yaml

在 example-config.yaml 中,vuln_classes 是可选键,默认注释掉的写法为:

# Limit which vulnerability classes run end-to-end (optional, default: all five)
# vuln_classes: [injection, xss, auth, authz, ssrf]

取消注释并改成你要运行的类别子集,例如只保留注入和 XSS:

description: "Local dev environment — .env files contain local-only credentials, not deployed to production."

# 只运行指定的漏洞类别;省略此键则默认运行全部五个类别
vuln_classes: [injection, xss]

根据 config-schema.json 中的 JSON Schema,这个键有几个硬性约束,配置会被 config-parser.ts 按 Schema 校验:

  • 每个值只能是 injection、xss、auth、authz、ssrf 之一,写错枚举值会校验失败;
  • 至少 1 项(minItems: 1),最多 5 项(maxItems: 5);
  • 不允许重复(uniqueItems: true)。

Schema 对它的行为描述是:省略时五个类别全部运行;设置后只运行列出的类别,只有这些类别的 vuln+exploit 代理和报告章节会参与本次扫描。也就是说 vuln_classes 控制的是整条扫描范围,而不是对报告做事后过滤——过滤报告内容用 report 选项。

如果同时想跳过利用阶段,可以加上 exploit: "false"(字符串,不是布尔值),此时被选中的类别只跑分析、不跑利用代理。

用 -c 参数启动扫描

配置写好后,通过 start 命令的 -c 参数传入:

# npx 模式(/path/to/repo 替换为目标仓库路径,-u 替换为目标 URL)
npx @keygraph/shannon start -u https://example.com -r /path/to/repo -c ./my-app-config.yaml

源码构建模式的等价命令:

./shannon start -u https://example.com -r /path/to/repo -c ./my-app-config.yaml

建议同时用 -w <name> 给运行命名,例如 -w my-audit。命名工作区在 npx 模式下存于 ~/.shannon/workspaces/,源码构建模式下存于 ./workspaces/,详见 工作区文档。

验证扫描只运行了指定类别

工作流启动后会在日志里记录本次运行范围,格式为(文档示例,方括号内内容取决于你的配置):

Run scope: vuln_classes=[injection, xss] exploit=true

未选中的类别会被工作流明确跳过,例如 Skipping ssrf pipeline (class not selected this run)(见 workflows.ts 中的跳过逻辑)。扫描过程中可以用 ./shannon logs <workspace> 查看该运行的实时日志,./shannon workspaces 列出所有工作区。

运行结束后,最终报告在工作区根目录以 Security-Assessment-Report.md 输出,其余交付物、日志和会话状态在隐藏目录 .shannon/ 下。按 Schema 的说明,报告只会包含你选中的类别对应的章节——如果报告里出现了你没选类别的内容,说明配置没有按预期生效,应先检查 -c 指向的文件是否是你以为的那份。

限制:恢复运行不能改变类别范围

首次运行时,vuln_classes 和 exploit 的范围会被锁定进工作区的 session.json。之后用同一个 -w 名称恢复运行(resume)时,必须与首次运行的范围完全一致,否则 activities.ts 中的 persistOrValidateRunScope 会抛出 ScopeMismatchError 并拒绝继续:

Resume scope mismatch for workspace <sessionId>.
  Original: vuln_classes=[...], exploit=...
  Provided: vuln_classes=[...], exploit=...
Resume requires the same scope as the original run. Start a new workspace if you want different scope.

所以想换一组漏洞类别,不要复用旧工作区名称,直接用新的 -w 名称(或自动命名)开一次新扫描即可。

登录后查看全文
shannon