深度解析塑造未来的技术文章。

AI智能体密钥泄露:扫描还是隔离

AI编程智能体的“不再询问”会把命令连同密钥一起记入配置文件。本文对比密钥扫描与隔离两种防御,并给出阻止凭证被提交的团队护栏。

一台机械配电盘,一根标签按位置标注的拉杆将发光的线缆分流,其中几根线缆的光从面板中溢出
权限白名单给人一种掌控感,但它们会悄悄归档你批准过的每一条命令,包括密钥。

安全研究人员刚刚发现,超过一千个公开的 GitHub 文件里躺着密码、API 令牌和云凭证。这些文件不是随手写的 .env,而是 AI 编程智能体的设置文件。问题出在一个悄无声息的模式上,即 AI编程智能体密钥泄露:开发者批准了类似 curl -H "Authorization: Bearer sk-..." 的命令,点了“不再询问”,完整命令(连同令牌)就被写进了本地设置文件。把这个文件提交上去,密钥就公开了。我做基础设施安全已经多年,这是我见过的最可避免的泄露类型之一。而且它还相当新,因为会泄露密钥的这个文件,两年前还不存在。

团队通常会用两种防御手段:密钥扫描(发现泄露后清理)和隔离(确保密钥从一开始就不会碰到智能体或代码仓库)。两者都必要,单独都不够。本文将二者正面对比,讲清各自何时最有效、又在哪里失效,最后给出我在使用 Claude Code、Cursor 或任何带权限白名单的智能体的团队里真正会部署的方案。

先说明一点:这不是反对智能编程工具的文章。我每天都在用,也回不去了。权限提示(智能体问你“我可以运行这个吗?”)确实是这类工具提供的更好的安全机制之一。问题完全出在你点“同意”之后:这个“同意”被记录在哪里,里面包含了什么。

白名单如何变成密钥仓库

要理解这种失效模式,得先看“不再询问”到底保存了什么。当智能体式 CLI 请求运行某条命令时,朴素的实现会把完整的命令字符串存进权限规则里。不是模式,不是哈希,而是你批准时的那段原始字符串。

所以,批准 aws s3 cp s3://bucket/backup.sql . --profile prod 没什么问题。但如果批准的是 psql postgresql://admin:hunter2@db.internal/myapp 或 curl -u deploy:APIKEY123 https://.../deploy,凭证就会躺在 .claude/settings.local.json 或同类配置里。这个设置文件本意是保留在本地的,Claude Code 如果是由工具自己创建的,还会自动加入 gitignore。但如果开发者是手动创建的文件,或者强制添加了它,又或者全局 gitignore 没覆盖到,那么一次 git add . 加一次 push,它就上了 GitHub。这正是研究人员发现那 1,122 个文件背后的完整链条。

注意这条链上有多少环节单独看都很合理。在交互式场景下批准带内联凭证的命令,开发者几十年来一直这么做,毫无后果:命令执行,shell 历史留在本地,没人在意。点“不再询问”也是理性选择,提示疲劳是真实存在的,而这类智能体最大的卖点正是减少打断。即便是 git add .,在工具告诉你文件是本地的时候,也站得住脚。这次事件不是由某一个粗心举动造成的,而是一个系统让五个无害的动作组合成了一份公开的凭证。这类安全问题最难修,因为没有任何一个人觉得自己做错了什么。

在智能体出现之前,我就在现实中见过完全相同的错误。我曾咨询过的一家金融科技公司,团队负责人为 CI 辅助机器人写了一个 allowed_commands.sh,思路一样,只是手写的。有人批准了一条一次性的数据库迁移命令,里面内联了 DSN。六个月后仓库被开源,DSN 却留在了一个没人想去审计的文件的 git 历史里,理由是“它不算配置”。但那个文件就是配置,只是看起来不像而已。

这就是核心洞察:权限白名单本质上是配置文件,会把运营密钥作为副作用记录下来。没人审查它们是否含有密钥,因为没人把它们当成承载密钥的文件。你的密钥管理策略覆盖的是 .env、credentials.yml,也许还有 Terraform 状态文件,几乎肯定不包括 .claude/settings.local.json 或 .cursor/ 下的配置。我们之前写过一个类似的盲区,见把 API 客户端当作凭证保险库来审计。你每天用的工具,会把密钥积累在你的策略从未提及的地方。

