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）。