你可以限制使用者從你的網路存取哪些 API 組織。若要設定這項限制,請透過代理伺服器或安全存取服務邊緣(SASE)服務設定組織 ID 允許清單。
運作方式
- 自訂允許清單標頭: 在網路設定中加入自訂 HTTP 標頭
OpenAI-Allowed-Organization-Ids,即可指定允許存取的 API 組織。你可以在標頭中填入一或多個組織 ID(例如org-…)。多個 ID 之間請用半形逗號分隔,不要加空格。 - API 平台依允許清單控管存取:
- 使用者從你的網路登入 API 平台時,OpenAI 會讀取標頭,檢查使用者要存取的 API 組織 ID 是否列在
OpenAI-Allowed-Organization-Ids標頭中。 - 如果使用者嘗試存取標頭中未列出的組織,OpenAI 會自動拒絕該請求,並傳回狀態碼為
403的錯誤。使用者只能存取標頭中列出的組織。
- 使用者從你的網路登入 API 平台時,OpenAI 會讀取標頭,檢查使用者要存取的 API 組織 ID 是否列在
設定方式
步驟 1:查找組織 ID
若要允許使用者存取特定組織,請分別複製各組織的組織 ID。你可以在 API 平台的組織設定頁面找到這個 ID:
- 登入你的 API 平台帳戶,並切換到要開放存取的組織。
- 前往組織設定頁面,記下組織 ID(例如
org-Tkxfm8owx4zIPaJGNDVrPs6m)。
步驟 2:設定標頭
請透過代理伺服器或安全存取服務邊緣(SASE)服務設定網路,讓送出的請求帶有此標頭。
- 若要允許存取多個組織,請輸入各組織的 ID,並以半形逗號分隔,不要加空格。
- 指定標頭適用的網址:
- 設定代理伺服器或 SASE 服務,僅對送往
https://api.openai.com/*的請求加上此標頭。
- 設定代理伺服器或 SASE 服務,僅對送往
步驟 3:驗證設定
設定好標頭後,請將裝置連上套用此規則的網路,再測試能否存取組織。
- 使用可存取下列兩個組織的帳戶登入 API 平台:
- 一個列在允許清單中的組織。
- 一個未列在允許清單中的組織。
- 開啟允許清單中的組織,確認你可以存取該組織。
- 嘗試開啟未列在允許清單中的組織,確認存取遭到封鎖,且錯誤狀態碼為
403。 - 如果你允許存取多個組織,請逐一確認是否都能存取。
如果結果與預期不同,請檢查代理伺服器或 SASE 規則是否已套用至測試裝置,並確認標頭中的組織 ID 是否正確。
排解存取錯誤
- 狀態碼 403: 如果使用者嘗試存取未列在允許清單中的 API 組織,就會看到狀態碼為
403的錯誤,訊息會指出該使用者沒有權限存取該組織。 - 狀態碼 400: 如果標頭值的格式有誤(例如組織 ID 無效),所有帶有該標頭的請求都會失敗,並傳回狀態碼為
400的錯誤。