而且这类问题正在增多。过去几年里,每一款智能体工具都有某种变体:白名单、受信目录、记住的审批、带内联令牌的 MCP 服务器配置。每一个都是一条全新的文件路径,而你现有的策略、gitignore 和扫描器配置都没有提到它。下一次类似事件,还会是同样的错误,只是出现在另一个文件名下。

密钥扫描与隔离:两种防御

下面我会按这个对比框架展开:

  • 检测优先(密钥扫描):pre-commit 钩子、gitleaks 和 trufflehog 等仓库扫描器、GitHub 或 GitLab 的推送保护,外加定期的历史扫描。假设密钥一定会泄露,尽快发现并轮换。
  • 隔离优先(让密钥不出现):密钥只通过环境变量、密码管理器 CLI 或短期凭证进入命令;智能体在沙箱或临时虚拟机中运行;本地设置文件在全局 gitignore 中忽略。通过设计,让没有东西可泄露。

检测是一种事后清理,隔离是一种设计属性。两者的失败方向截然相反:扫描会有漏报,而且总是事后才运行;隔离则有采用成本,还会与开发者的使用习惯相冲突。哪种更好,取决于你能容忍哪种失败模式。

两者随时间退化的方式也不对称。扫描是平缓退化的:漏掉一个密钥很糟糕,但它抓到的那些仍然会被抓住,规则集还会不断改进。隔离则是因例外而退化。每当开发者绕过摩擦(“就这一次,我直接粘贴令牌”),这项属性就会被削弱,而且没有任何日志记录这种削弱。你只能像发现门没锁一样,等到有人去检查时才知道隔离失效了。这就是为什么二者应当互补而非对立,但我对它们的权重不同。下一节会解释:尽管扫描是业界的默认答案,但就这类泄露而言,它是两者中较弱的一个。

密钥扫描:优势与硬性局限

当泄露已经发生或即将发生时,扫描最有用。考虑到人性,这种情况相当常见。GitHub 的推送保护会在推送时拦截已知格式的令牌。pre-commit 钩子中的 gitleaks 能在代码离开笔记本之前抓住相当多的问题。如果你这篇文章里只做一件事,那就做这个:

# .pre-commit-config.yaml
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.18.4
hooks:
- id: gitleaks

花十分钟配置,本文讲的这类泄露(提交到设置文件里的令牌)基本就消失了,因为 gitleaks 并不在乎文件是不是 JSON 设置文件。它扫描的是内容,而不是文件名。如果你有内部令牌前缀,可以再加一条正则。

还有一层很值得加、但团队常常忘掉的扫描:定期扫描你本机上未提交的密钥。仓库级的钩子只会在 commit 或 push 时触发。一个设置文件在磁盘上躺三个月,直到某人执行 git add .,这三个月里密钥随时可能被一条命令公开。定时任务(哪怕是每周跑一次、对主目录 dotfile 执行 gitleaks 的 cron)也能把这个窗口缩短到几天。虽然不太优雅,但确实有效。

不过,扫描有三个硬性局限,Claude Code 这件事把它们暴露得很清楚。第一,基于熵值的检测器会漏掉低熵密钥。psql 连接字符串里的 Winter2024! 这样的密码,不会触发熵值检查;如果它不是已知服务商的格式,也没有任何规则能匹配。研究人员发现的大量都是普通密码,而不只是 AWS 风格的密钥。第二,扫描在推送层面是事后的。推送保护拦住了推送,这很好,但如果它没有触发,密钥就已经进入历史,而历史是永久的。泄露之后轮换凭证,意味着要找出凭证被使用的每一个地方,而我从没见过这种清理能在一天之内完成。第三,扫描会制造一种虚假的完整感。团队看到绿色的对勾,就不再去想密钥是如何流转的。正如我们在关于 AI 安全扫描器的文章里所说,扫描器是安全网,而不是不犯错的替代品。

就第二点而言,值得精确说明凭证真的落到公开仓库之后,“清理”到底包括什么,因为团队总是严重低估它。轮换是最简单的部分:吊销令牌、签发新的、更新密钥存储。难的是考古工作。每一条部署流水线、定时任务、开发者笔记本和第三方集成,凡是用过旧凭证的,都必须找出来并更新,漏掉一个,就可能在最糟糕的时刻引发故障。还有一个镜像问题:如果仓库是公开的,你必须假设密钥在几分钟内就已被抓取。凭证收割机器人会持续监听 GitHub 事件流。等你的扫描器发出警报时,密钥很可能已经被克隆、被索引,甚至已经拿去尝试访问你的生产端点。检测让你知道了问题,却没有让你变得安全。

