CodeScan 实战(17):下一步接入 SDL:从旁路 Hook 到可审计门禁

系列目录 · 第 17 篇

前面的改造围绕单个审计任务展开。下一步,如果要扩展为 SDL 平台,入口就不该只有人工上传压缩包:代码提交、合并请求和构建事件,都可以成为审计触发点。

我的倾向是先旁路挂靠现有 CI/CD,通过 Hook 接收事件,异步运行并反馈建议。本文是后续设计,不是已交付功能;当前不能据此调用一个假定存在的 Webhook 或合并门禁接口。

0x01 先接入开发过程,再考虑阻断

初期不替换运维已有流水线。现有 CI 继续负责构建、测试与发布,CodeScan 接收变更身份和最小必要材料,产生带证据的安全建议。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
代码平台 / 现有 CI
│ 提交或合并请求事件
↓
事件接入:签名、时间、幂等、权限
↓
只读变更快照:仓库 / base / head / 构建身份
↓
范围判断与排队
↓
增量建模 / 入口权限复核 / 代码审计
↓
证据与独立复核
↓
异步回写状态、报告链接与修复建议

这条链路的第一目标是可解释、可追踪、能退出。没有效果基线就直接阻断合并,很容易把模型不可用变成开发流程不可用。

0x02 Hook 接进来的首先是身份问题

事件接入需要验签、时间窗口与重放防护,使用稳定事件 ID 幂等去重。不能仅相信 JSON 里自报的仓库地址、分支名和操作者。

真正创建任务前,应确认仓库授权、触发者权限、base/head 提交及材料摘要。报告绑定具体提交,避免变更更新之后,旧报告仍被展示成当前结果。

下面只是概念载荷,不是现有接口协议:

1
2
3
4
5
6
7
8
{
"event_id": "example-event-001",
"repository_id": "example-repository",
"base_commit": "<base-sha>",
"head_commit": "<head-sha>",
"pipeline_run_id": "example-run-001",
"requested_profile": "changed-code-review"
}

凭据通过平台受控配置提供,不放进事件正文、源码包或模型上下文。

0x03 增量审计不能只看 diff

diff 适合决定优先级,却不总是足够判断漏洞。一个控制器删除了权限校验,需要读上游认证链;一个公共函数变更,可能影响多个没有出现在 diff 里的调用方。

可以先从变更函数扩展到调用关系、路由、权限、配置和依赖,再把读过的范围记入覆盖账本。无法解析动态调用时明确标记缺口,不把“diff 已审”显示成“全仓已审”。

架构、部署、依赖或信任边界变化时,应触发相关模型复核。普通局部修复则优先复用仍然匹配的模型与证据,避免每个提交都重新跑全仓。

SAST、SCA、密钥扫描和 SARIF 可以作为候选输入,但来源工具的告警不是本项目已经独立确认的漏洞。

0x04 CI 状态要区分质量与运行故障

建议将审计质量结果和运行状态分开表达:

情况 对开发者的含义
发现且完成复核 展示证据、影响、修复与对应提交
有候选但材料不足 需要人工验证,列明缺口
模型服务故障、预算耗尽、依赖缺失 未完成评估,不能标“安全通过”
当前范围未发现问题 只对本次已检查范围负责

是否允许合并,由组织选择的策略处理。基础设施故障可以按明确策略放行并留痕,也可以要求人工审批,但不能在审计结果里伪装成零风险。

如果采用知识库快速查询,“未匹配已知风险”也只能说明查询结果,不能证明本次变更没有新漏洞。

0x05 复现和修复要放到独立权限域

源码、注释、README 和依赖内容都是不可信输入。接入 CI 后,它们不能因为来自仓库,就有权指挥智能体读取 CI 密钥、发送请求或修改流水线。

默认审计保持静态。后续若增加执行型验证,应使用隔离环境、固定镜像、最小网络与凭据权限,绑定漏洞版和修复版,并保留成功判据、阴性对照、原始记录与清理结果。

当前的本地操作员执行记录不能自动推广为生产可达性证明;给报告签名,也不能代替目标版本和部署身份核验。

0x06 建议按三个阶段推进

第一阶段完成旁路事件接入、提交归属、排队预算、异步报告和审计日志,只输出建议。先用真实项目统计有效发现、误报、未知比例、耗时和成本。

第二阶段增加人工确认、责任人、修复时限、例外审批与复测。基于同根因变体、正负样例和漏洞版/修复版验证,校准可信度。

第三阶段只对已经验证稳定的风险和范围启用门禁,明确超时、故障和例外策略;保留人工接管与回退能力。

这些步骤仍有工作要做:Webhook、SARIF 导入、CI 状态回写、自动修复与合并拦截,本系列没有将其写成已实现模块。当前最先要补的,仍是上一轮候选版的集成回归和真实任务效果基线。

上一篇:中间产物清理 · 返回系列目录

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