在 CI/CD 中验证构建产物签名:从签名身份约束到部署前拒绝与回滚

枫少@KillBoy
枫少@KillBoy
枫少@KillBoy
管理员
455
文章
0
粉丝
安全开发8107字数 2432阅读8分6秒阅读模式
AI智能摘要
镜像签名有效,并不意味着签名者就是获准发布的构建身份;可变标签和部署旁路也可能让验证结果失去意义。文章以容器镜像为例,梳理如何同时约束签名身份与签发者、固定部署摘要,并在部署前设置验证失败即拒绝的门禁。面对未签名、内容替换和非预期身份等情况,如何测试门禁并排查误拒绝,同时避免放宽信任策略?
— AI 生成的文章内容摘要

构建完成后,镜像往往还要经过仓库、发布流水线和部署系统。只要其中某个环节能替换待部署产物,部署成功就不代表运行的是原先构建的内容。即使镜像带有有效签名,也还要回答另一个问题:签名者是不是我们允许发布的构建身份?

下面以隔离环境中的容器镜像为例,把构建产物签名、签名身份验证和部署门禁串起来。示例采用 Cosign 的无密钥签名思路;不同版本、CI 身份提供方和镜像仓库的配置可能不同,落地前应核对所用版本的命令帮助与官方文档。

先明确验证什么

签名验证至少包含两个不同的判断:

  • 签名及其关联内容有效:签名与待验证镜像摘要匹配,且满足验证工具的信任链等检查。
  • 签名身份符合发布策略:证书中的身份和 OIDC 签发者,与预先批准的发布工作流身份一致。

前者不能代替后者。一个不属于本团队的身份,也可能产生一个在其自身信任链下有效的签名。如果策略只接受某个身份提供方,却不限制具体身份,就可能把其他工作流的签名也当成可信发布。

部署对象也必须固定。镜像标签可以被重新指向;应签名、验证并最终部署同一个 repository@sha256:摘要,而不是验证标签后再让部署系统重新解析标签。

镜像经过内容与签名身份双重核验后进入部署阶段的示意图

准备隔离测试环境

准备一个仅用于测试的镜像仓库,以及两个可独立触发的 CI 身份:

  1. 可信身份 A:模拟正式发布工作流,允许向测试仓库推送并签名。
  2. 非预期身份 B:用于生成另一份有效签名,但不列入发布策略。

另准备两份内容不同的测试镜像,并记录推送后由仓库返回的摘要。测试仓库及签名材料不要与生产环境共用;不要把 OIDC 令牌或其他凭据写入日志。

在发布侧,通过受保护的配置预先设置:

IMAGE='registry.example.test/team/demo@sha256:<镜像摘要>'
EXPECTED_IDENTITY='<可信发布工作流证书中的精确身份>'
EXPECTED_ISSUER='<可信OIDC签发者>'

这些值是示意占位符。尤其是身份字段,应根据实际 CI 平台和证书中的身份格式确认,不能直接套用其他平台的示例。策略值应由发布管理方维护,不能由待验证镜像或普通构建参数自行指定;否则攻击者可能同时替换产物和“可信身份”。

测试前还应确认验证端能访问镜像仓库以及当前配置所需的验证服务,保存工具版本、身份策略和测试摘要,以便复核。签名操作可能产生公开透明日志记录,不要在镜像引用或身份信息中放入不应公开的数据。

构建时签名,发布时约束身份

使用可信身份 A 完成构建和推送后,取得镜像摘要,再在该 CI 身份下对摘要签名。以下命令展示流程,不包含特定平台的 OIDC 授权配置:

cosign sign --yes "$IMAGE"

在支持相应环境身份的 CI 中,该步骤需要事先配置身份令牌权限和仓库访问权限。--yes 用于跳过确认;它不会代替权限配置,也不应被理解为放宽发布侧的验证策略。

发布阶段针对同一摘要执行验证:

cosign verify "$IMAGE" \
  --certificate-identity "$EXPECTED_IDENTITY" \
  --certificate-oidc-issuer "$EXPECTED_ISSUER"

这里同时约束了证书身份和 OIDC 签发者。优先使用精确身份;确需允许多个分支或工作流时,应由受控策略明确列举或严格限定范围,并测试不应通过的身份。不要为了让验证成功而使用能匹配任意身份的宽泛表达式。

这与“只判断签名有效”有本质区别:后者回答签名是否成立;前者还检查签名是否由预期身份签发。具体命令选项、信任根和联网要求以实际安装版本及其文档为准。

在部署前执行失败即拒绝的检查

门禁必须位于实际部署动作之前,并使用与部署动作完全相同的摘要。下面是简化的 shell 示例,假设部署脚本接受摘要引用:

#!/bin/sh
set -eu

: "${IMAGE:?缺少镜像摘要引用}"
: "${EXPECTED_IDENTITY:?缺少可信签名身份}"
: "${EXPECTED_ISSUER:?缺少可信OIDC签发者}"

