为编程智能体接入隔离式凭证管理
开源应用 Agent Keychain 基于 Lit Protocol,支持代理获批后在本机解密凭证,或由安全飞地使用凭证并仅返回结果。后者旨在减少密钥进入智能体上下文及其日志的机会。
AI 深度解读
让 Claude Code 查 Stripe 余额,未必需要把 Stripe key 交给它。Agent Keychain 的思路是:把「允许执行某个操作」和「允许读取凭证」拆开,让代理拿到结果,而凭证留在安全执行环境里。
这篇原文值得读的地方,是把 AI 编程里的凭证风险讲到了具体执行环节:密钥离开仓库以后,还可能进入进程、日志和对话记录。工具怎么接入、权限如何收回、哪些风险依然存在,都需要分别看。
代理需要的是密钥,还是一次操作的结果?
Agent Keychain 是基于 Lit Protocol 的开源应用,提供两种使用凭证的方式。
第一种叫 stored secrets。凭证先在浏览器里加密,再由 Keychain 保存。获得授权的代理取回密文,在自己的机器上解密,通过环境变量或临时文件交给子进程。适合那些必须读取原始凭证才能工作的工具。
它解决了存储和交付问题,但密钥最终仍会以明文出现在执行机器上。子进程如果打印环境变量,或者把凭证写进日志,泄露依然可能发生。
第二种叫 connected services。代理调用的是 stripe_balance、github_read_file 这样的操作。Lit 在安全隔离区(secure enclave)里使用凭证执行操作,只把结果交回代理。
能读取余额的权限,不必同时包含读取支付密钥的权限。
这些操作来自公开目录,并固定到精确版本。操作清单(manifest)声明允许访问哪些主机、返回什么结构的结果。按原文描述,代理不能导出凭证,也不能让操作改做其他事情。
这和普通 secrets manager 的差别在执行阶段:后者通常把密钥交给进程,connected services 则把受限操作交给隔离区执行。
接进 Claude Code,需要配置什么?
先让代理在自己的机器上创建身份。原文称,只有公钥会离开这台机器:
npx @lit-protocol/keychain@2.2.0 init agent-identity.json
注意这里固定了 @lit-protocol/keychain@2.2.0,生成的 agent-identity.json 是后续接入所需的身份文件。
接着登录 Keychain,可以使用 Google、passkey 或钱包。添加凭证后,为代理公钥授权可用的 secrets 和 actions,并设置有效期,默认是 30 天。
下面这条命令把 Keychain 注册为 Claude Code 的 MCP server:
claude mcp add lit-keychain -- npx -y @lit-protocol/keychain@2.2.0 mcp /absolute/path/agent-identity.json
注意最后的绝对路径,要指向前面生成的身份文件。
接入后,代理会获得 list_secrets、get_secret、list_actions,以及每个已授权 connected service 对应的工具。同一个身份文件也适用于 Cursor 或其他 MCP 客户端。原文称它支持跨会话、跨设备使用,无需自行托管,但没有展开跨设备时身份文件如何保管。
脚本也能使用这套机制:npx @lit-protocol/keychain@2.2.0 run agent-identity.json --only STRIPE_KEY -- ./deploy.sh 会把指定凭证交给命令,CLI 自身不打印它。这里的 --only STRIPE_KEY 限定了注入范围,却不能阻止 deploy.sh 自己输出凭证。
撤销权限以后,哪些东西收不回来?
Keychain 的存储服务持有密文,以及用户签名的权限记录。按原文的安全模型,运营方没有解密密钥,也不能替用户批准代理或延长授权。
connected-service 的响应由隔离区签名;每次请求前,客户端检查硬件证明(hardware attestation)和链上获准运行时版本列表。硬件证明用于确认执行环境符合要求,版本列表则用于核对运行时是否获准。
不过,运营方仍能拒绝服务,也可能继续提供旧授权,直到那份授权到期。因此,正常情况下修改或撤销授权会在代理下一次请求时生效,但不能据此理解成所有旧权限都能立即失效。
撤销权限可以约束后续访问,无法收回代理已经拿到的内容。
另外,connected services 仍会通过 TLS 把凭证发送给上游服务商,对服务商的信任没有消失。当前合约钱包还不能作为所有者凭证。原文给出的价格是免费保存 5 个 secrets,每月 $10 可保存最多 1000 个,未说明操作调用是否另有额度限制。
我的判断
我认同把「用凭证」和「读凭证」拆开的方向。对查余额、读指定文件这类边界明确的任务,限制操作能力,比单纯提醒代理不要泄露密钥更有约束力。
但 stored secrets 仍属于把凭证交给本地工具的路线。它是否优于团队现有的 secrets manager,要看授权管理、接入成本和进程侧保护,原文没有提供对照数据。
connected services 的适用范围则取决于公开目录。原文没说清目录覆盖多少服务、自定义操作如何审核,也没有展示绕过测试或独立审计结果。「不能导出凭证」应当按其声明的安全模型理解,不能替它扩展成已经得到全面验证的安全结论。
能拿来做什么
- 给 Claude Code 或 Cursor 接生产服务前,先判断任务是否只需要一个结果;若已有匹配的 connected service,优先评估这种受限调用方式。
- 对必须读取原始凭证的 Node 脚本或部署命令,限定注入的 secret,并检查脚本是否打印环境变量、请求头或错误对象。
- 给代理授权时明确 secrets、actions 和有效期;如果它已经取得原始密钥,发生泄露后还需要更换密钥,不能只撤销代理权限。