跟踪标记审查门

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

审查分支、拉取请求、发布差异或修复提交 检查更改是否扩大了攻击面 寻找可访问路径上已删除的验证或授权 比较污点、权限边界、爆炸半径或复杂性信号之前/之后

何时不使用

单快照分析。使用trailmark或trailmark-structural。仅文本差异审查。使用differential-review。全面的漏洞发现。使用审核或错误查找工作流程。一项静态发现。使用trailmark-finding-triage。工具不可用,用户只需要手动审核。

拒绝的理由

合理化 · 错误的原因 · 所需的操作 “行差异很小,因此不需要图门” · 小改动可以创建新的调用路径 · 比较图之前/之后“图门已通过,因此 PR 是安全的” · 门仅检查结构回归 · 仍然执行行级别审查 “Trailmark 失败,因此通过门” · 工具失败是未知风险,而不是成功 · 发出 UNKNOWN “测试通过,因此删除验证很好” · 测试可能会错过受影响的入口点路径 · 手动查看已删除的路径

第 2 步:建立图表证据

在图形分析之前/之后运行graph-evolution或等效的Trailmark。两个快照都必须运行engine.preanalysis(),以便污点、特权边界、爆炸半径、复杂性和入口点信号可用。记录 Trailmark 版本和任何功能探测。如果图构建失败,则发出UNKNOWN。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:解析输入

接受两个引用、一个分支名称、一个提交范围或之前/之后目录。不必要时不要检查分支。首选 `git diff`、`git show` 和 git 工作树,遵循 `graph-evolution` 快照工作流程。

02
第 2 步:建立图表证据

在图形分析之前/之后运行 `graph-evolution` 或等效的 Trailmark。两个快照都必须运行`engine.preanalysis()`,以便污点、特权边界、爆炸半径、复杂性和入口点信号可用。记录 Trailmark 版本和任何功能探测。如果图构建失败,则发出`UNKNOWN`。

03
第 3 步:使变更正常化

将证据规范化为: 添加、删除和修改的节点 添加和删除的边 入口点集更改 污点成员资格更改

04
第 4 步:应用 Gate 规则

应用references/gate-rules.md 中的规则。门判定为: 判定 · 含义 `FAIL` · 高风险结构回归在接受之前需要审查 `WARN` · 有意义的图形更改需要审阅者注意

05
第 5 步:发出数据包

使用references/output-format.md编写数据包,然后将其交给分支审阅者。将此数据包与`differential-review`或其他 PR 审核流程结合使用时,请使用引用/review-integration.md。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。