OpenRouter 为管理密钥收紧访问控制:支持只读与单工作区限定
Tighter Access Controls for Management Keys
OpenRouter 的管理密钥新增两项设置:Scope 限定密钥只在单个工作区或整个组织生效,Access level 限定为只读或读写,两者组合成四类密钥,创建后不可变更。工作区级密钥可管理本工作区的 API 密钥、成员、guardrails、provider keys 等,但设置预算、创建或删除工作区、管理组织成员仍需组织级密钥。该功能现已向所有组织、所有套餐开放。
管理密钥不再必须附带对整个组织的完整管理员访问权限。现在,你可以将密钥设为只读、限制其仅访问一个工作区,或两者兼有,这样每个密钥就只能执行其创建时指定的任务。只读密钥可以查看 API 密钥、活动和用量,读写密钥还可以创建、更新和删除 API 密钥。如果密钥泄露或被滥用,损害范围将受到控制。
即日起面向所有组织、所有套餐开放。你可以从工作区的 Keys 页面或 Management API Keys 创建密钥,并查看 management API keys guide 了解每种密钥可以调用哪些路由。

团队运行自己的工作区,现在他们的自动化也可以
随着组织在 OpenRouter 上发展壮大,他们会将工作拆分到多个工作区,通常每个团队一个。每个团队运行自己的工作区,而组织管理员负责管理所有人共享的内容:额度、预算和组织设置。
在此之前,管理密钥始终对整个组织拥有完整的读写权限。想要自动化自己工作区的团队不得不使用一个也能访问其他所有工作区的密钥。
现在每个密钥有两个设置。Scope 设定密钥的作用范围:一个工作区,或整个组织。Access level 设定它在该范围内能做什么:只读,或读写。工作区管理员可以为自己所在的工作区创建密钥,因此部署流水线可以轮换团队的 API 密钥,智能体可以设置防护规则,脚本可以将队友添加到工作区,而它们都无法访问其他团队的工作区。
Scope 将密钥限制在一个工作区内
工作区范围的密钥仅在其所属工作区生效。如果请求指定了另一个工作区,或属于另一个工作区的资源,OpenRouter 会拒绝访问。有缺陷的智能体或泄露的密钥无法触及组织的其余部分。
在其工作区内,该密钥可以管理 API 密钥、成员、防护规则和防护策略、你自己的提供商密钥、可观测性目标以及预设。它可以读取工作区的预算、活动和分析数据。
预算限制、额度和组织设置仍由组织管理员掌控。团队可以自动化其工作区内的一切,但仍无法提高自己工作区的预算。设置工作区预算、创建或删除工作区、管理组织成员以及私有端点仍然需要组织密钥,其工作方式与以往相同。
只读访问让工具只能查看而不能更改任何内容
访问级别是第二个设置,它同样适用于工作区密钥和组织密钥。只读密钥可以调用其范围允许的读取路由,包括分析查询。任何会创建、更改或删除内容的请求都会返回错误。
这适合那些只需要查看的工具。成本仪表盘可以拉取用量数据,监控智能体可以观察活动,审计脚本可以列出密钥、防护规则和提供商密钥。你可以接入新的报告或审计工具,而无需授予其对账户的写入权限。
为每项任务分配一个仅具备所需访问权限的密钥
Scope 和访问级别组合成四种密钥:
- 为一个团队创建和轮换 API 密钥的智能体,获得该团队工作区的读写密钥。
- 一个团队的用量仪表盘,获得该团队工作区的只读密钥。
- 组织范围的审计或成本工具,获得只读组织密钥。
- 任何创建工作区或设置预算限额的操作都会保留一个读/写组织密钥。
这两个设置在创建密钥时即固定,因此密钥之后无法获得访问权限。要更改其中任一设置,请创建新密钥并删除旧密钥。
在仪表板中创建密钥

- 打开工作区,前往 Keys,然后选择 Management keys 标签页。工作区管理员可以为其所在工作区创建密钥,组织管理员可以为任意工作区创建密钥。
- 点击 New management key。对话框会显示该密钥的作用域是哪个工作区。
- 输入名称,选择过期时间,并在 Access level 下选择 Read only 或 Read and write。
- 在密钥显示时复制它。之后你将无法再次看到它。
对于覆盖整个组织的密钥,组织管理员使用 Management API Keys 页面。
你的代理和工具使用该密钥的方式与今天使用管理密钥的方式相同,即作为管理 API 上的 Bearer token:
curl https://openrouter.ai/api/v1/keys \
-H "Authorization: Bearer $MANAGEMENT_KEY"要查看你已有的管理密钥,请打开 Security settings,前往 Key safety,打开 Filter keys,然后选择 Show management keys。每个活动密钥都会列出其所有者、上次使用时间和过期时间。management API keys guide 列出了每种密钥可以调用的所有路由。
来源:OpenRouter Announcements · openrouter.ai