文档首页/ API网关 APIG/ 用户指南/ 配置凭据策略/ 配置API认证的凭据访问控制
更新时间:2026-10-21 GMT+08:00
分享

配置API认证的凭据访问控制

当API需要限制仅特定IP地址的客户端可调用时,可为凭据配置访问控制策略,通过设置IP白名单或黑名单,允许或禁止指定IP地址的客户端访问API,从而保护后端服务。

配置凭据的访问控制策略

  1. 进入API网关控制台页面。
  2. 根据实际业务在左侧导航栏上方选择实例。
  1. 在左侧导航栏选择“API管理 > 凭据管理”。
  2. 单击凭据名称,进入凭据详情页面。
  3. 在“访问控制策略”区域,单击“绑定”。
  4. 根据下表参数说明,在弹窗中配置策略信息。

    表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协议。

  5. 策略配置完成后,单击“确定”。

    • 在“访问控制策略”区域显示已创建的访问控制策略,表示访问控制策略创建成功。
    • 如果需要解绑/删除凭据访问控制策略,单击“移除”即可。

相关文档

如果您希望通过API创建凭据访问控制策略,请参考设置APP的访问控制。

API访问控制控制全局IP访问权限,凭据访问控制控制单凭据IP访问权限,二者可以叠加使用。

  • 凭据访问控制:针对单个凭据(AppCode)设置IP黑白名单,允许或禁止指定IP地址的客户端通过该凭据访问API,用于实现不同凭据的差异化IP管控。
  • API访问控制:针对单个API设置IP黑白名单,允许或禁止指定IP地址的客户端调用该API,对所有调用该API的凭据统一生效,用于保护后端服务安全。了解API访问控制请参考配置API的访问控制。

相关文档