话虽如此,我也想对扫描公平一点,因为在这类讨论里它太容易被轻视。对于拥有数百个仓库、数千名开发者的大型组织来说,扫描是唯一无需改变行为就能规模化的一层。在这种规模下,你不可能靠培训消除泄露,但可以靠推送保护消除其中大部分。如果你是平台团队,要决定第一周的工作重点放在哪里,答案就是扫描:它便宜、集中管理,而且能抓住造成最大损害的高熵服务商令牌。只是别把它当成完整的解决方案。

一张网眼很大的渔网从黑水中被拉起,大部分发光的鱼从缝隙中逃走,只有少数被捕获
扫描能抓住它识别出的密钥,低熵密码和新格式则会漏过。

隔离:环境变量、沙箱与短期凭证

隔离适用于所有“否则密钥就会被写下来”的场景,而这次事件恰恰就发生在这里。如果凭证从未以字面字符串的形式出现在命令里,白名单就没有任何危险内容可存。批准的命令变成 curl -H "Authorization: Bearer $DEPLOY_TOKEN" ...,设置文件里只有一个无害的变量名。两条规则基本能覆盖大部分情况:

  • 密钥只能通过环境变量或间接引用进入命令($TOKEN、$(op read ...)、或智能体在运行时读取的配置文件),绝不以字面值出现。
  • 智能体本地的配置目录(.claude/、.cursor/、.aider*)应加入机器级全局 gitignore(~/.config/git/ignore),而不只是按仓库配置,这样任何项目都无法提交它们。
# Global gitignore covers every repo on this machine
git config --global core.excludesFile ~/.config/git/ignore
cat >> ~/.config/git/ignore <<'EOF'
.claude/
.cursor/
.aider*
.env*
EOF

为什么要全局配置而不是按仓库配置?原因有两个。第一,按仓库的 gitignore 只有在有人记得把它加到每一个新仓库时才存在,而新仓库恰恰是在没人想着安全卫生的时候创建的。第二,全局 gitignore 是机器策略,而不是项目策略。它不会在某个“顺便整理 gitignore”的 PR 里被意外删掉,而这种事我确实亲眼见过。按仓库的版本保护的是一个代码仓库,全局版本保护的是开发者,而在这里,开发者才是最容易泄露的单位。

环境变量这条规则也值得同样仔细地审视,因为它有一个隐蔽的失效模式:shell 配置文件。如果开发者为了满足环境变量的要求,在 .bashrc 里 export DEPLOY_TOKEN=sk-...,那你只不过是把密钥从一个未经审查的 dotfile 挪到了另一个。这条规则必须落到一个真正的密钥后端上,比如 1Password CLI、从加密存储读取的 direnv,或者在会话开始时通过 aws ssm 或 op inject 注入的云端密钥管理器。智能体拿到的是变量,磁盘上永远不会存放值。这只多了一层间接,却是真隔离与表面功夫之间的区别。

更强的隔离方式,我称之为真正的沙箱:为每个任务在临时虚拟机或容器中运行智能体,放在隔离网络里,并在外部 API 前面加一层代理。我很欣赏的一种实践方案,是在智能体和拥有全部权限的 SaaS 密钥之间放一个 API 代理:读操作直接放行,写操作需要在手机上点一下确认。这才是做对了的纵深防御。即便智能体被完全攻破,并且带着 --dangerously-skip-permissions 运行,它也只能触及代理允许的范围。关于更广泛的权衡,我们在AI 智能体的隔离与监控之争里讨论过,这次事件是支持隔离的一个论据。

短期凭证是强方案的另一半,它常常被低估,因为即使其他所有层都失效,它也能缩小爆炸半径。一把静态的 AWS 访问密钥泄露到 GitHub 上,只要没人发现,它就一直有效。而一个有效期只有一小时、通过 OIDC 签发的凭证即使泄露到 GitHub,也只是一条过期的日志。如果你的云服务商支持工作负载身份联合(所有主流服务商都支持),那么智能体的凭证过期速度,应该快过你的事件响应流程召开一次会议的速度。

