概覽
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