
Redacted 工具发布:在 AI 编程助手读取前屏蔽密钥泄露
来源标题:Show HN: Redacted - Stop Handing Claude Your Secrets
开源工具 Redacted 在 AI 编程助手读取工具输出前自动移除其中的密钥。它作为 Claude Code 的 PostToolUse 钩子运行,在本地扫描、无网络请求,并用保留末 4 位的标记替换密钥。它还能学习 .env 文件中的密钥,即使格式不被常见规则识别也能拦截。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
从工具输出中移除密钥,在你的 AI 编码助手读取之前完成。
DATABASE_URL=postgres://admin:secret@db.example.com:5432/prod AWS_ACCESS_KEY_ID=AKIAEXAMPLEKEYID0001 SMTP_PASS="Qf7mZp2kLw9vTx4nRb2024" APP_NAME=myapp
模型实际读到的内容(第三行需要 SMTP_PASS 已被 redacted init 学习过):
DATABASE_URL=[REDACTED:database_url ...prod] AWS_ACCESS_KEY_ID=[REDACTED:aws_access_key ...0001] SMTP_PASS="[REDACTED:smtp_pass ...2024]" APP_NAME=myapp
为什么需要它
密钥会通过日常工作流入模型,而不只是通过 cat .env:
redacted 不判断命令本身。它清洗的是输出,无论输出来自什么。
作为 Claude Code 的 PostToolUse hook 运行:redacted scrub 从 stdin 读取每个工具结果。
扫描在你的机器上进行。不发起网络请求。
密钥会被就地替换为一个标记,标记保留其最后 4 个字符。
干净的输出原样通过。
安装
curl -sSL https://raw.githubusercontent.com/svn-arv/redacted/main/install.sh | sh redacted init
Homebrew、Cargo 以及适用于 Linux、macOS 和 Windows 的预编译二进制文件见参考文档。
它会学习你 .env 文件中的密钥,因此即使没有厂商模式知道其格式,hook 也能捕获它们。
为每个值存储 SHA-256 哈希、长度和可选形状。从不存储值本身。
你选择要学习的值,并在写入任何内容之前确认配置。
在 Claude Code 设置中注册该 hook。可安全重复运行。
完整演练和参数:Setup: redacted init。
层级
捕获内容
Default 厂商签名 具有已知格式的密钥:46 个内置模式,覆盖 AWS、GitHub、Stripe、OpenAI、Anthropic、数据库 URL、私钥等。 on
学习到的密钥 redacted init 从你的 .env 中学习到的值,按哈希匹配,外加具有相同前缀的轮换密钥。 on,一旦 init 写入条目
熵启发式 KEY=value 行中看起来随机的值,其他层级都不认识。 off
电子邮件地址和电话号码也可以被清洗。每一项在配置中开启之前都是关闭的。
每个模式及其匹配内容:What it detects。
Claude Code,通过 PostToolUse hook。
OpenCode,通过 redacted init --format opencode 写入的插件。
其他助手,以及它们的 hook 能否替换工具输出,列在 Other tools 下。
学习到的密钥按完整 token 匹配。嵌入在 token 中间的值(例如 URL 路径中的值)会通过,除非被厂商模式捕获。
学习到的形状也会匹配具有相同前缀和相似长度的非密钥值。确认之前请检查 init 显示的形状。
开启启发式后,混合大小写和数字的高熵标识符(某些工具或请求 ID)可能会被清洗。4 字符提示让这些很容易被发现。
每个模式依次扫描完整输出,之前会经过子串预过滤。多兆字节的输出会为每次调用增加明显延迟。
在 Claude Code 提示符中用 ! 输入的命令不是工具调用。它们的输出未经清洗就到达模型。
文档
参考:安装方法、init、每个模式、配置和命令。
架构:代码如何组织。
基准:测试语料上的召回率和精确率。
贡献:开发、添加检测规则和发布。
许可证
MIT
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。