隔离的真实代价是摩擦。密码管理器 CLI 意味着任务进行到一半时要弹出指纹验证;临时虚拟机意味着每次运行都要花时间搭建,并承受冷启动延迟;限定范围的代理则意味着有人得去构建和维护它。对于做个人副业项目的独立开发者来说,完整沙箱就杀鸡用牛刀了,全局 gitignore 加环境变量才是正确选择。而对于智能体会接触生产凭证的团队,这些摩擦就是避免成为下一个数据泄露公告的代价。

中间层:修复白名单本身

还有第三种选择,但它掌握在工具厂商手里,而不是你手里:不要存储原始命令。如果权限规则以模式的形式保存 curl -H "Authorization: Bearer *",并且把参数值脱敏,那么它在匹配上同样好用,又不携带任何密钥。Claude Code 团队已经表示正在研究防止这类问题,他们推荐的方向是一种自动权限模式,根本不需要维护允许/拒绝列表。这个方向是对的。每一份手动维护的白名单,都是一个你暂时还看不见的、带着时间戳的未来事故。

需要明确的是,模式匹配并非没有代价。像 curl * 这样的通配符,对良性的部署命令和恶意的数据外泄命令同样匹配,因此激进的脱敏是在用泄露风险换取审批范围风险。更好的设计大概是结构化而非文本化的:只记录批准了哪个可执行文件和哪些参数标志,永远不记录参数值。这样既能保持匹配的精确性(允许带请求头的 curl,拒绝把 curl 的输出管道到新域名),又不会存下任何可能藏着凭证的东西。厂商迟早会做到这一点,现在的动力已经是一千多个公开文件构成的证据。

在厂商发布这类功能之前,你可以用一些卫生习惯来近似实现:定期对本地设置文件本身运行扫描器。像 gitleaks detect --no-git --source ~/.claude .claude 这样的一行命令,就能审计本文所讨论的那些文件,而且是在它们接近任何仓库之前。把它加到你的 dotfiles 初始化脚本里,几乎零成本。

我的建议:默认隔离,扫描兜底

如果非要二选一,那就选隔离。一次从未发生的泄露,永远胜过一次被迅速发现的泄露。扫描是你在隔离失效时才依赖的东西。而它一定会失效,因为总有人会在凌晨一点把连接字符串粘贴到聊天窗口里,但它应当是例外处理程序,而不是策略本身。

具体来说,如果一个团队本季度要推广智能编程工具,按投入从低到高排列:

  1. 在每台开发者机器上为智能体配置目录设置全局 gitignore:五分钟,就能彻底消除提交配置文件导致的泄露。
  2. 规则:密钥只能通过环境变量或密码管理器 CLI 传递,绝不内联在命令里。把它写进新人入职流程,而不是放进没人读的维护文档。
  3. 把 gitleaks 作为 pre-commit 钩子,并在代码托管平台开启推送保护,作为上述所有措施的安全网。
  4. 智能体会接触的任何东西都使用短期、限定范围的凭证(用 OIDC 签发的云凭证替代静态密钥),让泄露的凭证在几小时内失效。
  5. 对于拥有生产环境访问权限的智能体:使用临时沙箱,加上一个限定智能体凭证权限范围的 API 代理。

注意这个顺序。前两项是最便宜的隔离措施,它们消除的是整个事件类型,而不是降低其发生概率。扫描相关的条目排第三,并非因为它们不重要,而是因为它们是钢丝绳下方的安全网,应该在你检查好绳索之后再去架设。第四和第五项则是从防御意外转向防御入侵的地方,而智能体工具正朝这个方向发展,无论我们是否计划好了。

一座带小门的城堡外墙,墙后是第二道内墙,中央是一个上锁的保险库
分层隔离:即便外墙被攻破,内部的保险库里也没有可以静态偷走的东西。

光前两项,就足以防止研究人员数据集中几乎每一个文件的泄露。这次事件最让人沮丧的地方在于:它不是什么高明的攻击,而是一种新的文件类型承载着一个老错误。修复方法也就是我们从第一次提交 .env 起就一直在宣扬的那套卫生习惯,只是应用到一个还没有出现在任何策略里的目录上。

更新你的策略吧。智能体不会消失,“不再询问”那个按钮也不会消失。