AGENTIC COMMONSAI 產業簡報

繁中EN

主題AI 安全與防護出版

返回文章列表

OpenRouter 管理金鑰現可唯讀、限定單一 workspace

**摘要:**OpenRouter 在 2026 年 11 月 16 日由 Sasha Blumenfeld 宣布,管理金鑰不再等同整個組織的完整管理員權限。每把金鑰現在建立時可設定兩件事:作用範圍(單一 workspace 或整個組織)與存取層級(唯讀或讀寫),讓金鑰只做它被建立時要做的的事。所有組織、所有方案即日可用,不需要升級付費方案。

兩個設定決定一把金鑰能做什麼

Scope 決定金鑰在哪裡生效:限縮到某個 workspace 時,只要請求指向另一個 workspace 或屬於它的資源,OpenRouter 一律拒絕。存取層級則決定它能做什麼:唯讀金鑰可以呼叫範圍內的讀取路由,包括 analytics 查詢;任何建立、修改、刪除的請求都會回傳錯誤。

Workspace 範圍內的金鑰可以管理 API keys、成員、guardrails 與 guardrail policies、自己的 provider keys、observability 目的地和 presets,也能讀取該 workspace 的預算、活動紀錄與分析資料。但預算上限、credits 和組織設定仍然留在 Organization Admin 手上——一個團隊可以在自己的 workspace 裡自動化所有事,還是無法調高自己 workspace 的預算。設定 workspace 預算、建立或刪除 workspace、管理組織成員和 private endpoints,依舊需要組織層級的金鑰,用法跟過去一樣。

四種金鑰,對應四種工作

Scope 和存取層級組合出四類金鑰,官方各給了一個例子:

  • 為某個團隊建立和輪替 API keys 的 agent:該 workspace 的讀寫金鑰。
  • 只看用量的 dashboard:該 workspace 的唯讀金鑰。
  • 跨組織的稽核或成本工具:唯讀的組織金鑰。
  • 需要建立 workspace 或設定預算的工作:讀寫的組織金鑰。

兩個設定在建立當下就固定,之後不能更改;要調整就得建立新金鑰、刪除舊的。金鑰的用法不變,仍是管理 API 上的 Bearer token:

curl https://openrouter.ai/api/v1/keys \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

建立入口在 workspace 的 Keys 頁面的 Management keys 分頁;Workspace Admin 只能替自己的 workspace 建金鑰,Organization Admin 可以替任何 workspace 建。要盤點手上已有的管理金鑰,走 Security settings 的 Key safety,用 Filter keys 選 Show management keys,每把有效的金鑰會列出擁有者、最後使用時間和到期日。

取捨:設定固定,換設定就是換金鑰

最直接的代價是輪替成本。Scope 和存取層級不可更改,意思是權限需求一變,管線裡就要走一遍「建新金鑰、更新變數、刪舊金鑰」的流程。對部署腳本來說這是多一步維護,但對安全而言,金鑰無法事後升權,反而消除了「先給全部權限之後再收窄」常見的遺忘風險。另外,官方文件只說明如何列出有效金鑰,並未提到洩漏偵測、異常告警或自動撤銷機制;一把外流的唯讀金鑰還能讀到哪些分析資料,來源也沒有逐項說明,這是評估殘餘風險時要自己補的假設。

**我們的看法:**手上有多把管理金鑰、或曾經把一把完整管理員金鑰交給 agent 或 CI 的團隊,應該這週就動手遷移:盤點現有金鑰、按工作重建範圍內的替代品、刪掉原始那把,成本是一個下午,而且立即降低「一把金鑰外流就波及所有團隊」的風險。這是我們在先前談 OpenRouter Workspaces 的環境隔離與權限時就期待補上的一塊,如今自動化工具終於能被限制在同一個邊界內。單一 workspace、只留一把金鑰偶爾手動用的個人開發者,可以安全忽略這次更新。會改變這個判斷的情況只有一種:盤點後發現每把金鑰本來就只有單一用途,那麼遷移收益就只剩下唯讀化稽核工具這一部分。

參考來源

AGENTIC COMMONS由 PHLEGON LABS 經營
分享X電郵
支持我們

相關閱讀

  1. 當 agent 也能改 production:Cloudflare 把 Workers 權限切到單一資源

    Cloudflare 為 Workers 推出四種角色與資源層級授權,讓 CI 與 agent 只拿到單一 Worker 的權限。

    Cloudflare

  2. OpenRouter ZDR 零資料保留路由怎麼設定

    敏感資料團隊應啟用 ZDR 路由並仔細檢查快取;三種設定任一啟用即可強制路由,但請求層級設定不會關閉回應快取。

    AI API

  3. 區域路由的關鍵不是「在哪推論」,而是「請求在哪解密」

    OpenRouter 推出 US/EU In-Region Routing,讓資料從解密到推論全程留在指定區域,避免合規審查翻車。

    OpenRouter