每一项证据,都有源码可追溯。
每份报告都会注明固定的源码修订版本。报告记录的范围与版本信息,帮助你回查观察到了什么、如何收集,以及哪些信息仍然未知。
社区目录报告分析固定版本的目录元数据;只有明确标为固定源码报告的页面才记录了目标仓库代码检查。
阅读静态证据指南- 固定源码版本
记录精确的提交与文件路径。
- 记录分析范围
记录采集的输入与使用的方法。
- 阅读证据
结合限制理解每项观察。
固定修订版本
DSH Hunt 不把随时可能变化的分支 HEAD 作为永久证据。仓库可能在分析后发生变化;报告会持续保留当时观察到的精确提交,以完整的 40 字符 SHA 标识。
版本信息说明这次观察所使用的方法。具体字段取决于报告类型:
- 静态分析
- 分析器版本与分析配置
- 结构报告
- 采集器、策略与数据结构版本
分析器读取什么
当前静态分析配置使用一组明确限定的输入。每项声明层面的发现都保留对应的源码路径与定位信息。
| 输入 | 范围与记录的证据 |
|---|---|
| 包清单(Manifest) | 读取已声明的元数据,并为其支持的发现保留源码路径与定位信息。 |
| 已批准的补丁 | cordis.patch.yml。超出受支持配置的语法会暂缓处理,不会默认为有效。 |
| 根目录 README | 最多读取一个受支持的文件,上限为 64 KiB。分析器扫描安装与配置标题,只保存文件路径、Git Blob SHA、字节数,以及这两类标题是否存在。 |
| 选定的文件路径 | 通过目录树元数据记录选定的许可证与 Shell 文件路径是否存在,不读取文件内容。 |
此分析配置不执行代码
DSH Hunt 不执行第三方插件代码、生命周期脚本、安装程序或构建命令。
此静态分析配置不查询 npm Registry。如果采集精确版本的 Registry 元数据,会将其保存为带时间戳的独立观察记录;这不会验证包产物的字节内容或来源证明。
如何解读结果
- 能力信号
- 描述观察到的能力相关迹象,不是风险评分。
- 静态分析标签
- 统计当前规则覆盖的信号,不是安全或质量评级;未发现当前规则覆盖的信号,也不能证明包是安全的。
- 结构有效性
- 不能证明运行兼容性。静态分析不等于安全审计。
- 仓库元数据
- GitHub 仓库元数据会注明观察时间。阅读时,应将其与固定在源码提交上的证据区分开。
未知不等于不存在
未知(unknown)限制了报告能够证明的内容,并不意味着不存在或安全。请阅读字段的原因:“未读取”“未采集”和观察到不存在是不同的状态。未知也不同于检查失败。
同一份报告,不同的许可证来源
已批准的 Petdex 报告将包的源码固定到以下提交:
a1b229116968cbe9f3a9b2141634a9baa0819864- 包清单(Manifest)
- 未声明
license字段 - 同一 SHA 下的 LICENSE
- 独立许可证文件中写明 MIT
- 仓库许可证标记
- 仓库层面记录为 MIT
这些来源彼此独立。许可证文件和仓库标记都不能补充包清单中未声明的字段。
打开 Petdex 报告请核对完整 SHA、路径和 Blob SHA,并阅读覆盖范围与状态原因。如果源码与页面冲突,请通过更正链接提供当前值、建议值和一手来源。 状态模型与 指南说明了相关限制。这里不提供法律、运行或安全评估。
更正与申诉
更正始终关联其所修改的证据。接受更正与公开发布是两个独立步骤。
注明字段与来源
使用相关证据页面上的更正链接,提供字段、当前值、建议值,以及支持该更改的公开一手来源。
基于固定修订版本审查
接受的元数据更正会绑定到该份报告及其精确的源码提交。原始观察与审查原因仍可追溯。
经发布审查后公开
接受更正后会启动发布审查,这不意味着网站已经更新。只有发布上线且页面经过核查后,更正才算公开发布。
针对规则的误报申诉必须注明报告固定的提交。较新的提交属于另一个源码修订版本,不会抹去旧报告的观察结果。对于可复现的规则缺陷,会先添加有针对性的回归用例,再修改规则;修改会通过经过审查的报告发布生效。
选择公开报告渠道
所有 GitHub Issue 都是公开的。请勿包含密钥等机密信息、私有源码或敏感漏洞细节。
- 更正证据字段提供事实值及支持它的公开来源。
- 申诉误报分类针对报告固定提交上的规则结果提出申诉。
- 反馈分析方法提出关于采集、分析或解读的建议。
- 询问私密报告渠道此入口仅用于公开询问,请勿包含所关注问题的任何细节。
目前尚未核实任何私密安全报告渠道。询问渠道的 Issue 仍然公开,不会私密递交漏洞报告。
