简介——从代码到证书
起点、需要完成的几个步骤、终点。获得 CRA 证书的最短路径。
起点
您的软件、它的自动化测试,以及即将交付的一个版本。
终点
该版本的一份 CRA 证书:包含其需求、测试、软件物料清单(SBOM)和已知漏洞,经过封存,任何人都可以在 qatrax.dev/verifier 上核验。
五个步骤
1. 开通您的空间 —— 创建账户:十天免费试用,无需银行卡。
2. 创建您的密钥 —— 在您的空间中:项目标签页,CI 密钥一栏。请妥善保密;该密钥只对您的项目有效。
3. 只需一次:您的需求 —— 需求标签页。三种来源,可组合使用: CRA 目录(附件一,导入按钮)、您的测试计划(开发+测试计划标签页, 校验并导入按钮),或您的 ALM 工具(Jira、Polarion:CSV 或 ReqIF)。计划把每条需求与证明它的测试关联起来: 没有计划,收到的测试结果什么也证明不了。
4. 每个版本,一条命令 —— 在您的项目中(Node.js):
npm i -D @mostajs/mjs-unit @mostajs/mjs-sbom # 只需一次
npx mjs-unit-menu # 然后:2(SBOM)· 3(验证报告)· 4(发送)
发送(选项 4)需要三个变量:QATRAX_URL(您的空间地址)、QATRAX_CLE(您的密钥)、QATRAX_PROJET(您的项目 标识)。在持续集成中,依次运行三条命令: npx mjs-unit-menu --choix=2 && npx mjs-unit-menu --choix=3 && npx mjs-unit-menu --choix=4。 使用 Java、C#、Python、C++、Go……?您的 SBOM 和测试工具生成的报告原样提交即可——JUnit XML、NUnit、TRX、TestNG、 Robot Framework、CTest、Cucumber、Behave、Allure、CTRF 或 TAP:参见不使用 Node.js 的 QATrax。
5. 签发 —— 在您的空间中:SBOM/漏洞标签页,逐个判定每个漏洞(受影响、不受影响、已修复); 然后进入交付物标签页 → 签发并封存。证书即被封存。
不用命令行:通过界面,逐个标签页操作
标签页位于空间每个页面的顶部。请先选择您的项目和要交付的版本。
| 步骤 | 标签页 | 您要做的事 | 按钮 |
|---|---|---|---|
| 1. 开始 | 流程(第一个) | 显示该版本的五个步骤,以及每一步还缺什么。每完成一步,都请回到这里查看。 | — |
| 2. 设定需求(只需一次) | 需求——或直接进入CRA 目录和开发+测试计划 | 导入 CRA 目录和您的测试计划:计划说明哪个测试证明哪条需求。 | 导入 · 校验并导入 |
| 3. 上传测试报告 | 流程第 ② 步——或执行记录标签页 | 选择测试生成的文件:mjs-unit 的验证报告或 JSON 报告、JUnit XML、TAP、CTRF。 | 上传结果 |
| 4. 上传 SBOM | 流程第 ③ 步——或SBOM/漏洞标签页 | 选择您的 SBOM 文件(CycloneDX 或 SPDX,JSON 格式),并填写版本号。 | 上传 SBOM(在漏洞标签页中:上传) |
| 5. 判定漏洞 | SBOM/漏洞 | qatrax 已查找您的 SBOM 中的漏洞。逐个选择:受影响、不受影响(附理由)或已修复。 | — |
| 6. 生成结论 | 交付物 | qatrax 汇总需求、测试、SBOM 和漏洞,然后显示结论。请仔细阅读;如无异议,即可签发。 | 签发并封存 |
| 7. 查看证书 | 交付物页面底部:已签发的交付物列表 | 每个已签发的交付物都有编号、版本和结论。可下载为已签名的 PDF、已封存的 JSON 和 HTML 证书,并可核验。 | — |
| 8. 加签 | 签名 | 如有签名包:勾选要由合格服务商加盖时间戳的交付物,然后确认:每个交付物扣除一次签名。完成后出现在已签名中。 | 发送至合格服务商 |
总结:流程 → 需求 → 执行记录 → SBOM/漏洞 → 交付物。 每个标签页顶部都有一行帮助,链接到本文档中解释该标签页的页面。
默认情况下,导航栏显示上述步骤的标签页:流程、需求、CRA 目录、执行记录、SBOM/漏洞、交付物、技术文档和报告。 其余标签页(手动测试、签名、项目、团队、开发+测试计划等)位于更多 ▾下。如需更改某个标签页的位置(导航栏、“更多”下 或隐藏)或调整顺序:⚙ 设置 → 标签页,选择其位置,拖动(或使用 ↑ ↓),然后保存。默认顺序恢复顺序; 全部恢复默认还会恢复导航栏和“更多”。
空间持有人设置整个空间的标签栏;每位团队成员都可以设置自己的标签栏,之后也可恢复为空间的设置。每个人能修改什么取决于其在项目中的角色 (团队 → 每个角色可以做什么):只读成员只能阅读。
由合格服务商签名。 第 7 步的 PDF 已由 qatrax 签名并加盖时间戳。在第 8 步,您可以借助签名包,再由我们的合格 信任服务商(eIDAS)为其加盖时间戳。要发送哪些证书由您自己选择;每次发送扣除一次签名,服务商失败时退还。详见 签名与签名包。
您将看到的效果
- 什么都不会丢失:每次提交都会被记录,即使不完整;缺少的内容会明确说明。
- 一个版本,一份档案:只有该版本的测试才计入。
- SBOM 中的漏洞会立即查找,之后每天查找(OSV、NVD、CISA KEV、EUVD 数据库)。
- 结论,一言以蔽之:
| 结论 | 含义 |
|---|---|
| 符合 | 一切均已证明,没有已知的可利用漏洞 |
| 有保留地符合 | 已证明,但有若干事项待补充(均已列出) |
| 不符合 | 有需求未被证明,或有漏洞被声明为可利用 |
| 结论受阻 | 有正被积极利用的漏洞尚待判定,或某份材料不一致(测试结果被改动、SBOM 不同) |
如有疑问,请在您的空间中给我们留言。