CI/CD / 系统课时

校验制品完整性

校验制品完整性

本课建立一条可自动执行的制品校验链:先用 SHA-256 判断字节是否被替换,再用数字签名确认发布者身份,最后核对构建元数据,把“文件没坏”升级为“来源、内容和构建上下文都可信”。

学习目标

  • 使用 SHA-256 校验仓库中制品与构建阶段产物是否一致。
  • 使用公钥签名验证制品确实由受信任的发布流程签发。
  • 将提交号、流水线编号和构建时间等元数据纳入发布放行条件。

把三类证据连成一条链

哈希解决“内容是否一致”,签名解决“是谁对这份内容背书”,构建元数据解决“它由哪次源码与流水线产生”。三者用途不同,不能互相替代:只有哈希而没有可信来源,攻击者可以同时替换文件和哈希;只有签名而不核对构建信息,也难以证明制品对应预期提交。

哈希签名与构建元数据共同形成制品校验链

生成哈希和签名

下面的示例假设构建产物为 dist/demo.tar.gz,使用 OpenSSL 生成 SHA-256 摘要,并用发布私钥创建签名。私钥应由 CI 的密钥管理能力注入,不能提交到代码仓库或打包进制品。

bash
#!/usr/bin/env bash
set -euo pipefail

ARTIFACT="dist/demo.tar.gz"
PRIVATE_KEY="${PRIVATE_KEY_PATH:?missing PRIVATE_KEY_PATH}"

sha256sum "$ARTIFACT" > "${ARTIFACT}.sha256"

openssl dgst -sha256   -sign "$PRIVATE_KEY"   -out "${ARTIFACT}.sig"   "$ARTIFACT"

printf 'created=%s\ncreated=%s\n'   "${ARTIFACT}.sha256" "${ARTIFACT}.sig"

预期输出

text
created=dist/demo.tar.gz.sha256
created=dist/demo.tar.gz.sig

这三个文件——制品、哈希文件和签名——应作为同一次发布的关联对象保存。签名私钥不应上传到制品仓库;部署侧只需要受信任的公钥。

在部署前执行双重校验

部署阶段应重新下载制品及其校验材料,再本地计算哈希并验证签名。下面的脚本只在两项检查都成功时退出 0,适合作为部署任务前的硬门禁。

bash
#!/usr/bin/env bash
set -euo pipefail

ARTIFACT="dist/demo.tar.gz"
PUBLIC_KEY="${PUBLIC_KEY_PATH:?missing PUBLIC_KEY_PATH}"

sha256sum --check "${ARTIFACT}.sha256"

openssl dgst -sha256   -verify "$PUBLIC_KEY"   -signature "${ARTIFACT}.sig"   "$ARTIFACT"

预期输出

text
dist/demo.tar.gz: OK
Verified OK

如果哈希失败,说明实际字节与记录摘要不一致;如果签名失败,说明制品内容、签名文件或验证公钥至少有一项不匹配。两种失败都应该立即终止发布,不应自动降级为“仅告警”。

核对构建元数据

哈希和签名通过后,还要确认“这是不是本次准备发布的那一份”。建议为每个制品保存机器可读的构建元数据,至少包含版本、源码提交、流水线标识和构建时间。下面使用 JSON 文件,并通过 jq 与当前发布参数比对。

json
{
  "version": "2.3.1",
  "commit": "8f31c0d",
  "pipelineId": "4821",
  "builtAt": "<TIME>"
}

这份配置的生效行为是:发布流程把元数据与制品一并保存,部署阶段读取它作为来源证明。验证时执行:

bash
#!/usr/bin/env bash
set -euo pipefail

: "${EXPECTED_VERSION:?missing EXPECTED_VERSION}"
: "${EXPECTED_COMMIT:?missing EXPECTED_COMMIT}"

jq -e   --arg version "$EXPECTED_VERSION"   --arg commit "$EXPECTED_COMMIT"   '.version == $version and .commit == $commit'   build-metadata.json >/dev/null

printf 'metadata=OK\n'

预期输出

text
metadata=OK

如果版本或提交号不匹配,说明仓库里的制品虽然可能“完整且签名有效”,却不是当前发布单指定的构建,应当拒绝继续部署。<TIME> 是动态构建时间,实际值会随流水线运行而变化。

把校验设为不可绕过的门禁

完整性校验应位于“从仓库取出制品”和“部署到目标环境”之间,并由流水线自动执行。生产环境尤其不应允许人工跳过哈希、签名或元数据校验;若必须紧急处置,也应通过有审批记录的例外流程,而不是修改脚本让校验永远返回成功。

最终放行条件可以概括为:哈希一致、签名可信、元数据匹配。只有三项同时成立,流水线才能把制品交给部署阶段,这样即使仓库对象被误替换或来源混淆,也能在进入运行环境前被阻断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

校验制品完整性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通