夜雨聆风学习资料网

ARTICLE · 1385484

SBOM 还在手搓 Excel?让 SPDX 跟着每次出码自动生成,字段一个都不漏

SBOM 还在手搓 Excel?让 SPDX 跟着每次出码自动生成,字段一个都不漏

🔗 184 咱们说过 SBOM 得从生成代码这层就建起来,把开源库、供应商二进制、工具链三组组件理清楚;194 接着聊了许可证合规,尤其 GPL 静态链接的传染风险。那两篇解决的是"清单里该有什么、哪些库碰不得"。可真到交付,客户或监管一句话"把 SBOM 发过来",不少团队翻出的还是一张手维护的 Excel——谁填的、哪天的、跟这版固件对不对得上,全靠人记。今天把最后一公里补上:让这份清单变成机器可读的标准文档,跟着每次构建自动生成。

一、手写必然烂尾,别跟它较劲

先给个判断:手维护的 SBOM,一天之内就是错的。一个真实项目几百个传递依赖,版本、许可证、哈希每次更新都在变,靠人同步根本追不上。更麻烦的是它跟你实际编进固件的东西没有绑定关系——表上写着 A 库 1.2,产线烧的可能是 1.3,出了事谁也说不清。

正确姿势就一条:把 SBOM 当成 build step,从真实产物生成,随每次发布一起出。表不是给人填的,是给工具读的;模板的价值在于让你看得懂生成结果、检查它全不全,而不是拿它来写。

那"机器可读"用哪个格式?汽车圈交付、许可证合规场景下,绕不开 SPDX 2.3——它是 ISO/IEC 5962 标准,许可证字段最细。安全/漏洞场景常用的 CycloneDX 是另一套,客户没指定时先问清楚,别自作主张发错格式。

二、SPDX 2.3 到底长啥样,字段级拆开看 🔍

SPDX 有两种形态:tag-value(老派、一行一个字段、好读)和 JSON(新工具链首选)。文档头 + 每个组件一段,就这么机械。看个 tag-value 骨架:

SPDXVersion: SPDX-2.3
DataLicense: CC0-1.0
SPDXID: SPDXRef-DOCUMENT
DocumentName: ecu_app-2.1.0-sbom
DocumentNamespace: https://example.com/spdx/ecu_app/2.1.0
Creator: Tool: syft-1.16.0
Creator: Organization: Acme Corp
Created: 2026-05-06T12:00:00Z

PackageName: ecu_app
SPDXID: SPDXRef-Package-ecuapp
PackageVersion: 2.1.0
PackageDownloadLocation: NOASSERTION
FilesAnalyzed: false
PackageLicenseConcluded: Apache-2.0
PackageLicenseDeclared: Apache-2.0
PackageChecksum: SHA256: 9f86d081...
ExternalRef: PACKAGE-MANAGER purl pkg:generic/ecu_app@2.1.0
Relationship: SPDXRef-DOCUMENT DESCRIBES SPDXRef-Package-ecuapp

几个字段值得拎出来:

  • DocumentNamespace 每个版本一个唯一 URI,是这份 SBOM 的身份证;
  • PackageLicenseConcluded 是最终判定的许可证,PackageLicenseDeclared 是组件自己声明的,两者不一致时就该人工看了;
  • ExternalRef 里的 purl(pkg:...)是全工具链通用的组件标识,漏洞匹配全靠它唯一定位;
  • PackageChecksum 打的是组件或固件的 SHA-256,SBOM 和二进制同源就靠这行。

📌 对齐 NTIA 的最小要素:供应商、组件名、版本、唯一标识、许可证、依赖关系、哈希,七个字段每个组件都得有,缺一个这份 SBOM 就不算合格。

三、许可证表达式和 NOASSERTION,是合规真正咬合的地方

SPDX 是许可证 ID 的标准来源,licenseConcluded 不是只能填单个值,它支持表达式:

