ORKS：API密钥撤销开放标准与well-known配置

资讯专家

背景
API 密钥泄露后，常见流程不是一键撤销，而是先找发行方、联系人、security.txt，再等回复。机器人持续扫描公开仓库，很多泄露凭据多年后仍有效。OAuth 在 RFC 7009 已有标准化 token 撤销端点，可通过 well-known 配置发现，但大量 API key 仍没有撤销方案。GitHub Secret Scanning Partner Program 通过 provider 注册 key 模式、扫描公开提交、webhook 撤销，但属于专有、中心化、邀请制。开源扫描器路线图都在做自动撤销，却需要逐家 provider 手工集成。

ORKS 提案
作者 Matt Honea 提出 ORKS（Open Revocable Key Standard），目标让凭据具备自毁/可撤销能力。核心四点：
1. 密钥标识发行方：固定前缀、编码 issuer 域、secret、校验和，格式为

2. orks_{issuer}_{secret}_{check}

复制代码

。扫描器离线即可知道该联系谁。
2. 可发现 kill switch：发行方在

2. /.well-known/api-key-config

复制代码

发布 JSON，列出撤销端点、可选 introspection 端点、安全联系人及支持的 key 约束。
3. 凭据持有即可撤销：向撤销端点 POST 完整 key，无需认证。持有 key 的人本就可滥用，允许其销毁更合理；要求完整 key 也避免枚举；端点无论 key 是否有效都返回 accepted。
4. 声明约束：发现文件公布是否支持 IP 白名单、强制过期、scope、mTLS 等。采购工具可用一次 GET 判断供应商是否支持 IP 固定 key。

隔离模式
反对未认证撤销的主要理由是可用性：任何人找到 key 都能用一次 curl 打断生产集成。ORKS 借鉴 Toyota andon cord 的可选 quarantine mode：未认证撤销不立即杀死 key，而是立即通知 owner，并让 key 进入受限状态（只读、限流、阻止破坏性操作、全记录），启动默认 24 小时计时器，到期自动撤销。Owner 可在认证 dashboard 中加速即时撤销，或在明确确认证据后取消，不能通过邮件链接取消。支付、管理类高风险 key 可由发行方声明 immediate mode。

AI Agent 场景
AI agent 是凭据倍增器：一个 agent 可能同时持有邮件、代码、CRM、支付、云基础设施密钥，团队部署速度常快于盘点。Agent 还可能被 prompt injection 诱导泄露自身凭据，并以机器速度把 secret 写入日志。从失陷到滥用的窗口缩短到秒级，依赖邮件的人工撤销太慢。ORKS 对 agent 有三点：机器可读 kill switch；护栏可在注入中途隔离凭据；声明约束可向不完全信任对象发放 IP 固定、限 scope、短 TTL key。更进一步，agent 完成任务后应自行撤销 key；配合 immediate-self-revoke 和短 TTL，可实现时间维度最小权限，日志中发现 key 时已失效，撤销调用也可作为审计事件。

落地方式
well-known 约定不需要中心权威，也不需要一次性全面采用。供应商可先给 key 加前缀、发布一个静态 JSON、上线一个撤销端点。扫描器则获得通用检测/撤销能力，每个新 issuer 都会让 scanner 更有用，类似 security.txt 的飞轮效应。最终流程：key 泄露，scanner 或持有它的 agent 在几分钟内发现，解码 issuer，访问 well-known 端点并隔离凭据；owner 收到通知、证据链接和轮换按钮，而不是欺诈报告。ORKS v0.1 草案包括端点 schema、key 格式和 quarantine 状态机，已在 GitHub 6d6b68/ORKS 开放评审和贡献。