CodeScan 实战(03):补齐审计覆盖、反证和收官门禁

系列目录 · 第 03 篇

漏洞列表能展示已经发现的问题,却没有说明未出现的部分发生了什么:是审过没有发现,还是根本没有检查?

这一轮我把重点放到覆盖账本和收官条件上。规划者可以继续派发任务,但最后一句“目标已完成”需要有可检查的依据。

0x01 外部方法怎么用

当次定向研究了 Cloudflare security-audit-skill、Trail of Bits skills、Anthropic security review、Shannon、Vulnhuntr 和 CyberGym。

它们带来的共同启发是:先理解上下文与约束,明确检查范围,主动寻找反证,并把运行观测和模型判断分开。

我没有把它们的默认规则整体照搬。例如,按文本模式忽略某些资源耗尽问题,可能会漏掉当前系统真正关心的风险。迁移方法前,先看目标项目的业务边界。

0x02 先给覆盖建立分母

audit/coverage.go 在宿主侧枚举上传源码,生成包含相对路径、长度、类型和摘要的清单。

隐藏配置、CI 文件和实际的构建产物同样可能影响安全。是否排除,需要给出范围依据;不能仅看见 dist、test 或 vendor 目录名就跳过。

文件状态区分:

状态 用途
pending 尚未获得足够检查记录
reviewed 有已完成的语义检查及核验引用支持
excluded 明确排除,并保留原因

遗漏的文件仍保持待审。排除项单列,也不会被加进“已审文件数”。

0x03 文件覆盖还不够

一个授权函数可能影响读取、删除、恢复和后台补偿等多条路径。读完文件,只能说明拿到了内容;需要检查的安全不变式还没有自动完成。

因此,账本进一步记录:

1
真实入口 × 信任边界 × 子系统 × 攻击类别 × 生命周期

例如,“租户对象读取”这一项,要说明入口如何确定、身份从哪里来、对象归属在哪里检查、跨文件查询是否保留租户条件,以及哪些未知事实会改变结论。

一项检查可以保持 planned、blocked 或 not_applicable。这些状态都有用途,尤其是在依赖源码或部署条件缺失时。

0x04 证据链要解释每一跳

这轮给 audit_case.reasoning 加入逐跳传播说明。相邻两个引用之间,需要解释调用、赋值、参数或权限上下文如何延续。

接着检查可能推翻判断的因素:

  • 路由之外是否还有统一鉴权或网关约束?
  • 参数转换是否改变了攻击者可控范围?
  • ORM、序列化器、拦截器或依赖代码里是否有关键保护?
  • 当前假设的角色、资源或租户条件是否真实?

反证没有找到,不代表已经证明不存在。缺少上游源码时,应把问题留在未知项里,并给出下一步核验计划。

同根因变体检查也要记录实际范围和逐项结果,避免把几个相似关键词当成全仓审计。

0x05 收官由当前材料决定

最后一个目标准备完成时,程序核对源码清单、模型绑定、覆盖单元、漏洞材料和报告版本。

Agent 可以用 get_audit_gate 查看缺口。材料仍允许保存和导出,但未清除的必需缺口会阻止“全部完成”的判定。

ready_for_review 表示材料达到交付复核条件。漏洞是否成立、PoC 是否实际执行,以及生产入口是否可达,仍需要对应证据。

0x06 给 PoC 一个更具体的判据

普通正文标记有时会被接口原样反射。这轮增加 JSON Pointer 判据,例如:

1
2
3
4
5
6
7
{
"oracle": {
"kind": "json_value",
"pointer": "/owner/id",
"equals": "fixture-victim"
}
}

只有指定位置的值满足条件才算命中。解析失败、重复键、截断,以及阴性对照同样命中,都不能升级为有效观测。

即便命中了字段值,还要解释主体和资源关系。判据负责描述观测,漏洞语义由独立复核判断。

0x07 这一轮怎么验收

回归关注清单变化、并发版本比较、任务归属、报告过期、归档恢复和最后目标门禁。它们验证工程约束,没有测量真实仓库的检出率或误报率。

源码入口:audit/coverage.go、audit/delivery.go、agent/audit_coverage.go。

上一篇:三个项目的集成 · 下一篇:建模生命周期

http://www.pa55w0rd.online/codescan-03/