iron-proxy MITM原理详解:动态生成TLS叶子证书,让HTTPS内容检查安全可行

原创2026-10-27 14:59:371,692 阅读

iron-proxy MITM原理详解:动态生成TLS叶子证书,让HTTPS内容检查安全可行

iron-proxy 是一款面向不可信负载(CI 作业、AI 编码 Agent、沙箱容器)的出口防火墙(egress firewall),它的核心能力正是 MITM 式出口代理:在代理侧动态生成 TLS 叶子证书,终结 HTTPS 连接,从而让默认拒绝、密钥替换和内容审计等检查安全可行。这篇文章带你看懂它是怎么做到的,以及如何在生产环境中正确启用。

iron-proxy MITM 动态生成 TLS 叶子证书演示:拦截数据外泄并实时替换真实密钥

为什么必须先解开 HTTPS 才能做内容检查?

HTTPS 流量在客户端和上游服务器之间端到端加密。中间的代理如果只看到 CONNECT host:443,它最多只能判断"访问了哪个域名",无法检查请求头里的 API Key、无法拦截 body 中的敏感信息,也无法在上游地址解析到内网元数据端点(IMDS)时及时拦截。

要真正做内容级检查,代理必须"站在 TLS 中间"——也就是 MITM(中间人)。传统上 MITM 是安全负面词汇,但 iron-proxy 把它做成了受控、默认拒绝、可审计的出站治理工具:

容器 → DNS 查询 → 解析到 iron-proxy IP → TLS 终结 → Transform 流水线 → 上游

关键难题只有一个:如何让客户端不报证书错误地信任一个"中间人"。iron-proxy 的答案是:用你自己私有的 CA,为每个域名按需动态签发 TLS 叶子证书。

核心机制:按需动态生成 TLS 叶子证书

1. 从 SNI 中读出目标域名

客户端发起 TLS 握手时,第一个消息 ClientHello 里带有 SNI(服务器名称指示)字段,明文包含目标域名。iron-proxy 在 HTTPS 监听器上注册了 Go 标准库的 GetCertificate 回调,从握手信息中取出 ServerName,见 proxy.go:

func (p *Proxy) getCertificate(hello *tls.ClientHelloInfo) (*tls.Certificate, error) {
    return p.certCache.GetOrCreate(hello.ServerName)
}

也就是说:每次握手时代理才知道要访问哪个域名,证书也是这一刻才去取(或现造)的。

2. 用私有 CA 现场签发叶子证书

证书生成逻辑在 cache.go,每个域名的证书都是"一次性签发"的:

项目 实现
密钥算法 每次生成全新的 ECDSA P-256 密钥对,互不复用
主题 CN = 目标域名,DNSNames = [目标域名]
有效期 默认 72 小时(leaf_cert_expiry_hours),NotBefore 回拨 1 分钟防时钟偏差
签名方 你提供的私有 CA 证书 + 私钥
缓存 以域名为 key 的 LRU + 过期淘汰(默认容量 1000)

GetOrCreate 的取证书逻辑(cache.go)保证三件事:

  • 命中缓存直接复用:同域名的后续请求不需要重复签证书,握手开销几乎为零;
  • 过期即重签:即使 LRU 条目还在,墙钟已过期也会被移除重签;
  • 并发安全:互斥锁防止同一域名被重复生成。

签发的证书链是 [叶子证书, CA 证书]——如果你的 CA 是中间 CA,客户端只要信任它的父根证书即可完成校验,这个细节也写在了源码注释里。

3. 为什么这样是"安全可行"的

  • 密钥最小化:沙箱里只有代理 token(泄漏后在代理外毫无价值),真实密钥只存在于代理边界(secrets transform 负责替换);
  • 单域名单证:每个叶子证书只绑定一个域名、短有效期,即使某张证书泄露,攻击面也被限制在该域名和有效期内;
  • CA 全程离线使用:CA 私钥只放在 iron-proxy 容器内,签名只在代理内部完成;
  • 全程留痕:每个请求都会输出结构化 JSON 审计日志,记录哪些规则命中、哪些密钥被替换、什么被拦截。

第一步前置准备:生成私有 CA

iron-proxy 要求 MITM 模式下提供 tls.ca_cert 和 tls.ca_key(config.go)。你可以用 openssl 手工生成,更简单的是直接用项目自带的子命令,见 generate_ca.go 与 cagen.go:

