GitHub Actions 供应链安全:从 SHA 固定到 OIDC 短期凭证

CI 能读取代码、执行脚本,还可能接触生产凭证,因此它不仅是构建工具,也是攻击面。GitHub 的安全指南建议将第三方 Action 固定到完整 commit SHA,并显式收紧 GITHUB_TOKEN 权限。标签可以移动;完整 SHA 才能锁定被审计的提交,但仍要确认 SHA 来自正确的仓库并持续更新。

先做权限拆分

默认工作流设为只读,部署 job 再单独申请必要的权限。不要在具有 secrets 的 pull_request_target 上检出并执行来自外部 fork 的代码:事件上下文和代码来源的信任级别不同,混在一起会把不可信代码带进特权环境。

部署云资源时优先使用 OIDC:工作流向身份提供方请求短期身份令牌,云角色检查签发者、仓库、分支或环境等声明,再交换短期凭证。OIDC 本身不会自动保证安全;如果云端信任策略只验证组织、不限制仓库或环境,错误工作流仍可能获得角色。

一份上线检查表

  • 分离构建、测试、生产部署,生产环境增加人工审批。
  • 固定并审核第三方 Action 的完整 SHA,保留升级流程。
  • 不在日志中打印令牌;检查缓存是否可能被不可信 PR 污染。
  • 对部署角色限制受众、仓库、分支及环境,定期审计信任策略。

2026 年 GitHub 宣布工作流执行保护正式可用,可以在策略层限制触发者和事件。平台护栏值得开启,但不能替代工作流逐行审查。

参考:GitHub 安全加固;工作流执行保护。