if ! cosign verify "$IMAGE" \
  --certificate-identity "$EXPECTED_IDENTITY" \
  --certificate-oidc-issuer "$EXPECTED_ISSUER"
then
  echo "镜像签名或身份验证失败,拒绝部署" >&2
  exit 1
fi

exec ./deploy-by-digest.sh "$IMAGE"

部署脚本也必须保留该摘要,不能把它转换回可变标签。还要检查是否存在绕开此流水线的手工部署、其他发布任务或直接修改运行环境的权限;单个脚本中的门禁无法约束这些旁路。

验证失败、验证服务不可用和签名不符合策略都应阻止本次自动部署,但在记录中区分原因。不要为了提高发布成功率,把验证异常改成警告后继续执行部署。

用四组结果验证门禁

在隔离环境中,保留每次测试使用的镜像摘要、签名身份、验证结果和部署是否实际发生。至少覆盖以下情况:

测试操作预期结果
可信签名A 对目标摘要签名,策略指定 A验证通过,允许进入部署步骤
未签名使用没有符合策略签名的测试摘要验证失败,不部署
内容不匹配将已签名镜像替换为不同摘要的镜像,不为新摘要提供符合策略的签名验证失败,不部署
身份不符合预期B 对目标摘要签名,发布策略仍指定 A即使 B 的签名本身有效,也必须拒绝

第三项测试的关键是确认部署端实际验证的是替换后的摘要。第四项则应先独立确认 B 确实完成了签名,再用 A 的策略验证,避免把“签名根本不存在”误判为“身份约束生效”。

每次失败测试都要检查部署系统的实际状态,而不只是查看验证命令输出:例如确认部署脚本未执行、运行中的镜像摘要未改变。随后用可信身份重新签名或恢复正确摘要,再跑完整流程,确认修复后可以正常发布。

误拒绝排查与策略回归

预期发布被拒绝时,先保留失败记录,不要立即扩大信任范围。按以下顺序排查:

  1. 核对部署对象:构建、签名、验证和部署引用的仓库及摘要是否一致;是否发生了跨仓库复制或标签重新指向。
  2. 核对签名是否可取得:目标仓库中是否存在与该摘要关联的签名,验证端是否有读取权限。
  3. 核对身份策略:实际证书身份、OIDC 签发者与配置是否精确匹配;工作流路径、引用或身份提供方变更是否影响了身份值。
  4. 核对运行条件:工具版本、信任配置、网络和所需服务是否正常;区分策略拒绝与基础设施故障。

修正后,除了重测可信签名通过,还要重跑未签名、内容不匹配和非预期身份三类拒绝测试,防止为了修复误拒绝而意外放宽策略。日志应记录摘要、策略版本和失败类别,但避免记录令牌等敏感信息。

身份轮换与安全回滚

无密钥流程减少了长期签名私钥的管理负担,但工作流身份、OIDC 配置和发布权限仍需要管理。迁移发布工作流时,应先在隔离环境确认新身份的证书值,再通过受审批的策略变更引入新身份,完成正反向测试后逐步停用旧身份。过渡期如果同时信任新旧身份,应限定范围、设置结束条件并记录责任人;发现旧身份失陷时,则应立即撤销其发布信任并调查受影响产物。

回滚也不能绕过门禁。预先保存已知良好版本的镜像摘要、签名和对应信任策略,演练按该摘要验证并部署。若旧版本因身份轮换不再符合当前策略,应走受审批的恢复流程:先确认旧产物和签名来源,再以受控策略允许其回滚,并记录有效范围与撤销时间;不要临时关闭所有验证。

构建产物签名证明的是所验证内容与签名者之间的关系。它不证明依赖没有漏洞,也不证明构建环境未被入侵。持续集成与持续交付中的这道部署门禁,应与构建权限控制、依赖治理和运行环境防护配合使用,而不是替代它们。

 
枫少@KillBoy
评论  8  访客  8
    • 灭世修罗
      灭世修罗 2

      部署时还得盯住同一个摘要

      • 云舟
        云舟 0

        只验签名不验身份确实容易漏掉

        • 棉花糖热巧
          棉花糖热巧 0

          手工部署的旁路也得一起管住

          • 咒语回廊
            咒语回廊 2

            验证服务故障时怎么保障发布时效?

            • 古道行者
              古道行者 1

              身份轮换最好提前演练一遍

              • 奶茶不加糖
                奶茶不加糖 1

                回滚也要验证,这点很容易忘

                • 落叶松
                  落叶松 2

                  失败后确认部署脚本没执行很重要

                  • 鸭鸭
                    鸭鸭 2

                    跨仓库复制后签名还能直接找到吗?

                  匿名

                  发表评论

                  匿名网友

                  拖动滑块以完成验证