BroadRouter
开始使用

用 IP 白名单把 API 密钥锁定到你的服务器

更新于

把服务器的出站 IPv4 或 IPv6 地址或 CIDR 网段加入账户白名单,最多 32 条。新建密钥会继承这个列表,除非创建时传入 allowed_ips。来自其他地址的请求会收到 403,白名单变更或吊销会在五秒内生效。

密钥泄露是 API 账单失控最常见的原因。BroadNet Inference 提供两种控制手段:IP 白名单和快速吊销。

两种凭证

凭证 用途 应视为
推理密钥 向 /v1/* 发送模型请求 一个应用或智能体专用的机密
控制台凭证 账户自动化:密钥、允许的 IP、购买 完整的账户权限

两者都只显示一次。控制台只保存 SHA-256 哈希,因此无法再次显示密钥。按量付费推理密钥自创建起有效一年,一个账户最多可持有十个有效密钥。

设置白名单

在账户页面每行添加一个 IPv4 或 IPv6 地址或 CIDR 网段,最多 32 条。空列表表示不做 IP 限制。新建密钥会继承这个账户列表。对每个 API 请求,边缘节点都会检查 Cloudflare 报告的客户端 IP。

如果要用脚本管理账户列表,PUT /portal/allowed_ips 一次调用即可整体替换它(需要控制台凭证)。

用控制台凭证创建密钥时,可以给这个密钥单独指定列表:

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

单个密钥的 allowed_ips 会替换该密钥继承的账户列表。响应中只包含一次原始密钥,请立即保存。

快速吊销泄露的密钥

DELETE /portal/keys/{alias} 吊销按量付费密钥,DELETE /portal/keys/hourly/{alias} 吊销按小时密钥(原购买费用不退)。吊销或白名单变更后,新请求会在五秒内被拒绝。

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

把 KEY_ALIAS 设为账户页面或 GET /portal/keys 中显示的该密钥别名。别名不是密钥本身。如果控制台凭证泄露,用 DELETE /portal/credentials/{id} 吊销它:它能做你的账户能做的一切。

故障排查

  • 已列入白名单的服务器收到 403。 边缘节点看到的是你的公网出站地址,而不是服务器的内网 IP。位于 NAT 网关、代理或负载均衡器后面的服务器,出站时用的是该设备的地址。启用了 IPv6 的服务器即使你只列了它的 IPv4 地址,也可能走 IPv6 出站。请列出请求实际出站的地址,或覆盖它的 CIDR 网段。
  • 新密钥忽略了账户列表。 单个密钥的 allowed_ips 数组会替换该密钥继承的账户列表。检查创建时传入了什么。
  • 409 key_limit_reached。 账户已有十个有效密钥。吊销一个不再使用的。
  • 吊销后几秒内请求仍然成功。 在缓存同步的最多五秒内,这是正常的。

来自不在列表中的地址的请求会收到 403。参见 BroadNet 全部错误码及何时重试。要用新密钥发出第一个请求,请按照 OpenAI Python SDK 指南操作。IP 白名单术语条目从一般角度解释了这个概念。

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

常见问题

怎么让大模型 API 密钥只能从我服务器的 IP 调用?

在 BroadNet 账户页面把服务器的公网出站地址或 CIDR 网段加入账户白名单,或者通过 POST /portal/keys 创建密钥时传入 allowed_ips。来自其他任何地址的请求都会被拒绝并返回 403。

白名单为空会拦截所有请求吗?

不会。空列表表示不做 IP 限制,密钥可以从任何地址使用。至少添加一条,限制才会生效。

可以用推理密钥创建其他密钥吗?

不可以。推理密钥只能调用 /v1/* 模型路由。创建和吊销密钥、修改允许的 IP 以及购买按小时密钥都需要控制台凭证,它拥有完整的账户权限。

吊销泄露的密钥多快生效?

BroadNet 的文档说,吊销或白名单变更后五秒内新请求就会被拒绝,因为授权结果可能会在复制缓存中保留这么久。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity