IP 黑名单和白名单是 API 网关提供的安全防护能力之一。您可以通过配置黑、白名单来拒绝或允许特定 IP 的访问请求。API 网关支持在实例级别、服务级别和路由级别配置 IP 黑名单和白名单，满足精细化的访问控制诉求。本文介绍如何为API 网关设置黑名单和白名单。

前提条件

使用限制

操作步骤

配置项	说明
生效级别	选择 IP 黑白名单插件的生效级别，包括：实例级别：黑白名单在实例中生效，需要指定生效的目标实例。服务级别：黑白名单在服务内生效，需要指定生效的目标实例和目标服务。路由级别：黑白名单在路由内生效，需要指定生效的目标实例、目标服务和目标路由。
备注	输入关于当前 IP 黑白名单插件的备注信息，可以为空。
IP 黑/白名单	勾选需要配置黑名单或白名单。黑名单：禁止特定 IP 访问。在网关场景针对不友好访问执行来源 IP 封禁。白名单：允许特定 IP 访问。在网关场景只开放受信任来源 IP 访问。
IP 列表	输入合法的 IPv4 CIDR 的 IP，输入完成后使用回车确认。支持输入多个，用分号;或回车隔开。
自定义获取 IP	是否开启自定义获取 IP。 IP 获取方式：当前只支持基于 X-Forward-For。注意 X-Forward-For 转发过程中存在被篡改的风险，API 网关无法检验 X-Forward-For 内容的可信度。拦截位置：在多层转发链路上选择进行访问控制的 IP 位置，IP 信息来自 X-Forward-For。

结果验证

查看配置

配置完成后，在 IP 黑白名单插件列表将生成一条新的插件记录。插件状态为已启用，表示插件功能生效。

认证测试

预期结果如下，表示能够通过 API 网关访问到后端的服务。

预期结果如下，匹配到 IP 黑名单的请求将被拒绝，并提示ip restriction deny。