# 生成 ca.crt / ca.key,默认 rsa4096,有效期一年
iron-proxy generate-ca -outdir ./certs -name "iron-proxy CA"

# 也可以用更轻量的 ed25519
iron-proxy generate-ca -outdir ./certs -alg ed25519

生成的 CA 带有 IsCA=TRUE、KeyUsageCertSign 等正确约束(cagen.go),且 WriteFiles 拒绝覆盖已存在的文件,避免误伤生产 CA。

客户端如何信任这套证书?

MITM 要"对用户无感",唯一前提是客户端信任你的 CA。iron-proxy 的设计是让 CA 只分发到受管沙箱容器里,而不是公司全员机器:

docker run --rm \
  --dns 172.20.0.2 \
  -v $(pwd)/certs/ca.crt:/certs/ca.crt:ro \
  curlimages/curl --cacert /certs/ca.crt https://httpbin.org/get
  • 把容器的 DNS 指向 iron-proxy,所有域名都会被解析到代理 IP(内置 DNS 服务器实现);
  • 挂载 ca.crt 并通过 --cacert(或 NODE_EXTRA_CA_CERTS、CURL_CA_BUNDLE 等)让运行时信任它。

这样一来,客户端与代理之间的 TLS 由"动态叶子证书 + 你的 CA"完成校验,代理再与上游建立独立的真实 TLS 连接——两段加密、中间解密检查,即标准的 MITM 出口代理架构。

装不了 CA 怎么办?sni-only 降级模式

如果某些客户端根本无法注入 CA,iron-proxy 提供 tls.mode: "sni-only"(默认是 mitm),配置示例见 iron-proxy.example.yaml:

tls:
  mode: "mitm"          # 或 "sni-only"
  ca_cert: "/etc/iron-proxy/ca.crt"
  ca_key: "/etc/iron-proxy/ca.key"
  cert_cache_size: 1000
  leaf_cert_expiry_hours: 72

sni-only 模式下,代理通过 snipeek.go 里的 peekSNI 技术"偷看" ClientHello:借助 GetConfigForClient 回调捕获 SNI 后立即中止握手(并吞掉告警字节),然后把读到的原始字节原样重放给上游,完成纯 TCP 透传。不终结 TLS、不需要 CA,代价是 Transform 流水线只能看到域名,allowlist 之外的头/体级检查均无法生效——这是能力与部署成本的取舍,建议能用 mitm 就用 mitm。

最快上手:docker compose 三步跑通

仓库自带演示环境 examples/docker-compose/,配置文件见 proxy.yaml:

cd examples/docker-compose
docker compose up
docker compose logs proxy   # 查看放行 / 拦截 / 密钥替换的审计日志

docker-compose.yml 会自动生成 CA、挂载到代理与客户端容器,并启动一个发起 5 个请求的演示客户端。每个请求都会在日志中留下形如 {"action": "allow", "request_transforms": [{"name": "secrets", ...}]} 的结构化记录——你可以亲眼看到动态证书背后完整的检查链路。

生产环境注意事项清单

  1. CA 私钥只进代理容器:ca.key 挂载为只读,客户端永远只拿 ca.crt;
  2. 关注两个 tls 调优参数:cert_cache_size(默认 1000,域名极多时调大)与 leaf_cert_expiry_hours(默认 72,短有效期缩小泄露窗口);
  3. 默认拒绝 + 上游 CIDR 黑名单:动态证书让代理得以在 DNS 解析后再次校验目标 IP,默认封禁 169.254.169.254 等云元数据地址,封堵 SSRF/DNS 重绑定漏洞;
  4. 先用 warn: true 灰度:allowlist 支持观察模式,先记录"会被拦什么"再切到强制执行;
  5. 明确信任边界:装了你的 CA 的容器 = 你可检查的边界。对边界内的流量,iron-proxy 已用密钥外置(token 替换)和逐请求审计把风险压到最低。

小结

iron-proxy 把 MITM 从"调试工具"变成了生产级出口治理组件:私有 CA + 按 SNI 动态签发短有效期叶子证书 + LRU 缓存,让 HTTPS 内容检查既安全(密钥不外泄、泄露面最小化)又可行(客户端信任一个 CA 即可无感工作)。配合默认拒绝的 allowlist、边界密钥替换和全量审计日志,它非常适合 CI 流水线、GitHub Actions 以及 Claude Code、Cursor 这类 AI Agent 沙箱场景。

感兴趣的话,可以从这三个入口深入源码:

登录后查看全文
iron-proxy