导语:本次 temporal-proxy 密钥泄露 漏洞(CVE-2026-130089,CVSS 7.3)暴露了一个典型的“信任边界错位”问题:代理层将请求中的 namespace 直接渲染进上游地址模板,却未做任何白名单校验,导致攻击者可通过构造恶意命名空间将代理拨号指向自己控制的主机,并借助系统信任库的 TLS 校验缺陷窃取上游静态 API Key。本文从架构师视角完整拆解攻击链路、根因与工业级修复方案。
企业级架构规范
flowchart TD
subgraph 接入层 ["表现层与接入网关 (Client & Gateway Tier)"]
A["攻击者 gRPC 请求 (携带恶意 namespace)"] --> B["temporal-proxy gRPC 监听器"]
end
subgraph 规则层 ["认证与地址解析层 (Auth & Resolver Tier)"]
B --> C["静态 Token / JWKS 认证 (不限制 namespace)"]
C --> D["上游地址模板渲染 (namespace 直接拼接 hostPort)"]
end
subgraph 领域层 ["TLS 校验与密钥注入层 (TLS & Key Injection Tier)"]
D --> E["代理拨号至攻击者控制主机 (公网可信证书)"]
E --> F["系统信任库校验通过 (未设置 serverName)"]
F --> G["代理将上游静态 API Key 发送至攻击者主机"]
end
subgraph 存储层 ["上游服务与密钥存储 (Upstream & Secret Tier)"]
G --> H["攻击者获取 API Key"]
H --> I["直接访问上游 Temporal 服务"]
end
一、漏洞背景与影响范围
temporal-proxy 是 Temporal 生态中用于多租户隔离与上游转发的 gRPC 代理组件。在 0.1.0 至 1.2.0 版本中,代理支持通过模板将请求中的 namespace 渲染到上游地址的 hostPort 中,以实现按命名空间路由。然而,代理在渲染前未对 namespace 做任何合法性校验,导致攻击者可以构造包含任意主机名的 namespace,使代理将请求转发至攻击者控制的主机。
根据 GitHub Advisory 披露,该漏洞编号为 CVE-2026-130089,严重等级 High,CVSS 评分 7.3。受影响版本为 0.1.0 至 1.2.0,修复版本为 1.0.2、1.1.2、1.2.1,1.0.0 之前的版本不再提供修复。官方建议立即升级至对应小版本线的最新修复版本,并轮换所有可能被不可信调用方触达的上游 API Key。
若你的 temporal-proxy 配置中上游地址使用了 {{.Namespace}} 模板,且上游 TLS 校验依赖系统信任库而未显式设置 serverName,则任何能访问 gRPC 监听器的调用方均可利用此漏洞窃取上游静态 API Key。请立即排查并升级。
二、攻击链路深度拆解:从命名空间注入到密钥泄露
2.1 命名空间注入:信任边界的第一个缺口
temporal-proxy 的 resolver 模块在解析上游地址时,会将请求中的 namespace 字段直接代入模板字符串。例如官方 Temporal Cloud 配置示例中,上游地址模板为 {{.Namespace}}.tmprl.cloud:7233。攻击者只需在 gRPC 请求中设置 namespace 为 evil.com# 或类似构造,即可使渲染后的地址变为 evil.com#.tmprl.cloud:7233,从而将拨号目标指向攻击者控制的主机。
关键问题在于:代理的认证层(内置 static-token 与 JWKS 认证器)仅验证调用方身份,并不限制其可访问的 namespace 列表。因此,任何通过认证的调用方均可注入任意 namespace,进而控制上游地址。
2.2 TLS 信任链缺陷:公网可信证书成为帮凶
当代理拨号至攻击者控制的主机时,若上游 TLS 配置使用系统信任库进行证书校验,且未设置字面量 serverName,则代理会以拨号地址中的主机名作为 SNI 和校验目标。攻击者只需为其控制的主机申请一张公网可信证书(如 Let’s Encrypt),即可通过校验。随后,代理会将上游静态 API Key 作为认证凭据发送至该主机,导致密钥泄露。
这一缺陷的本质是“地址可控 + 证书可信”的组合突破了 TLS 的信任假设。TLS 本应保证通信对端身份可信,但当对端地址由攻击者控制且证书由公共 CA 签发时,TLS 校验形同虚设。
防御此类攻击的关键在于“双重校验”:一是对 namespace 实施白名单校验,阻断地址注入;二是在 TLS 配置中显式设置 serverName 并固定上游证书指纹或 CA,避免信任链被公网证书绕过。
三、修复方案与版本升级指南
官方已在 1.0.2、1.1.2、1.2.1 版本中修复该漏洞。修复的核心逻辑是在渲染上游地址前,对 namespace 进行严格校验,确保其符合预定义格式且不包含路径穿越或主机名注入字符。同时,建议在 TLS 配置中强制设置 serverName,并考虑使用自定义 CA 池替代系统信任库。
# 备份当前配置 cp /etc/temporal-proxy/config.yaml /etc/temporal-proxy/config.yaml.bak # 拉取修复版本(根据实际部署方式调整) docker pull temporalio/temporal-proxy:1.2.1 # 或使用二进制升级 curl -L https://github.com/temporalio/temporal-proxy/releases/download/v1.2.1/temporal-proxy-linux-amd64 -o /usr/local/bin/temporal-proxy chmod +x /usr/local/bin/temporal-proxy # 重启服务 systemctl restart temporal-proxy
点击展开:密钥轮换与配置加固脚本
# 1. 轮换上游 API Key(以 Temporal Cloud 为例,通过控制台或 API 重新生成)
# 2. 更新 temporal-proxy 配置中的 upstream.apiKey 字段
# 3. 重启代理使新密钥生效
# 配置加固示例(config.yaml)
upstream:
hostPort: "{{.Namespace}}.tmprl.cloud:7233"
tls:
enabled: true
serverName: "tmprl.cloud" # 显式设置,避免使用拨号地址
caFile: "/etc/ssl/certs/custom-ca.pem" # 建议使用自定义 CA 池
# 命名空间白名单(通过外部认证器实现)
auth:
external:
allowedNamespaces:
- "tenant-a"
- "tenant-b"
四、工业级防御架构与最佳实践
单点修复只能解决当前漏洞,要从架构层面消除此类风险,建议从以下三个维度构建纵深防御:
- 输入校验前置化:所有进入地址模板的变量必须经过严格白名单校验(如正则
^[a-z0-9-]+$),禁止包含点号、斜杠、井号等特殊字符。 - TLS 信任最小化:上游 TLS 校验应使用自定义 CA 池,并显式设置
serverName,避免依赖系统信任库。对于关键上游,可启用证书指纹固定(pinning)。 - 认证与授权解耦:认证器仅负责身份验证,授权层必须独立实施命名空间白名单,确保调用方只能访问其被授权的命名空间。
| 防御维度 | 传统方案 | 加固方案 | 架构收益 |
|---|---|---|---|
| 命名空间校验 | 无校验,直接渲染 | 白名单正则 + 长度限制 | 阻断注入 |
| TLS 校验 | 系统信任库 + 拨号地址 | 自定义 CA + 显式 serverName | 防中间人 |
| 认证授权 | 仅认证不限制命名空间 | 外部认证器 + 命名空间白名单 | 最小权限 |
升级后务必轮换所有可能暴露的 API Key。攻击者若已利用漏洞获取密钥,仅升级代理无法撤销已泄露的凭据。同时检查日志中是否存在异常 namespace 请求,以评估是否已被入侵。
