GitHub将默认屏蔽pull_request_target触发器,PSF分享组织级防护经验
来源标题:De-fanging dangerous triggers in GitHub Actions across an organization
GitHub 将于2026年12月2日起在公开仓库中默认屏蔽 pull_request_target 触发器,该触发器可能让外部人员启动可访问密钥的工作流。Python软件基金会(PSF)撰文介绍如何利用组织级策略一次性关闭这类危险触发器,Team或Enterprise计划可对整个组织生效,Free计划则需逐仓库设置。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
2026年12月2日,GitHub 将开始在公开仓库中默认阻止 pull_request_target 触发器。如果这句话对你来说毫无意义,那这篇文章就是为你写的。如果它让你感到不安,这篇文章同样适合你。
简要来说:少数几个 GitHub Actions 触发器会让互联网上的陌生人启动一个可能有权访问你密钥的工作流。在 GitHub Team 或 Enterprise 方案中,你可以用一条策略为组织内的所有仓库关闭这些触发器。在 Free 方案中,你只能逐个仓库操作。先设置策略,查看它会阻止什么,然后再强制执行。
Alpha-Omega 同时支持我们在 Python 软件基金会(PSF)的两项工作。这篇文章正是这项工作的成果:先响应 PyPI 上的安全事件,然后锁定 pypi 和 python 这两个 GitHub 组织,确保我们不会成为下一个受害者。
这些触发器运行时有权访问你的密钥,而陌生人可以启动它们。
当有人从 fork 发起 pull request 时,pull_request 触发器会用只读 token 运行其代码,且无法访问密钥。这是安全的那个。
pull_request_target 在工作流文件中看起来几乎一样,但行为却大不相同。它以读写 token 运行,并且可以访问你的仓库和组织密钥。GitHub 设计它是为了处理诸如给来自 fork 的 pull request 打标签之类的杂务,这类工作流从不接触贡献者的代码。问题出在工作流检出 pull request 并运行它的时候:
on: pull_request_target
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
ref: ${{ github.event.pull_request.head.sha }} # a stranger's code
- run: make test # running with your secrets
任何拥有 GitHub 账户的人都可以发起那个 pull request。他们的代码现在以你的凭据运行。这被称为“pwn request”,GitHub 的文档将其描述为多起供应链入侵的根本原因。
issue_comment 带有同样的风险。当任何人对 issue 或 pull request 发表评论时,这个触发器就会触发,工作流以仓库的 token 和密钥运行。有时受害者是一个“评论 /test 来运行 CI”的机器人,它会检出 pull request 并运行其代码。有时工作流会把评论文本粘贴到模板化的 shell 命令中,而评论最终向工作流 shell 注入了不同的指令。
是的,这种情况反复发生。以下是几起直接影响 PyPI 上托管项目的事件:
Python 之外受影响的项目数量更多:AsyncAPI、TanStack、Nx、Grafana、tj-actions。
这些项目背后的维护者并非粗心大意。这些触发器在工作流文件中看起来无害,而不安全的版本与安全的版本只差一行。
搜索你的工作流文件,然后检查哪些最近运行过。
在 GitHub 代码搜索中,针对一个组织或单个仓库:
org:YOUR-ORG path:.github/workflows /pull_request_target|issue_comment/
repo:YOUR-ORG/YOUR-REPO path:.github/workflows /pull_request_target|issue_comment/
在终端中同样可以做到:
gh search code pull_request_target path:.github/workflows --owner YOUR-ORG
gh search code issue_comment path:.github/workflows --owner YOUR-ORG
代码搜索只覆盖默认分支,这在这里没问题:两个触发器都从默认分支运行工作流文件。
一个工作流文件存在是一回事。一个上周二运行过的工作流更值得关注:
gh run list --repo YOUR-ORG/YOUR-REPO --event pull_request_target --limit 10
gh run list --repo YOUR-ORG/YOUR-REPO --event issue_comment --limit 10
在整个组织范围内:
gh repo list YOUR-ORG --no-archived --limit 1000 --json nameWithOwner --jq '.[].nameWithOwner' |
while read -r repo; do
for event in pull_request_target issue_comment; do
gh run list --repo "$repo" --event "$event" --limit 1 \
--json workflowName,createdAt \
--jq ".[] | \"$repo $event \(.workflowName) \(.createdAt)\""
done
done
如果你在使用 GitHub Actions,我们强烈建议采用 zizmor,这是一个用于扫描 GitHub Actions 工作流中常见安全问题的工具。Zizmor 也能发现这些不安全的触发器,以及一长串其他工作流问题。Zizmor 一次只能处理一个仓库,且每个仓库都需要主动启用。对整个组织应用策略来拒绝不安全的触发器,可以覆盖那些没人记得创建过的仓库,以及未来贡献者意外将项目暴露于供应链攻击的情况。
只保留你有意使用的触发器。GitHub 的默认策略只阻止 pull_request_target,只在公开仓库中生效,而且一旦你定义了自己的事件策略,它就会让位。所以定义一个策略,并把它设为允许列表。以下是我们建议的起点:
快速修复方法是允许除 pull_request_target 和 issue_comment 之外的所有事件。这比什么都不做要好,但更短的列表更好。Adnan Khan 的 Clinejection 研究表明,一种攻击仅仅从打开一个 issue 开始,而快速修复方法仍然允许 issues 触发器。
关于 workflow_run 的一个注意事项:它在另一个工作流完成后以特权运行。把它从 pull request 运行中下载的任何工件视为不可信输入。crates.io 拒绝来自此触发器的 Trusted Publishing,因此你不应将该触发器用于发布软件包等敏感操作。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。