锁定你的GitHub Actions:供应链安全实践

用提交SHA锁定GitHub Actions引用,防范标签被移动引发的供应链攻击。
文章围绕GitHub Actions的供应链安全展开,指出工作流中常见的`uses: actions/checkout@v4`使用可变标签,标签可被维护者或攻击者重新指向新提交,导致今天运行的工作流明天可能执行恶意代码。作者引用Hugo van Kemenade《Lock Your GitHub Actions》的核心建议:用完整40位提交SHA替代标签或分支,利用内容寻址的不可变性实现“密码锁”。文章也讨论了维护成本,并给出Dependabot自动更新、SHA后附版本注释、定期审计等缓解方案。Hacker News社区讨论显示多数人认同锁定必要性,但对低风险Action可权衡成本;GitHub官方文档也开始推荐对第三方Action使用SHA锁定。文末提供审计、替换、自动化更新与文档化的行动清单。
引言:为什么GitHub Actions需要“锁定”

在现代软件开发中,持续集成与持续交付(CI/CD)已成为标配,而GitHub Actions凭借与GitHub生态的深度集成,成为众多开源项目和企业的首选自动化平台。然而,便利的背后隐藏着一个常被忽视的安全风险:你引用的Action可能随时被篡改。
知名开发者Hugo van Kemenade在其博客文章《Lock Your GitHub Actions》中,详细阐述了如何通过“锁定”Action版本来防范供应链攻击,该文在Hacker News上获得了285点热度与59条讨论,足见社区对此话题的关注。
问题根源:可变引用与供应链攻击
GitHub Actions的工作流文件(如.github/workflows/ci.yml)通常使用uses关键字来引用Action,例如:
uses: actions/checkout@v4
这里的v4是一个标签(tag),而非固定版本。问题在于,标签可以被移动或重新指向。Action的维护者(或攻击者)可以随时将v4标签指向新的提交,这意味着你今天运行的工作流,明天可能执行完全不同的代码。
这种机制为供应链攻击提供了温床。一旦某个流行Action的仓库被入侵,攻击者可以将恶意代码推送到标签引用的位置,所有使用该标签的工作流都会自动拉取并执行恶意脚本,进而窃取密钥、篡改代码或植入后门。
Git引用(ref)的本质:Git中的分支和标签都是指向某个提交对象的“可变指针”。标签分为轻量标签和附注标签,但无论哪种,git tag -f或推送新标签都能让同名标签指向另一个提交,且默认不会在拉取时报警。GitHub Actions的uses: owner/repo@ref语法中,ref可以是分支、标签或完整SHA;前两者在每次运行时由GitHub解析为当时最新的提交,因此不具备内容完整性保证。只有40位(SHA-1)或64位(SHA-256)的提交哈希是内容寻址的,任何对历史的重写都会改变哈希,从而提供密码学意义上的不可变性。这正是SHA锁定能抵御供应链攻击的技术基础。
解决方案:提交SHA锁定
Hugo van Kemenade提出的核心建议直截了当:使用完整的提交SHA代替标签或分支引用。
uses: actions/checkout@a1b2c3d4e5f6... # 完整的40位SHA
提交SHA是内容寻址的,不可篡改。一旦指定了某个SHA,GitHub就会精确拉取该次提交,无论后续标签如何变化。这相当于为你的工作流加上了一把“密码锁”。
实施中的权衡
锁定SHA并非没有代价。每次需要升级Action时,开发者必须手动查找并替换SHA,这增加了维护负担。对此,社区提出了一些缓解方案:
- 使用依赖管理工具:如Dependabot可以自动创建PR来更新SHA版本。
- 结合版本注释:在SHA后添加注释说明对应的版本号,便于人工阅读。
- 定期审计:将SHA锁定纳入安全审查流程,确保及时更新。
Dependabot对GitHub Actions的支持:Dependabot原生支持github-actions生态系统,会解析工作流中的uses引用,并在上游发布新版本标签时自动创建PR。当引用格式为owner/repo@<SHA> # vX.Y.Z时,Dependabot能识别注释中的版本号,将SHA更新到新版本对应的提交,同时保留可读注释。Renovate也提供类似能力,并支持更细粒度的分组与调度策略。需要注意,自动更新PR本身也是供应链的一环:合并前应审查变更的Action发布者、变更日志与权限范围,避免自动化工具把恶意更新直接带入主分支。
社区讨论与多源观点
在Hacker News的讨论中,开发者们分享了各自的实践经验。多数评论认同SHA锁定的必要性,但也有人指出,对于个人项目或低频使用的Action,维护SHA的成本可能高于风险。
一种折中观点是:对高权限Action(如涉及部署、密钥管理的)严格锁定SHA,而对低风险的辅助工具可以放宽到标签。不过,安全专家普遍认为,在供应链攻击日益频繁的今天,默认采用SHA锁定是更稳妥的策略。
此外,有评论提到GitHub官方文档也开始推荐对第三方Action使用SHA锁定,这反映了平台方对安全最佳实践的引导。
最小权限与工作流权限模型:SHA锁定解决的是“引用不可变”问题,但无法限制Action运行时的能力。GitHub Actions的GITHUB_TOKEN默认权限可被仓库或组织设置为只读,工作流中也可通过顶层permissions:字段显式收窄(如仅授予contents: read)。对于涉及部署或密钥的作业,建议结合环境(Environment)保护规则、必需审批以及OIDC联合身份替代长期云凭证。将SHA锁定与最小权限原则叠加,才能形成纵深防御,单靠锁定无法阻止一个已被授权且本身恶意的Action访问其权限范围内的资源。
如何开始:行动清单
如果你希望立即提升工作流的安全性,可以按以下步骤操作:
- 审计现有工作流:列出所有
.github/workflows/文件中的uses语句,标记那些使用标签或分支的引用。 - 替换为SHA:通过GitHub API或直接查看Action仓库的提交历史,获取最新稳定版本的完整SHA。
- 配置自动化更新:启用Dependabot或Renovate,自动为Action更新创建PR(并附带SHA变更)。
- 文档化约定:在团队内明确Action引用的安全规范,并纳入代码审查清单。
结语
《Lock Your GitHub Actions》一文虽短,却切中了CI/CD安全的关键痛点。在软件供应链攻击愈演愈烈的背景下,将Action引用从可变标签改为不可变SHA,是一项低成本、高回报的安全加固措施。正如HN讨论所反映的,社区共识正在形成:锁定你的Actions,别给攻击者留后门。
相关推荐

Zed编辑器发布v1.29.2:一次常规版本迭代的观察
Zed编辑器发布v1.29.2补丁版本,由@JosephTLyons完成版本升级,提交经GitHub签名验证。本文梳理该版本的基本信息、补丁版本的含义以及对用户升级的实际建议。

Anthropic IPO遭质疑:Hacker News热议其上市时机
Hacker News出现「Just say no to Anthropic's IPO」帖子,引发对Anthropic上市时机与AI公司资本化的讨论,涉及估值泡沫与使命独立性等议题。

Genie 4世界模型上手:像木偶师一样实时导演世界
Google DeepMind 世界模型 Genie 4 深度解析:Special Guest X 实测展示如何用提示词实时导演场景、通过 Project Genie 构建自定义交互应用,以及提示词即种子的可复现设计。