发布验证
消费方验证 Datarim 发布的配方——sha256 → cosign verify-blob → gh attestation verify。从 GitHub Release 安装/更新时加载。
概述
Datarim 发布通过 release.yml 从 Arcanada-one/datarim 发布,并使用 Sigstore cosign 无密钥(GitHub OIDC)签名,附带 CycloneDX SBOM 和 SLSA L2 构建来源证明。绝不要在未验证签名的情况下安装 tarball。本技能是 AI 智能体和运维人员消费 Datarim 发布的入口——规范来源:documentation/how-to/release-verification.md。
使用时机
- 用户说“安装 Datarim”、“更新到 v*”、“下载最新发布”。
- 用户问“如何验证 tarball”、“什么是 cosign bundle”、“既然有签名为什么还要 sha256”。
- 任何涉及
gh release download Arcanada-one/datarim或等价命令的指令。 - 在运行来自发布 tarball 的任何安装脚本之前。
不用于 git checkout / git pull 工作副本——那些通过 git 提交签名验证(单独策略)。
每次发布附带的内容
datarim-<TAG>-source.tar.gz— 源码归档(git archive HEAD,前缀datarim-<TAG>/)。datarim-<TAG>-source.tar.gz.sha256— SHA-256 校验和。datarim-<TAG>-source.tar.gz.cosign.bundle— cosign 签名包(证书 + 签名 + Rekor 包含证明)。datarim-<TAG>-sbom.cdx.json— CycloneDX SBOM。datarim-<TAG>-sbom.cdx.json.cosign.bundle— SBOM 上的 cosign 签名。- GitHub 证明(服务端)— SLSA L2 构建来源,通过
gh attestation verify。
前置条件
cosign≥ 3.0gh≥ 2.40(用于gh attestation verify)sha256sum、jq(POSIX)
验证配方(5 步,全部必须退出码为 0)
TAG=v1.21.3 # 替换为要验证的发布版本
# 1. 下载所有发布产物。
gh release download "$TAG" --repo Arcanada-one/datarim
# 2. 通过校验和验证 tarball 完整性。
sha256sum -c "datarim-${TAG}-source.tar.gz.sha256"
# 3. 验证 tarball 上的 cosign 签名。
cosign verify-blob \
--bundle "datarim-${TAG}-source.tar.gz.cosign.bundle" \
--certificate-identity "https://github.com/Arcanada-one/datarim/.github/workflows/release.yml@refs/heads/main" \
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
"datarim-${TAG}-source.tar.gz"
# 4. 验证 SBOM 上的 cosign 签名(相同的身份绑定)。
cosign verify-blob \
--bundle "datarim-${TAG}-sbom.cdx.json.cosign.bundle" \
--certificate-identity "https://github.com/Arcanada-one/datarim/.github/workflows/release.yml@refs/heads/main" \
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
"datarim-${TAG}-sbom.cdx.json"
# 5. 验证 SLSA 构建来源。
gh attestation verify "datarim-${TAG}-source.tar.gz" --repo Arcanada-one/datarim
任何非零退出 → 产物不可信;不要部署。
每一步证明什么
sha256sum -c— 完整性。tarball 在传输中未损坏。cosign verify-blob(tarball)— 真实性。tarball 由release.yml生成,从受保护的main分派,并在Arcanada-one/datarim中认证了这个确切的已签名标签之后。签名锚定在 Sigstore Rekor 公共透明日志中。cosign verify-blob(SBOM)— SBOM 与 tarball 由同一次工作流运行生成。gh attestation verify— SLSA L2 构建来源:产物在 GitHub 托管的运行器上构建,源 SHA 由这个确切的标签认证。
cosign verify-blob 是将 tarball 绑定到其构建来源的步骤。仅 sha256 不能证明任何东西——攻击者会同时替换归档和 .sha256 文件。
反例(不要这样做)
- 不检查签名直接管道到 tar —
curl … | tar -xz完全绕过密码学验证。 - 仅校验和验证 — 如果
.sha256文件也被伪造,仅sha256sum -c不能证明任何东西。 - 不带
--certificate-identity的 cosign — 接受来自 OIDC 签发者的任何签名者;任何主体都可以铸造证书并签署任意 tarball。
报告验证失败
如果 cosign verify-blob 或 gh attestation verify 在官方发布标签上失败——不要安装。在 https://github.com/Arcanada-one/datarim/issues 提交 issue,附上标签、命令和输出。这可能是供应链事件。
使用时机
由消费 Datarim 发布的 AI 智能体和运维人员加载。引用自 AGENTS.md § Security Mandate § S4(供应链)。与 documentation/how-to/release-verification.md 有分歧时,以规范文档为准;更新本技能以保持一致。