跳到正文
openrouter blog(openrouter.ai)·· 7 天前精選品質評分77

OpenRouter 管理金鑰可限縮到單一工作區並設為唯讀

Tighter Access Controls for Management Keys

重點導讀

管理金鑰若能操作整個組織,一旦外洩或被誤用,其他團隊的資料也可能受影響。

  • OpenRouter 現在讓每把金鑰分別設定適用範圍和操作許可權:範圍可限於單一工作區或涵蓋整個組織,許可權則可設為唯讀或讀寫。唯讀金鑰能檢視範圍內的資料,但不能新增、修改或刪除。
  • 工作區管理員也能建立只管理自家工作區的金鑰。這讓報表和稽核工具可以讀取用量,團隊的自動化工具也能管理自己的 API 金鑰,同時降低誤用或外洩時影響其他工作區的風險。金鑰建立後不能再更改範圍或許可權,要調整就得建立新金鑰並刪除舊金鑰。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

推薦理由

OpenRouter 把管理金鑰的可用範圍和操作許可權拆開設定,讓團隊自動化與稽核工具只取得工作所需的許可權。

正文 · 中文翻譯

管理金鑰不再需要擁有整個組織的完整管理員許可權。現在你可以將金鑰設為唯讀、限制在單一工作區,或同時套用兩者,讓每把金鑰只能執行建立時指定的工作。唯讀金鑰可檢視 API 金鑰、活動和用量;讀寫金鑰則還能建立、更新及刪除 API 金鑰。如果金鑰外洩或遭到濫用,造成的影響也會受到限制。

即日起,所有方案的每個組織都能使用。你可以從工作區的金鑰頁面,或透過 管理 API 金鑰建立金鑰;各類金鑰可呼叫哪些路由,請參閱管理 API 金鑰指南。

The Create a Management Key dialog, scoped to the Production workspace, with a name, a 90 day expiration, and Read only selected under Access level

團隊可以管理自己的工作區,現在也能自行執行自動化作業

組織在 OpenRouter 上逐漸擴大時,會將工作拆分到不同工作區,通常每個團隊各有一個。各團隊管理自己的工作區,而組織管理員則負責管理所有人共用的專案:點數、預算和組織設定。

過去,管理金鑰一律擁有整個組織的完整讀寫許可權。團隊若想自動化管理自己的工作區,就得使用也能存取其他所有工作區的金鑰。

現在,每把金鑰都有兩項設定。範圍決定金鑰可在哪裡使用:單一工作區,或整個組織。存取層級決定金鑰在該範圍內能執行哪些操作:唯讀,或讀寫。工作區管理員可以為自己的工作區建立金鑰,讓部署流程輪替團隊的 API 金鑰、AI 助理設定防護規則,或指令碼將隊友加入工作區,而這些作業都不會觸及其他團隊的工作區。

範圍可將金鑰限制在單一工作區

工作區範圍的金鑰只能用於自己的工作區。如果要求存取其他工作區,或屬於其他工作區的資源,OpenRouter 會拒絕存取。即使 AI 助理發生錯誤或金鑰外洩,也無法觸及組織的其他部分。

在所屬工作區內,金鑰可以管理 API 金鑰、成員、防護規則及防護規則政策、自有的供應商金鑰、可觀測性目的地和預設設定,也可以讀取工作區的預算、活動和分析資料。

預算上限、點數和組織設定仍由組織管理員管理。團隊可以自動化處理工作區內的所有事務,但仍無法提高自己的工作區預算。設定工作區預算、建立或刪除工作區、管理組織成員,以及管理私人端點,仍須使用組織金鑰;其運作方式與以往相同。

唯讀存取權讓工具能檢視資料,但不會變更任何內容

存取層級是第二項設定,對工作區金鑰和組織金鑰都適用。唯讀金鑰可以呼叫其範圍允許的讀取路由,包括分析查詢。任何會建立、變更或刪除資料的要求都會回傳錯誤。

這適合只需要檢視資料的工具。成本儀錶板可以取得用量資料,監控 AI 助理可以追蹤活動,稽核指令碼則可以列出金鑰、防護規則和供應商金鑰。你可以連線新的報表或稽核工具,而不必授予帳戶寫入許可權。

為每項工作建立只具備所需存取許可權的金鑰

範圍和存取層級組合後,會形成四種金鑰:

  • 負責為單一團隊建立及輪替 API 金鑰的 AI 助理,應使用該團隊工作區的讀寫金鑰。
  • 單一團隊的用量儀錶板,應使用該團隊工作區的唯讀金鑰。
  • 供整個組織使用的稽核或成本工具,應使用組織層級的唯讀金鑰。
  • 任何會建立工作區或設定預算上限的作業,都需要具備讀寫許可權的組織金鑰。

建立金鑰時,這兩項設定就會固定,因此金鑰之後無法取得更多存取許可權。若要變更其中一項,請建立新金鑰並刪除舊金鑰。

在控制面板建立金鑰

The Management keys tab on a workspace's Keys page, listing three keys with their access level, expiration, and status, and a New management key button

  1. 開啟工作區,前往 Keys,再選取 Management keys 分頁。工作區管理員可以為自己的工作區建立金鑰,組織管理員則可以為任何工作區建立金鑰。
  2. 按一下 New management key。對話方塊會顯示金鑰的適用工作區。
  3. 輸入名稱、選擇到期時間,並在 Access level 下選擇 Read only 或 Read and write。
  4. 畫面顯示金鑰時,請立即複製。之後就無法再次檢視。

如要建立適用於整個組織的金鑰,組織管理員可使用 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 金鑰指南列出各類金鑰可呼叫的所有路由。

來源: openrouter blog (openrouter.ai)
開啟原文

讀者討論

理性交流 · 即時討論