2026年8月19日

release-verify 技能——安装前的五个步骤

Datarim 的发布版本均经 cosign 签名,并附带 SLSA L2 来源证明。release-verify 技能是消费端的操作指南,用于在解压任何 tarball 之前对两者进行校验。

在未校验签名的情况下从发布 tarball 安装软件,会带来供应链风险。release-verify 技能回答了一个问题:Datarim 的消费者在解压发布包之前需要运行什么?

Datarim 的发布版本通过 release.yml 工作流从 Arcanada-one/datarim 发布,并使用 Sigstore cosign 以无密钥模式签名,身份来源为 GitHub OIDC。每个发布版本都附带一份 CycloneDX SBOM 和一份 SLSA Level 2 构建来源证明。该技能将五步校验流程固化下来,使 agent 无需获取外部文档即可执行。

每个发布版本包含的内容

每个发布标签会生成六种产物:源 tarball、SHA-256 校验和文件、tarball 的 cosign bundle、CycloneDX SBOM、SBOM 的 cosign bundle,以及通过 gh attestation verify 附加到发布版本上的服务端 SLSA L2 证明。源 tarball 由 git archive HEAD 生成,并以标签作为前缀。

五步流程

第 1 步使用 gh release download 下载所有发布产物。第 2 步使用 sha256sum -c 校验 tarball 哈希。第 3 步对 tarball 运行 cosign verify-blob,将其绑定到确切的工作流 URL 和标签。第 4 步对 SBOM 运行相同的 cosign 校验。第 5 步使用 gh attestation verify 校验 SLSA 构建来源。

任何步骤出现非零退出码,都意味着该产物不可信,不应安装。每个步骤证明的是不同的属性。第 2 步的校验和证明 tarball 完整到达。第 3 步的 cosign 校验证明它是由 Arcanada-one/datarim 中该确切标签上的 release.yml 构建的,且签名锚定在 Sigstore Rekor 透明日志中。第 5 步的 SLSA 证明证明该产物是由 GitHub 托管的 runner 从该提交处的源代码构建的。

该技能明确指出仅靠校验和无法证明什么:攻击者若替换了 tarball,可以同时替换 .sha256 文件。cosign 步骤才是将 tarball 绑定到特定构建来源的环节,若没有该确切工作流运行所产生的 OIDC token,就无法伪造。

--certificate-identity 标志至关重要

该技能中有一个具体的反例:仅使用 --certificate-oidc-issuer 而不使用 --certificate-identity 运行 cosign verify-blob,会接受来自任何使用相同 OIDC 签发者的签名者的签名。任何仓库的任何 GitHub Actions 工作流都可以签发证书并为任意 tarball 签名。identity 标志将校验固定到确切的工作流文件和标签。

前提条件与适用范围

该流程需要 cosign ≥ 3.0、gh ≥ 2.40、sha256sum 和 jq。该技能仅适用于发布 tarball。对于 git checkout 的工作副本,签名校验通过 git 提交签名进行,这属于另一套策略。

阅读Datarim 是什么了解整体框架概况,或查看security-baseline 技能了解使该流程成为强制要求的 S4 供应链规则。