概覽
IP 允許清單是一項可選用的安全功能，可讓您限制哪些 IP 位址能存取您的 OpenAI API。
啟用後，系統只會允許來自已設定的 IP 位址或 IP 範圍的請求。來自其他所有 IP 的請求都會遭到拒絕，即使請求包含有效的 API 金鑰也不例外。
此功能旨在將存取來源限制於受信任的網路環境，藉此降低 API 遭到未經授權使用的風險。
注意：IP 允許清單僅適用於 API 請求。此功能不會影響對 platform.openai.com 的存取或使用者登入。
為何使用 IP 允許清單
IP 允許清單可協助您：
僅允許已知的基礎架構（例如您的伺服器或雲端環境）存取 API
降低 API 金鑰外洩時的風險
為 API 流量來源增添一層管控
IP 允許清單最常用於 API 流量來自固定或明確定義之網路範圍的正式環境。
運作方式
您可以設定一份允許存取的 IP 位址或 CIDR 範圍清單。
來自允許的 IP 的請求會獲得接受。
來自未列入允許清單的 IP 的請求會遭到拒絕。
IP 允許清單可套用於：
組織層級，或
專案層級
適用對象
所有 API 客戶皆可使用 IP 允許清單。
請依照下列步驟設定 IP 允許清單。
設定 IP 允許清單
注意：最多可新增 50 個 IP 位址或 CIDR 範圍。
開啟設定。
選取安全性。
選取 IP 允許清單。
新增一或多個 IP 位址或 CIDR 範圍。
（選用）使用檢查工具，確認某個 IP 是否已列入允許清單。
針對以下範圍啟用允許清單：
特定專案，或
整個組織。
從預計使用的環境發送請求進行測試。
建議先在單一專案中啟用，再將限制套用至整個組織。
變更設定後，最多可能需要 15 分鐘才會生效。
注意：您必須具備適當的組織權限，才能設定 IP 允許清單。
疑難排解
如果請求意外失敗：
確認請求來自允許的 IP 位址。
檢查基礎架構的 IP 是否已變更。
確認已設定的 IP 範圍是否正確。
設定變更最多需要 15 分鐘才能完成同步，請稍候。
使用檢查工具，確認某個 IP 是否獲准存取。
請求遭到封鎖時會發生什麼事
如果請求來自未列入允許清單的 IP 位址，該請求就會失敗，並傳回：
HTTP 狀態：401 Unauthorized
錯誤代碼：ip_not_authorized
回應範例：
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
常見問題
IP 允許清單能完全防止他人未經授權使用我的 API 金鑰嗎？
不能。IP 允許清單可透過限制 API 請求的來源來降低風險，但無法完全防止所有形式的濫用。您應搭配其他安全性最佳實務使用，例如安全儲存金鑰、定期輪替金鑰，以及強化帳戶安全。如需進一步提升安全性，請參閱說明中心的API 金鑰安全性最佳實務及防止未經授權的使用指南。
IP 允許清單會影響延遲嗎？
IP 允許清單在某些情況下可能會造成些微延遲，通常發生於最初的請求。預期不會對 API 的整體效能造成顯著影響。
如何判斷請求是否因 IP 允許清單而失敗？
因 IP 允許清單而失敗的請求會傳回：
HTTP status: 401 UnauthorizedError code: ip_not_authorized