通过 IP 允许列表,您可以将 OpenAI API 请求的来源限制在您信任的 IP 地址或 CIDR 地址范围内。启用允许列表后,即使来自其他 IP 地址的请求包含有效的 API 密钥,OpenAI 也会拒绝这些请求。
如果生产工作负载的网络出口固定或范围明确,您可以使用 IP 允许列表为其增加一层保护。允许列表仅适用于 API 请求,不会限制用户访问 platform.openai.com 或登录账户。
IP 允许列表控制您的应用程序向 OpenAI 发送的请求。如果您需要允许 OpenAI 产品向您管理的服务发送请求,请使用已公布的出口 IP 地址范围。
启用允许列表之前
确定每个调用 API 的工作负载所使用的公网出口 IP 地址或地址范围。API 检查的是请求到达 OpenAI 时的源 IP 地址,因此请核实请求经过网络地址转换(NAT)、VPN、防火墙或代理后的 IP 地址。
每个允许列表最多可包含 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、防火墙、代理或云服务提供商是否更改了出口地址。
- 使用检查工具(位于 IP 允许列表设置中),确认该地址是否匹配已配置的条目。
- 确认当前生效的允许列表适用于该 API 密钥关联的组织或项目。
- 配置更改后,请等待最多 15 分钟,然后重新测试。
即使启用了 IP 允许列表,您仍需安全存储 API 密钥、定期轮换密钥并保护账户安全。如果请求必须从 Azure 专用网络发出,而不能来自公网 IP 地址,可以考虑使用 Private Link。Private Link 与 IP 允许列表访问控制不兼容。