OpenRouter 管理金鑰可限縮到單一工作區並設為唯讀
Tighter Access Controls for Management Keys
管理金鑰若能操作整個組織,一旦外洩或被誤用,其他團隊的資料也可能受影響。
- OpenRouter 現在讓每把金鑰分別設定適用範圍和操作許可權:範圍可限於單一工作區或涵蓋整個組織,許可權則可設為唯讀或讀寫。唯讀金鑰能檢視範圍內的資料,但不能新增、修改或刪除。
- 工作區管理員也能建立只管理自家工作區的金鑰。這讓報表和稽核工具可以讀取用量,團隊的自動化工具也能管理自己的 API 金鑰,同時降低誤用或外洩時影響其他工作區的風險。金鑰建立後不能再更改範圍或許可權,要調整就得建立新金鑰並刪除舊金鑰。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
OpenRouter 把管理金鑰的可用範圍和操作許可權拆開設定,讓團隊自動化與稽核工具只取得工作所需的許可權。
管理金鑰不再需要擁有整個組織的完整管理員許可權。現在你可以將金鑰設為唯讀、限制在單一工作區,或同時套用兩者,讓每把金鑰只能執行建立時指定的工作。唯讀金鑰可檢視 API 金鑰、活動和用量;讀寫金鑰則還能建立、更新及刪除 API 金鑰。如果金鑰外洩或遭到濫用,造成的影響也會受到限制。
即日起,所有方案的每個組織都能使用。你可以從工作區的金鑰頁面,或透過 管理 API 金鑰建立金鑰;各類金鑰可呼叫哪些路由,請參閱管理 API 金鑰指南。

團隊可以管理自己的工作區,現在也能自行執行自動化作業
組織在 OpenRouter 上逐漸擴大時,會將工作拆分到不同工作區,通常每個團隊各有一個。各團隊管理自己的工作區,而組織管理員則負責管理所有人共用的專案:點數、預算和組織設定。
過去,管理金鑰一律擁有整個組織的完整讀寫許可權。團隊若想自動化管理自己的工作區,就得使用也能存取其他所有工作區的金鑰。
現在,每把金鑰都有兩項設定。範圍決定金鑰可在哪裡使用:單一工作區,或整個組織。存取層級決定金鑰在該範圍內能執行哪些操作:唯讀,或讀寫。工作區管理員可以為自己的工作區建立金鑰,讓部署流程輪替團隊的 API 金鑰、AI 助理設定防護規則,或指令碼將隊友加入工作區,而這些作業都不會觸及其他團隊的工作區。
範圍可將金鑰限制在單一工作區
工作區範圍的金鑰只能用於自己的工作區。如果要求存取其他工作區,或屬於其他工作區的資源,OpenRouter 會拒絕存取。即使 AI 助理發生錯誤或金鑰外洩,也無法觸及組織的其他部分。
在所屬工作區內,金鑰可以管理 API 金鑰、成員、防護規則及防護規則政策、自有的供應商金鑰、可觀測性目的地和預設設定,也可以讀取工作區的預算、活動和分析資料。
預算上限、點數和組織設定仍由組織管理員管理。團隊可以自動化處理工作區內的所有事務,但仍無法提高自己的工作區預算。設定工作區預算、建立或刪除工作區、管理組織成員,以及管理私人端點,仍須使用組織金鑰;其運作方式與以往相同。
唯讀存取權讓工具能檢視資料,但不會變更任何內容
存取層級是第二項設定,對工作區金鑰和組織金鑰都適用。唯讀金鑰可以呼叫其範圍允許的讀取路由,包括分析查詢。任何會建立、變更或刪除資料的要求都會回傳錯誤。
這適合只需要檢視資料的工具。成本儀錶板可以取得用量資料,監控 AI 助理可以追蹤活動,稽核指令碼則可以列出金鑰、防護規則和供應商金鑰。你可以連線新的報表或稽核工具,而不必授予帳戶寫入許可權。
為每項工作建立只具備所需存取許可權的金鑰
範圍和存取層級組合後,會形成四種金鑰:
- 負責為單一團隊建立及輪替 API 金鑰的 AI 助理,應使用該團隊工作區的讀寫金鑰。
- 單一團隊的用量儀錶板,應使用該團隊工作區的唯讀金鑰。
- 供整個組織使用的稽核或成本工具,應使用組織層級的唯讀金鑰。
- 任何會建立工作區或設定預算上限的作業,都需要具備讀寫許可權的組織金鑰。
建立金鑰時,這兩項設定就會固定,因此金鑰之後無法取得更多存取許可權。若要變更其中一項,請建立新金鑰並刪除舊金鑰。
在控制面板建立金鑰

- 開啟工作區,前往 Keys,再選取 Management keys 分頁。工作區管理員可以為自己的工作區建立金鑰,組織管理員則可以為任何工作區建立金鑰。
- 按一下 New management key。對話方塊會顯示金鑰的適用工作區。
- 輸入名稱、選擇到期時間,並在 Access level 下選擇 Read only 或 Read and write。
- 畫面顯示金鑰時,請立即複製。之後就無法再次檢視。
如要建立適用於整個組織的金鑰,組織管理員可使用 Management API Keys 頁面。
代理程式和工具使用此金鑰的方式與目前使用管理金鑰相同:將它作為 Bearer 權杖,用於管理 API:
curl https://openrouter.ai/api/v1/keys \
-H "Authorization: Bearer $MANAGEMENT_KEY"如要檢視現有的管理金鑰,請開啟 Security settings,前往 Key safety,開啟 Filter keys,再選取 Show management keys。清單會列出每把有效金鑰的擁有者、上次使用時間和到期時間。管理 API 金鑰指南列出各類金鑰可呼叫的所有路由。