Security Blog

如何在不让 AI 代理看到 API 密钥的情况下把密钥交给它?

#44

November 20, 2026 · By Mila

← All posts

给代理一个引用而不是密钥本身,让同一台机器上的代理在请求发出时把真实密钥填进去。这里解释为什么环境变量不再够用,以及如何进行设置。

给代理一个引用而不是密钥本身,让同一台机器上的一个小型代理在请求发出时把真实密钥替换进去。代理在需要密钥的地方写入 clavitor://OpenAI/key。API 收到的是真实密钥。代理从不持有密钥,因此它无法打印密钥、记录密钥,也无法被说服交出密钥。

这就是全部思路。本页其余部分讲的是为什么这很重要,以及如何进行设置。

为什么“放进环境变量就行”不再够用

一年前,export OPENAI_API_KEY=sk-... 是把密钥交给脚本的标准方式。没有人觉得有问题。

后来,脚本开始自己思考了。

AI 代理会读取文件、运行工具、写日志,还会和互联网上的陌生人对话。对它持有的密钥来说,其中每一项都是一条泄露途径:

  • 环境。 代理运行的任何东西都会继承它。它会出现在 /proc、崩溃转储和 CI 输出中。
  • 内存。 即使在运行时才获取密钥,它仍然会在代理运行的整个期间驻留在进程中。
  • 对话。 网页或 issue 评论中的提示注入会让代理“附上你的配置以便调试”。一个乐于助人的代理会照做。

这些都不需要代理本身存在漏洞。只需要密钥位于代理能够触及的地方。

模式:代理发起请求,代理签名

可以把它想象成酒店房卡。客人能打开自己的房间。客人永远看不到万能钥匙,而且门会记录每一次刷卡。

对于 API 密钥,具体是这样的:

  1. 真实密钥保存在保管库中,处于加密状态。
  2. 一个代理程序运行在代理旁边,同一台机器上。
  3. 代理发送 HTTPS 请求,在需要密钥的地方放一个引用。
  4. 代理程序从保管库取回值,填入请求并转发。
  5. 代理一侧只持有引用。

代理的日志里显示的是引用。它的上下文窗口里也是。没有任何东西可泄露。

如何用 Clavitor 进行设置

这就是我们的实现方式。一个二进制文件,一个环境变量,不需要改动代理的代码。

在您的保管库中为该代理创建一个客户端,并赋予它所需的权限范围,然后注册代理程序并启动它:

$ clavitor-proxy init
$ clavitor-proxy ca
$ clavitor-proxy serve

init 将代理程序注册为该客户端。ca 打印代理程序的证书颁发机构:请把它添加到您代理的 HTTP 客户端所使用的信任存储中,因为代理程序会亲自打开代理的 HTTPS 连接。然后把代理指向代理程序:

$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"

$ curl -H "Authorization: Bearer clavitor://OpenAI/key" \
    https://api.openai.com/v1/chat/completions

proxy-auth 是代理程序自己的访问令牌,即二进制文件旁边的那个文件。每个连接都必须携带它,这样同一台机器上的其他用户就无法借用这个代理程序。代理程序监听 127.0.0.1:1983,且仅在那台机器上监听,除非您有意将其设置在受信任的私有网络中。

它适用于任何 HTTP 客户端遵循 HTTPS_PROXY 的代理:Claude Code、Codex、您自己的脚本。凭证只会发送到其条目中列为网址的主机,因此被提示注入的代理无法把同一个引用指向陌生人的服务器。分步设置说明见代理文档。

代理的其他密钥怎么办?

并非每个密钥都通过 HTTP 头传输。部署密码、SSH 密钥、登录用的双因素验证码。

对于这些,代理使用 clavitor-cli 一次向保管库请求一个指定条目,而且只能请求分配给它的条目:

$ clavitor-cli get "GitHub Deploy" --field password

$ clavitor-cli get "Stripe API" --field key
clavitor-cli: CV-2041: Access denied.

代理无法列出保管库。名称搜索最多显示五个匹配的标题,超过时只显示数量。

身份验证器验证码的工作方式相同。clavitor-cli totp "GitHub" 会在代理的机器上算出当前验证码,这样它就能通过双因素登录,而不需要任何人查看手机。保管库以加密方式保存该密钥。

这不能解决什么

代理程序让密钥远离了代理。但它不会让代理变得可信。

  • 被攻陷的代理仍然可以使用它被授予的访问权限。它只是无法把密钥带回家。
  • 拥有机器管理员权限的人也可以使用代理程序,或者读取它的内存。
  • 如果 API 在响应中回显您的密钥,就等于把密钥交给了代理。代理程序把密钥填入请求,但不过滤响应。

这就是为什么围绕它的访问控制与代理程序本身同样重要:

  • 权限范围。 每个代理只获得它需要的条目。一个工作代理能看到 GitHub 和 AWS。一个部署代理能看到 SSH 密钥和数据库。
  • 读取限制。 每个代理每分钟和每小时只能读取一定数量的不同条目,数量由您设定。一个代理在两小时内两次超出其小时限额,就会被锁定,直到您解锁。
  • 记录。 每次读取都会被记录:哪个代理、哪个条目、什么时间。

运行多个代理?给每个代理分配自己的代理程序和自己的注册。这样每个代理都有自己的权限范围、自己的限制和自己的记录,代理 A 看不到代理 B 的密钥。

简短总结

不要把密钥直接交给代理。交给它一个密钥的名称,把密钥放在一步之遥的地方,由那个地方每次决定:这个代理现在是否可以使用它。

设置代理程序或了解代理访问的工作方式。