离线单二进制 Web 应用,可导入 CycloneDX、SPDX 和 syft SBOM,运行 CVE 扫描器集成,使用 EPSS、CISA-KEV 和 nuclei 丰富发现结果,并导出 SARIF、CSAF 和 PDF。
一个单二进制、离线的 Web 应用,用于调查 SBOM(软件物料清单)文件。上传一个 SBOM 或导入一个包含多个 SBOM 的文件夹,使用一组独立工具对每个 SBOM 进行分析,在一个本地 UI 中查看规范化后的发现结果,并以八种格式导出结果。无需安装,无需网络访问,无遥测。
NOASSERTION 与单纯缺失的字段。主页(/)列出所有已存储的 SBOM,并且随着语料库增长仍保持可用:
log4j 或 openssl 的查询会找到所有包含该组件的 SBOM。查询长度有上限,并以宽松方式解析。/components 一次性在整个语料库中回答反向问题——我的哪些 SBOM 声明了此组件——可按组件名称或精确包 URL 查询。它读取在摄取时构建的专用组件索引,该索引与仪表板的全文索引相互独立。
因为过期的索引会让真正受影响的 SBOM 被读成“未受影响”,所以页面会说明还有多少 SBOM 尚未建立索引,并提供 Rebuild index,它只针对这些 SBOM 重新解析保留的字节。只有该警告消失后,搜索才算完整。
“已索引”意味着索引已构建,这与“已产生行”不是一回事:仅含元数据的 SBOM 不声明任何组件,因此不贡献任何行,但仍算完全索引。存储会按 SBOM 记录索引这一事实(schema v8,components_indexed_at),而不是根据行是否存在来推断——推断意味着无组件的 SBOM 永远无法离开“尚未索引”集合,于是该警告在每次重建后依然存在,按钮也永远把同样的 SBOM 报告为刚建立索引。升级会自动迁移,并为已有行的数据回填;再执行一次重建即可解决剩余部分。
每个工具在运行时都是可选的,并在 PATH 上检测(可用 SBA_TOOL_<NAME>_BIN 覆盖二进制文件)。发现结果从不依赖任何单一工具。每次扫描前,工具会以其版本参数启动一次:没有二进制文件意味着 skip(not found on PATH),而无法启动、或在 15 秒内没有给出答案的二进制文件意味着 fail,并附带该原因。
| 工具 | 角色 | 验证版本 |
|---|---|---|
| syft | SBOM 规范化器 / CycloneDX 1.6 转换器 | 1.52.0 |
| grype | CVE 匹配器 | 0.119.0 |
| trivy | 漏洞扫描器 | 0.74.0 |
| osv-scanner | OSV 数据库查询 | 2.4.0, 2.6.0 |
| bomber | 独立集成匹配器 | 0.5.1 |
| bomdrift | 供应链漂移 / 仿冒包(SARIF) | 0.9.9 |
| inspektr | SBOM 漏洞扫描器(JSON) | 0.1.9 |
| shieldbom | 离线嵌入式/IoT CVE 扫描器(SARIF) | 0.3.0 |
| provenant | 许可证 / 版权 / 来源(ScanCode) | 1.0.10 |
“验证版本”是每次调用实际使用的版本,既不是最低版本,也不是固定版本:工具在运行时从 PATH 解析,任何兼容版本均可工作。osv-scanner 列出两个版本,是因为 2.x 系列更改日志记录方式后重新验证了 2.6.0——文档中记录的 scan --lockfile <input> --format json 形式未变,且发现结果时仍以非零状态退出,因此无需更改代码。
前八个工具贡献 CVE 形态的漏洞发现;provenant 不同——它报告许可证、版权、持有者和作者来源信息,审计器会将其存储并作为自己的发现形态显示(每次运行一个“许可证与来源”部分,包含在 Markdown 导出中),而不是丢弃它。
扫描器无法直接读取所有格式:bomber 仅消费 CycloneDX ≤ 1.6,且所有扫描器都无法读取 SPDX 3.0 JSON-LD。在这两种情况下,审计器会先通过 syft convert 将输入规范化为 CycloneDX,并在 syft 不可用时以记录的原因跳过,而不是让工具报告零个包。grype 的漏洞数据库每次运行刷新一次(带外),因此常规的过期状态会触发一次全新扫描,而不是一次失败扫描。
分析后,每个 CVE 形态的发现都会用来自 vulnlookup 服务(默认 https://vulnlookup.ndaal.eu)的三个真实信号进行增强:
每个发现项都会显示其 KEV、Nuclei、EPSS 和 Source 值,其中 Source 会链接回 vulnlookup 记录,且发现项按最紧急优先排序:已知被利用(KEV)条目排在最前,其次是 EPSS 百分位较高的条目;没有富化信息的发现项保持分析器生成它们时的顺序。富化信息会进入每一种导出格式——SARIF 2.1 / 2.2、Markdown、ODT、DOCX、PDF 和 CSAF 2.1 / 2.2,其中 CSAF 将 EPSS 作为原生指标携带,并将 CISA-KEV 和 nuclei 记录为注释——并且导出表单现在默认勾选所有格式。
在 Settings → Vulnerability enrichment 下配置它:一个开/关切换(默认启用)以及最多三个 vulnlookup 源,每个源都有一个基础 URL、一个 TCP 端口和一个 QUIC 端口(端口留空视为 443)。源 1 和源 2 默认使用公共的 https://vulnlookup.ndaal.eu,端口为 443;源 3 默认使用回环地址 https://127.0.0.1,指向本机自己的 8680(TCP)/ 8681(QUIC)端口,因此同机部署的 vulnlookup 开箱即可作为可用的回退。这些源按顺序尝试——第一个是主源,其余是回退源。
查询由审计器的服务器进程发起,而不是由浏览器发起,因此运行它的主机自身必须能通过 HTTPS 访问该源:客户端仅使用 TLS 1.3,并信任操作系统的 CA 证书包。如果无法访问,每个发现项都会保持 Not enriched,而分析仍会完成,服务器日志会显示 post-analysis enrichment finished,并带有非零的 failed= 计数(如果客户端根本无法启动,则显示 post-analysis enrichment failed)。富化会在所有分析器完成后运行一次,因此各列会在运行完成后不久填充。
阅读结果时,请检查每个发现项匹配到的包。没有包的发现项上的 KEV 徽章——例如 affects fedora @ 40——来自与操作系统发行版的匹配,而不是已安装的包,通常并不适用。针对 Go 标准库报告的 CVE-2020-0601 也是同类不匹配:它是 Windows CryptoAPI 的缺陷,Go 在 1.13.6 中修复了它。
要在一个发现项上看到全部三种信号,请分析 ndaal_public_sbom_examples 仓库中的 jenkins:2.60.3 镜像 SBOM(example/anchore-sbom-examples/results/docker.io_library_jenkins:2.60.3/sbom/):Spring4Shell(CVE-2022-22965)和一个 Jenkins Stapler RCE(CVE-2018-1000861)各自都带有 KEV 徽章、一个 critical 级别的 nuclei 模板以及高于 0.98 的 EPSS。
GitLab 工作项 #2:SBOM 页面上的 Create CSAF document 会将某个 SBOM 的最新分析转换为一份 CSAF 2.1 咨询草稿(状态为 draft,版本为 0.1.0,跟踪 ID 为 ndaal-sba-draft- 加上该 SBOM 的 SHA-256 的前 16 个十六进制数字),并将其提交给 csaf-crud。Download CSAF draft 和 sbom-auditor --export-csaf <ID> 会生成相同的文件,但不提交。Settings → CSAF upload 卡片包含三个端点,按顺序尝试(csaf.ndaal.eu 两次,然后是位于 https://localhost:8180 的本机 csaf-crud),以及一个仅对回环端点信任自签名证书的选项。当 csaf-crud 返回 409 时,上传会替换同一 SBOM 的较早草稿。从未分析过的 SBOM 不会生成草稿,因为那会被解读为没有漏洞。
#![forbid(unsafe_code)];lint 策略在生产代码中禁止 panic 快捷方式、未检查的算术运算和未检查的索引。--encryption-key-file)。fail 并附上该原因,而不是显示为 not found on PATH 的 skip。--tls-key 会拒绝 PKCS#1 RSA 密钥(无 RSA 策略),并且在 Unix 上会拒绝组或其他用户可读的密钥文件。GET /export/download 仅提供具有可识别的导出或校验和附属文件扩展名的名称,因此配置错误的导出目录无法交出系统文件。cargo audit 检查干净。从 crates.io 安装已发布的版本 —— cargo install 会从源码构建,cargo binstall 会从 GitLab 发布页获取预构建的二进制文件:
cargo install sbom-auditor # build from source
cargo binstall sbom-auditor # prebuilt GitLab-release binary
或直接构建此检出(需要较新的稳定版 Rust 工具链):