编程代理的崩溃快照可能泄露访问令牌
一个 macOS 编程代理监控工具在事故快照中原样保存进程命令行,导致其中的 Bearer 令牌以明文落盘。审查发现,本机其他账户也能读取这些快照。
AI 深度解读
编码 Agent 的崩溃日志,也可能是一份明文凭据文件。作者团队在检查自家 Mac 监控工具时发现:事故快照保存了进程的完整命令行,其中可能带有 Bearer token,而且其他本地账户也能读取这些文件。
问题不在某个复杂漏洞,而在一条常见的数据流:工具把 token 放进启动参数,监控程序把参数写进日志,日志再沿用默认权限。作者用权限收紧、写入前脱敏、历史文件修复三步补上缺口。这套检查方法,值得维护 Node 脚本和 Agent 工具链的程序员借鉴。
为什么一份排障日志会变成凭据文件
作者团队开发了一个监控编码 Agent 的守护程序。当多个 Agent 进程同时消失时,它会生成事故快照,记录消失的进程、可疑进程,以及各自完整的命令行,帮助判断是谁终止了它们。
但命令行并不天然适合归档。例如:
node bridge.js --header "Authorization: Bearer ..."
token 一旦作为参数传入,就成为进程命令行的一部分,ps 可以显示它。监控工具再把命令行复制进 JSON,凭据就从运行中的进程进入了持久化文件。
原来的写入逻辑只有两行,目录和文件都使用默认权限:
fs.mkdirSync(INCIDENT_DIR, { recursive: true });
fs.writeFileSync(file, `${JSON.stringify({ ...incident, memory }, null, 2)}\n`);
要看的是第二行:整个对象直接序列化,没有在落盘前过滤敏感内容。至于文件最终谁能读,则交给了默认 umask。作者检查自己的文件后发现,其他本地账户也能读取快照。
只要日志保存了凭据,就需要按凭据文件管理它。
为什么修复必须同时覆盖权限、内容和旧文件
作者先把目录权限收紧到 0700,快照文件收紧到 0600,让它们仅供所有者访问:
fs.mkdirSync(INCIDENT_DIR, { recursive: true, mode: 0o700 });
fs.chmodSync(INCIDENT_DIR, 0o700);
...
fs.writeFileSync(file, text, { mode: 0o600 });
fs.chmodSync(file, 0o600);
这里关键的是两次 chmodSync。mkdirSync 和 writeFileSync 的 mode 只对新建对象生效,已经存在的目录或文件会保留旧权限。只加 mode,未必能修复正在使用的环境。
第二步是写入前脱敏。作者把 redactSecrets 递归应用到整个快照,将命中的秘密替换为 [REDACTED]。覆盖范围包括 Bearer token、Authorization 和 Cookie 请求头,--token=、--api-key、--password 参数,URL 密码,以及 mysql -p、sshpass -p、curl -u user:pass 等形式。带敏感名称的环境变量赋值和长 hex、base64 字符串也在处理范围内。
脱敏仍需保留排障价值。作者的测试要求假 token 从保存后的文件中消失,同时保留 pkill -f claude,因为程序名和终止原因才是调查所需的信息。
第三步处理历史文件。hardenIncidents 在 watcher 启动时运行,修正目录及已有快照的权限,并用同一个脱敏器重写内容。对应测试先创建一个含假 token 的 0644 文件,再验证它变成 0600,且 token 已被移除。
新代码不会自动清理上个月留下的秘密,这一步不能省。
脱敏测试为什么也要证明「这段不能删」
作者的脱敏器经过多轮审查,后来补上了向 docker login --password-stdin 输送密码的 here-string、包含转义引号的值,以及很短的秘密。
这些案例说明,只盯着常见长 token 的规则不够。但扩大匹配范围,又可能误删正常命令。
因此,每种新增规则都要配一个外观相似的正常样本。例如,cat <<< hello | wc -c 必须原样保留,不能因为出现 here-string 就被当成密码输入。
这比只检查输出里有没有 [REDACTED] 更有用:既证明秘密被清掉,也证明排障信息还在。否则,规则漏掉凭据和规则吞掉正常内容,都可能藏在一片「测试通过」里。
我的判断
我认同这三层修复:权限限制其他账户读取,脱敏减少文件携带的秘密,历史修复覆盖存量风险。它们解决的是不同环节,单靠其中一层不够完整。
但原文展示的是作者工具里的发现和针对性测试,没有给出泄露发生率、规则召回率或误删率的对照数据。它能证明这些样例得到了处理,不能证明脱敏器已经覆盖所有凭据形式。长 hex、base64 字符串也可能是正常标识,规则需要结合实际日志验证。
相比事后识别秘密,在启动时从文件读取 token,可以先减少命令行里的暴露。作者也建议这样做。不过,原文没有展开凭据文件自身的保护方式。对一般团队来说,更稳妥的方向是同时减少采集:确实只需要程序名和终止原因时,就应重新评估是否有必要长期保存完整命令行。
能拿来做什么
- 检查本地 Agent 工具生成的 crash report、incident log、session transcript 和 shell history,找出保存命令行或环境信息的文件,再用
ls -l检查文件及父目录权限。 - 可以从
grep -rEl "Bearer [A-Za-z0-9._-]{20,}" ~/Library/Logs ~/.config开始排查。保留只输出文件名的方式,避免把秘密再次复制到终端滚动记录;这条规则也不能替代对其他凭据形式的检查。 - 检查 MCP server 和 bridge 的启动配置。如果 token 通过参数传入,考虑改为启动时从文件读取,并检查相关日志是否已经留下历史副本。
- 给 Node 日志写入器补上显式权限、写入前递归脱敏和存量修复。测试同时放入假秘密与正常命令,验证安全性和排障信息都得到保留。