更新时间:2026-10-21 GMT+08:00
配置API认证的凭据访问控制
当API需要限制仅特定IP地址的客户端可调用时,可为凭据配置访问控制策略,通过设置IP白名单或黑名单,允许或禁止指定IP地址的客户端访问API,从而保护后端服务。
配置凭据的访问控制策略
- 进入API网关控制台页面。
- 根据实际业务在左侧导航栏上方选择实例。
- 在左侧导航栏选择“API管理 > 凭据管理”。
- 单击凭据名称,进入凭据详情页面。
- 在“访问控制策略”区域,单击“绑定”。
- 根据下表参数说明,在弹窗中配置策略信息。
表1 绑定访问控制策略 参数
说明
动作
选择访问控制的动作,默认禁止。
- 允许:表示仅允许指定IP地址的客户端调用API。
- 禁止:表示禁止指定IP地址的客户端调用API。
IP地址
单击“增加IP地址”,添加允许或禁止调用API的客户端IP地址或IP地址段。
- 支持以下IP格式:
- 常规IP格式,如:127.0.0.1,::1
- IP加掩码,如:192.145.0.0/16, 2407:c080:17ef:ffff:: 3104:703a/64
- IP段范围,如:127.0.0.1-192.145.0.1, 2407:c080:17ef:ffff:: 3104:703a-2407:c080:17ef:ffff:: 3104: 704a
- 如果使用IPv6地址,请先确认当前实例是否支持IPv6协议。
- 策略配置完成后,单击“确定”。
- 在“访问控制策略”区域显示已创建的访问控制策略,表示访问控制策略创建成功。
- 如果需要解绑/删除凭据访问控制策略,单击“移除”即可。
相关文档
如果您希望通过API创建凭据访问控制策略,请参考设置APP的访问控制。
API访问控制控制全局IP访问权限,凭据访问控制控制单凭据IP访问权限,二者可以叠加使用。
- 凭据访问控制:针对单个凭据(AppCode)设置IP黑白名单,允许或禁止指定IP地址的客户端通过该凭据访问API,用于实现不同凭据的差异化IP管控。
- API访问控制:针对单个API设置IP黑白名单,允许或禁止指定IP地址的客户端调用该API,对所有调用该API的凭据统一生效,用于保护后端服务安全。了解API访问控制请参考配置API的访问控制。
父主题: 配置凭据策略