MIT OR Apache-2.0
(MIT AND BSD-3-Clause) OR GPL-2.0-only WITH Classpath-exception-2.0
LicenseRef-AcmeProprietary

双许可、带例外的组合都能如实写。自家闭源库用 LicenseRef- 自定义,配 hasExtractedLicensingInfos 把许可正文带上。

最容易埋雷的是 NOASSERTION——意思是"没判定出来",三个来源:组件没 checkout(CI 浅克隆常见)、没有 LICENSE 文件、文件没匹配上任何已知模式又没有 override。呼应 194 那篇:匹配要先把 copyleft(GPL/LGPL/AGPL)排在宽松许可前面,否则一段 GPL 文本被 MIT 关键字抢先命中,就成假阴性了。 shipped 固件的 SBOM 里 NOASSERTION 要清零(补 override 或人工判定),纯构建期依赖(比如编固件用的 Python 包)留着 NOASSERTION 可以接受。

四、Relationships 把"谁编进了固件"说清楚

清单列完组件还不够,SPDX 用 relationships 描述依赖图,几个关系类型直接对应合规结论:

DESCRIBES / DESCRIBED_BY     文档 → 顶层包
CONTAINS / CONTAINED_BY      容器 → 被编进去的包
BUILD_DEPENDENCY_OF          只在构建期用到,没进固件
STATIC_LINK / DYNAMIC_LINK   链接方式
GENERATED_FROM               由哪个源生成

⚠️ 这里跟 194 的 GPL 判定是连着的:静态链接进固件的包和构建期工具责任完全不同,前者要扛传染义务,后者基本不用。SBOM 里关系写错,等于合规结论写错,评审一问就露馅。

五、接进 CI,三步落地 🔧

不扯流程,直接给能改的骨架。以 syft 扫描 + spdx-tools 校验为例:

# 1. 从出码目录/镜像生成 SPDX JSON(别只扫仓库根,生成代码目录要单独喂)
syft dir:./ecu_app_ert_rtw -o spdx-json > sbom.spdx.json

# 2. 结构 + 许可证表达式语法校验
pyspdxtools --infile sbom.spdx.json --version SPDX-2.3

# 3. 把固件 ELF 的 SHA-256 回填进 PackageChecksum,SBOM 与二进制绑定
sha256sum ecu_app.elf

门禁三件事就够:NOASSERTION 非零直接 fail(ship 前必须清零)、copyleft 组件出专门告警、SBOM 作为 release artifact 跟固件一起归档。GitHub Actions 里用 anchore/sbom-action 指定 format: spdx-json 能省掉第一步手写。

几个坑顺手记一下:FilesAnalyzed: false 时别指望文件级许可证结论;DocumentNamespace 建议由排序后的组件键哈希派生,别用构建时间戳,否则每次生成都产生一堆无意义 diff;PX4 那套 --verify-licenses 的思路值得抄——一个命令把所有子模块的判定结果打表,没 override 的 NOASSERTION 直接非零退出,EU CRA 要求的"零 NOASSERTION"就是这么卡出来的。

收个尾

从 184 的"该记哪些组件",到 194 的"哪些库碰不得",再到这篇"怎么让工具每次自动生成、字段一个不漏",SBOM 这条线才算闭环。说到底一句话:别把合规做成台账,做成产物。清单跟着构建走,客户要的时候直接发这版固件对应的那份,谁也不用临时翻 Excel。

工具能扫全依赖、能卡住 NOASSERTION,可某个库到底算不算进固件、双许可选哪条、LicenseRef 的正文谁来签字,还得工程师拍板,别把判断全交给扫描器。

好了,这批就到这,感兴趣的小伙伴多多关注转发,有问题欢迎留言。后面想聊的方向记进清单了(SPDX 3.0 的 profile、CycloneDX 与 VEX 的配合、SBOM 挂需求追溯),随时接着开。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料