如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

API 組織存取限制

限制使用者可從你的網路存取哪些 API 組織。

你可以限制使用者從你的網路存取哪些 API 組織。若要設定這項限制,請透過代理伺服器或安全存取服務邊緣(SASE)服務設定組織 ID 允許清單。

運作方式

  • 自訂允許清單標頭: 在網路設定中加入自訂 HTTP 標頭 OpenAI-Allowed-Organization-Ids,即可指定允許存取的 API 組織。你可以在標頭中填入一或多個組織 ID(例如 org-…)。多個 ID 之間請用半形逗號分隔,不要加空格。
  • API 平台依允許清單控管存取:
    • 使用者從你的網路登入 API 平台時,OpenAI 會讀取標頭,檢查使用者要存取的 API 組織 ID 是否列在 OpenAI-Allowed-Organization-Ids 標頭中。
    • 如果使用者嘗試存取標頭中未列出的組織,OpenAI 會自動拒絕該請求,並傳回狀態碼為 403 的錯誤。使用者只能存取標頭中列出的組織。

設定方式

步驟 1:查找組織 ID

若要允許使用者存取特定組織,請分別複製各組織的組織 ID。你可以在 API 平台的組織設定頁面找到這個 ID:

  • 登入你的 API 平台帳戶,並切換到要開放存取的組織。
  • 前往組織設定頁面,記下組織 ID(例如 org-Tkxfm8owx4zIPaJGNDVrPs6m)。

步驟 2:設定標頭

請透過代理伺服器或安全存取服務邊緣(SASE)服務設定網路,讓送出的請求帶有此標頭。

  • 若要允許存取多個組織,請輸入各組織的 ID,並以半形逗號分隔,不要加空格。
  • 指定標頭適用的網址:
    • 設定代理伺服器或 SASE 服務,僅對送往 https://api.openai.com/* 的請求加上此標頭。

步驟 3:驗證設定

設定好標頭後,請將裝置連上套用此規則的網路,再測試能否存取組織。

  1. 使用可存取下列兩個組織的帳戶登入 API 平台:
    • 一個列在允許清單中的組織。
    • 一個未列在允許清單中的組織。
  2. 開啟允許清單中的組織,確認你可以存取該組織。
  3. 嘗試開啟未列在允許清單中的組織,確認存取遭到封鎖,且錯誤狀態碼為 403。
  4. 如果你允許存取多個組織,請逐一確認是否都能存取。

如果結果與預期不同,請檢查代理伺服器或 SASE 規則是否已套用至測試裝置,並確認標頭中的組織 ID 是否正確。

排解存取錯誤

  • 狀態碼 403: 如果使用者嘗試存取未列在允許清單中的 API 組織,就會看到狀態碼為 403 的錯誤,訊息會指出該使用者沒有權限存取該組織。
  • 狀態碼 400: 如果標頭值的格式有誤(例如組織 ID 無效),所有帶有該標頭的請求都會失敗,並傳回狀態碼為 400 的錯誤。