QATrax
以 Markdown 查看

简介——从代码到证书

起点、需要完成的几个步骤、终点。获得 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 不同)

如有疑问,请在您的空间中给我们留言。