透過 IP 允許清單,你可以限定 OpenAI API 只接受來自受信任 IP 位址或 CIDR 範圍的請求。啟用允許清單後,即使來自其他 IP 位址的請求含有有效的 API 金鑰,OpenAI 也會拒絕這些請求。
如果正式環境中的工作負載使用固定或明確可辨識的網路出口,可以使用 IP 允許清單多加一層防護。這項限制僅適用於 API 請求,不會限制使用者存取 platform.openai.com 或登入帳戶。
IP 允許清單控管的是你的應用程式傳送給 OpenAI 的請求。如果你需要允許 OpenAI 產品向你管理的服務傳送請求,請改用 OpenAI 公布的出口 IP 位址範圍。
啟用允許清單前的準備
找出每個呼叫 API 的工作負載所使用的公用出口 IP 位址或位址範圍。API 會根據請求抵達 OpenAI 時的來源 IP 位址進行判斷,因此請確認請求經過網路位址轉換(NAT)、VPN、防火牆或 Proxy 伺服器之後的位址。
每份允許清單最多可包含 50 個項目,每個項目可以是單一 IP 位址或 CIDR 範圍。組織擁有者角色具備管理 IP 允許清單設定所需的 Read 和 Write 權限。如需進一步瞭解權限,請參閱在 OpenAI 平台管理權限。
將允許清單套用至整個組織之前,請先從一個非關鍵專案開始。測試設定時,請確保至少有一條已測試的路徑可從允許的 IP 位址傳送請求。
專案層級的允許清單優先於組織層級的允許清單,兩份清單的項目不會合併。如果專案已啟用自己的允許清單,就會使用該清單;否則會使用組織層級的允許清單。
設定 IP 允許清單
- 開啟設定 > 安全性 > IP 允許清單。
- 新增要允許的個別 IP 位址或 CIDR 範圍。例如,使用
203.0.113.10表示單一位址,或使用203.0.113.0/24表示一段位址範圍。 - 如有需要,可使用檢查工具確認允許清單是否包含特定 IP 位址。
- 為特定專案或整個組織啟用允許清單。
- 等待變更生效,最多需要 15 分鐘。
- 從每個預期會呼叫 API 的環境傳送 API 請求,確認都能順利存取。
啟用組織層級的允許清單後,所有未啟用自身允許清單的專案,其 API 請求都會受到影響。啟用前,請逐一確認每個受影響範圍內,正式、預備、持續整合(CI)和災難復原環境使用的所有網路出口路徑。
驗證允許清單是否生效
從允許的網路路徑傳送一個具代表性的 API 請求。例如:
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"
這個請求應會依照該 API 金鑰平常的身分驗證與授權規則完成。如果從目前生效的允許清單未涵蓋的 IP 位址傳送請求,請求就會失敗,並傳回 HTTP 401 和 ip_not_authorized 錯誤碼。
排查遭封鎖的請求
如果預期應能成功的請求傳回 ip_not_authorized 錯誤:
- 沿著工作負載傳送 API 請求時使用的同一條網路路徑,確認其公用出口 IP 位址。本機開發電腦的公用 IP 位址可能與已部署服務的公用 IP 位址不同。
- 檢查 NAT 閘道、VPN、防火牆、Proxy 伺服器或雲端服務供應商是否變更了出口位址。
- 使用檢查工具,在 IP 允許清單設定中確認該位址是否符合已設定的項目。
- 確認目前生效的允許清單適用於該 API 金鑰所屬的組織或專案。
- 變更設定後,請等待最多 15 分鐘,再重新測試。
即使使用 IP 允許清單,仍須妥善儲存 API 金鑰、定期輪替金鑰並保護帳戶安全。如果請求必須來自 Azure 私人網路,而非公用 IP 位址,可以考慮使用 Private Link。Private Link 與 IP 允許清單的存取控制機制不相容。