IP 白名單

IP 白名單

每把 API 金鑰都可以設定獨立的 IP 白名單，只有來自指定來源 IP 的請求能使用這把金鑰。

什麼情況適合使用

適合部署在具有固定出口 IP 的正式環境伺服器或企業內網服務。若應用程式從家用網路、行動網路或其他會變動的位址發出請求，請先確認出口 IP 穩定，否則可能把自己鎖在外面。

如何設定

前往 /keys ，打開該把金鑰的「⋯」選單，選擇「IP 白名單」，輸入項目後儲存。

也可以使用 PATCH /api/v1/keys/:id，搭配登入 session 或 Management API key 設定：

PATCH https://api.bazaarlink.ai/v1/keys/KEY_ID
Authorization: Bearer sk-bl-YOUR_MANAGEMENT_KEY
Content-Type: application/json

{
"allowedCidrs": [
  "203.0.113.7",
  "198.51.100.0/24"
]
}

# Clear the allowlist and return to unrestricted access
{"allowedCidrs": []}

項目格式

在 UI 中每行輸入一個值；使用 API 時，將相同值放進 `allowedCidrs` 陣列。可接受裸 IPv4 位址、IPv4 CIDR，或 IPv6 字面值（僅精確比對）。

203.0.113.7
198.51.100.0/24
2001:db8::1

運作方式

留空（送出空的 [] 陣列）代表允許所有來源 IP。這是預設值，現有金鑰行為維持不變。

來源 IP 取自 `cf-connecting-ip` 標頭。

名單非空但解析不到來源 IP 時，請求會被拒絕（fail-closed）。