技能 Quality

发布验证

消费方验证 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.0
  • gh ≥ 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 有分歧时,以规范文档为准;更新本技能以保持一致。