Todos los productos
Search
Centro de documentos

Edge Security Acceleration:BatchCreateDcdnWafRules

Última actualización: Oct 12, 2026

Configura las reglas de protección de WAF.

Descripción de la operación

Nota

Límite de frecuencia por usuario: 20 llamadas por segundo.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dcdn:BatchCreateDcdnWafRules

create

*All resources.

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

PolicyId

integer

Sí

El ID de la política.

1000001

RuleConfigs

string

Sí

La configuración de las reglas de protección.

[{"name":"example","action":"monitor","conditions":[{"key":"URL","opValue":"match-one","values":"1,2,3,4,5"},{"key":"Header","opValue":"contain-one","subKey":"example_subkey","values":"6,7,8,9,10"}],"ratelimit":{"target":"header","interval":10,"threshold":5,"ttl":1800,"subKey":"example_subkey","status":{"code":"502","count":5}},"ccStatus":"on","effect":"rule","status":"on"}]

Descripción del valor de RuleConfigs

  • RuleConfigs es una lista, donde cada estructura representa una regla.

  • El formato de RuleConfigs varía según el tipo de política de protección especificado por PolicyId.

Escenario de protección 1: Protección de expresiones regulares web (waf_group)

ParámetroTipoObligatorioEjemploDescripción
statusStringNoonEl interruptor de la regla de protección. Valores válidos: on (habilitar) y off (deshabilitar). Valor predeterminado: on.
actionStringSíblockLa acción de la regla. Valores válidos: block (bloquear solicitudes) y monitor (monitorear solicitudes).
wafGroupIdsStringNo1012El ID del grupo de reglas de WAF. Valor predeterminado: 1012. Separe varios ID con comas (,).

Ejemplo de configuración de waf_group:

// La protección de expresiones regulares web actualmente solo admite una regla por política.
[
  {
    "status": "on",
    "action": "block"
  }
]

Escenario de protección 2: Reglas personalizadas (custom_acl)

ParámetroTipoObligatorioEjemploDescripción
namestringSíacl_1El nombre de la regla de protección. El nombre puede contener letras, dígitos y guiones bajos (_), y tener una longitud máxima de 64 caracteres.
statusstringNoonEl interruptor de la regla de protección. Valores válidos: on (habilitar) y off (deshabilitar). Valor predeterminado: on.
conditionsConditionSí[ {"key": "URI", "subKey": "","opValue": "contain", "values": "/login.php" }]Las condiciones que activan la regla. Para obtener más información sobre los parámetros, consulte la Tabla 1 Descripción de métricas de Condition.
ccStatusstringSíoffEl interruptor de control de frecuencia. Valores válidos: on (habilitar) y off (deshabilitar).
rateLimitRateLimitNo{ "target": "Header", "subKey": "User-Agent", "interval": 5, "threshold": 2, "ttl": 1800}La regla de control de frecuencia. Este parámetro es obligatorio cuando ccStatus se establece en on. Para obtener más información sobre los parámetros, consulte la Tabla 2 Descripción de métricas de RateLimit.
effectstringNoserviceEl ámbito de efectividad de la lista negra de control de frecuencia. Este parámetro es obligatorio cuando ccStatus se establece en on. Valores válidos: rule (efectivo para la regla actual) y service (efectivo globalmente).
actionstringSídenyLa acción de la regla. Valores válidos: deny (bloquear), js (verificación de JavaScript) y monitor (monitorear).

Tabla 1 Descripción de métricas de Condition

ParámetroTipoObligatorioEjemploDescripción
KeystringSíQuery String ParameterEl campo de coincidencia. Para obtener más información, consulte DescribeDcdnWafFilterInfo.
subKeystringNoactionEl subcampo de coincidencia. Para obtener más información, consulte DescribeDcdnWafFilterInfo.
opValueStringSíeqEl operador lógico. Para obtener más información, consulte DescribeDcdnWafFilterInfo.
valuesStringNojsEl contenido de coincidencia. Separe varios valores con comas (,). Para obtener más información, consulte DescribeDcdnWafFilterInfo.

Tabla 2 Descripción de métricas de RateLimit

ParámetroTipoObligatorioEjemploDescripción
targetstringSíHeaderEl campo estadístico para el control de frecuencia. Valores válidos: IP (cuenta la frecuencia de solicitudes desde la misma dirección IP), Header (cuenta la frecuencia de solicitudes que contienen el encabezado especificado), Query String Parameter (cuenta la frecuencia de solicitudes que contienen el parámetro especificado), Cookie Name (cuenta la frecuencia de solicitudes que contienen la cookie especificada) y Session (cuenta la frecuencia de solicitudes desde la misma sesión).
subKeystringNoUser-AgentEl subcampo del campo unificado. Este parámetro es obligatorio cuando target se establece en Header, Query String Parameter o Cookie Name.
IntervalIntegerSí5El período estadístico. Valores válidos: de 5 a 1800. Unidad: segundos.
thresholdIntegerSí2El umbral estadístico. Valores válidos: de 2 a 500000. Unidad: veces.
ttlIntegerSí1800El período de tiempo de espera de la lista negra. Valores válidos: de 60 a 86400. Unidad: segundos.
statusRateLimitStatusNo{"code": "404", "ratio": 10}Las estadísticas de códigos de respuesta. Para obtener más información sobre los parámetros, consulte la Tabla 3 Descripción de métricas de RateLimitStatus.

Tabla 3 Descripción de métricas de RateLimitStatus

ParámetroTipoObligatorioEjemploDescripción
codetstringSí404El código de estado HTTP.
ratioIntegerNo10El porcentaje estadístico (%). Valores válidos: de 1 a 100. Este parámetro y el parámetro count son mutuamente excluyentes.
countIntegerNo10El recuento estadístico. Valores válidos: de 2 a 50000. Este parámetro y el parámetro ratio son mutuamente excluyentes.

Ejemplo de configuración de custom_acl:

[
  // Control de acceso
  {
    "name": "acl_1",
    "status": "off",
    "conditions":
    [
      {
        "key": "Query String Parameter",
        "subKey": "action",
        "opValue": "eq",
        "values": "js"
      }
    ],
    "ccStatus": "off",
    "action": "js"
  },
  // Control de frecuencia
  {
    "name": "cc_1",
    "status": "on",
  	"conditions": 
    [
      {
        "key": "URI",
        "subKey": "",
        "opValue": "contain",
        "values": "/login.php"
      },
      {
        "key": "IP",
        "subKey": "",
        "opValue": "ip-contain",
        "values": "192.168.0.1/24"
      }
    ],
    "ccStatus": "on",
    "ratelimit":
    {
      "target": "Header",
      "subKey": "User-Agent",
      "interval": 5,
      "threshold": 2,
      "ttl": 1800,
      "status":
      {
        "code": "404",
        "ratio": 10
      }
    },
    "effect": "service",
    "action": "deny"
  }
]

Escenario de protección 3: Lista blanca (whitelist)

ParámetroTipoObligatorioEjemploDescripción
namestringSíonEl nombre de la regla de protección. El nombre puede contener letras, dígitos y guiones bajos (_), y tener una longitud máxima de 64 caracteres.
statusstringNoonEl interruptor de la regla de protección. Valores válidos: on (predeterminado, habilitar) y off (deshabilitar).
conditionsConditionSí[{ "key": "Http-Method","subKey": "","opValue": "match-one", "values": "GET,POST,DELETE" }]Las condiciones que activan la regla. Para obtener más información sobre los parámetros, consulte la Tabla 1 Descripción de métricas de Condition.
tagsStringSí[ "waf_group", "custom_acl"]La lista de tipos de políticas de protección.
regularTypesStringNo[ [ "sqli", "xss","code_exec", "crlf", "lfilei", "rfilei", "webshell","vvip", "other"]El tipo de regla de expresión regular. Este parámetro se puede especificar cuando waf_group se incluye en tags. Valores válidos: sqli, xss, code_exec, crlf, lfilei, rfilei, webshell, vvip y other.
regularRulesStringNo[ "100001", "100002", "100003"]La regla de expresión regular. Este parámetro se puede especificar cuando waf_group se incluye en tags. Este parámetro y regularTypes son mutuamente excluyentes. El valor es una lista de cadenas de seis dígitos.

Ejemplo de configuración de whitelist:

[
  // Omitir todos los escenarios
  {
    "name": "wl_all",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "waf_group",
      "custom_acl",
      "ip_blacklist",
      "region_block"
    ]
  },
  // Omitir ID de reglas especificados en waf_group
  {
    "name": "wl_waf_id",
    "status": "off",
    "conditions":
    [
      {
        "key": "Cookie Name",
        "subKey": "cdn-sec",
        "opValue": "prefix-match",
        "values": "a7sdsa9dsa8d8sa"
      },
      {
        "key": "Referer",
        "subKey": "",
        "opValue": "none",
        "values": ""
      }
    ],
    "tags":
    [
      "waf_group"
    ],
    "regularRules":
    [
      "100001",
      "100002",
      "100003"
    ]
  },
  {
  // Omitir tipos de reglas especificados en waf_group
    "name": "wl_waf_type",
    "status": "on",
    "conditions":
    [
      {
        "key": "Query String",
        "subKey": "",
        "opValue": "exists",
        "values": ""
      }
    ],
    "tags":
    [
      "waf_group"
    ],
    "regularTypes":
    [
      "sqli",
      "xss",
      "code_exec",
      "crlf",
      "lfilei",
      "rfilei",
      "webshell",
      "vvip",
      "other"
    ]
  },
  // Omitir reglas personalizadas
  {
    "name": "wl_custom_acl",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "custom_acl"
    ]
  },
  // Omitir lista negra de IP
  {
    "name": "wl_ip_blacklist",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "ip_blacklist"
    ]
  },
  // Omitir bloqueo de región
  {
    "name": "wl_region_block",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "region_block"
    ]
  }
]

Escenario de protección 4: Lista negra de IP (ip_blacklist)

ParámetroTipoObligatorioEjemploDescripción
namestringSíipblacklistEl nombre de la regla de protección. El nombre puede contener letras, dígitos y guiones bajos (_), y tener una longitud máxima de 64 caracteres.
statusstringNoonEl interruptor de la regla de protección. Valores válidos: on (habilitar) y off (deshabilitar). Valor predeterminado: on.
remoteAddr[]StringSí["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"]Filtra por dirección IP. Para obtener más información, consulte DescribeDcdnWafFilterInfo.
actionstringSídenyLa acción de la regla. Valores válidos: deny (bloquear) y monitor (monitorear).

Ejemplo de configuración de ipblacklist:

[
    {
    "name": "ipblacklist",
    "status": "on",
    "remoteAddr": ["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"],
    "action": "deny"
  }
]

Escenario de protección 5: Bloqueo de región (region_block)

ParámetroTipoObligatorioEjemploDescripción
statusstringNoonEl interruptor de la regla de protección. Valores válidos: on (habilitar) y off (deshabilitar). Valor predeterminado: on.
cnRegionListstringNo110000,TW,MOLas regiones bloqueadas en China continental, separadas por comas (,). Para obtener más información sobre las regiones admitidas, consulte DescribeDcdnWafGeoInfo.
otherRegionListstringNoJP,GBLas regiones bloqueadas fuera de China continental, separadas por comas (,). Para obtener más información sobre las regiones admitidas, consulte DescribeDcdnWafGeoInfo.
actionstringSídenyLa acción de la regla. Valores válidos: deny (bloquear) y monitor (monitorear).
Nota

Debe especificar al menos uno de cnRegionList y otherRegionList.

Ejemplo de configuración de region_block:

[
    {
    "status": "on",
    "cnRegionList": "110000,TW,MO",
    "otherRegionList": "JP,GB",
    "action": "deny"
  }
]

Escenario de protección 6: Gestión de bots (bot)

Plantilla de regla

Todos los parámetros de regla incluyen los siguientes cuatro campos. Para valores específicos, consulte la categoría de regla correspondiente.

ParámetroTipoObligatorioDescripción
typeStringSíEl tipo de regla. Para más información, consulte la categoría de regla específica.
statusStringSíEl estado de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configTargetTypeNoLa configuración de la regla. Para más información, consulte la categoría de regla específica.
actionStringNoLa acción de la regla. Para más información, consulte la categoría de regla específica.

Categoría de regla 1: Tipo de objeto protegido

ParámetroTipoObligatorioEjemploDescripción
typeStringSítarget_typeEl tipo de regla. Establezca el valor en target_type.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configTargetTypeNo{"target":"app"}La configuración de la regla. Formato:
target: el tipo de objeto protegido. Obligatorio. Valores válidos: web (páginas web/navegadores) y app (aplicaciones).

actionStringNoVacíoLa acción de la regla. No aplica aquí. Establézcalo en un valor vacío.

Ejemplo de configuración de tipo de objeto protegido:

[
  {
    "type":"target_type",
    "status":"on",
    "config":{"target":"app"},
    "action":""
  }
]

Categoría de regla 2: Integración de Web SDK

ParámetroTipoObligatorioEjemploDescripción
typeStringSíweb_sdkEl tipo de regla. Establezca el valor en web_sdk.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configWebSdkNo{"mode":"automatic","crossDomain":"example.com"}La configuración de la regla. Formato:
mode: el método de integración de Web SDK. Obligatorio. Valores válidos: automatic (integración automática) y manual (integración manual).
crossDomain: la llamada de nombre de dominio entre dominios. Opcional. Este parámetro solo surte efecto cuando mode se establece en automatic.




actionStringNoVacíoLa acción de la regla. No aplica aquí. Establézcalo en un valor vacío.

Ejemplo de configuración de integración de Web SDK:

[
  {
    "type":"web_sdk",
    "status":"on",
    "config":{"mode":"automatic","crossDomain":"example.com"},
    "action":""
  }
]

Categoría de regla 3: Características del tráfico

ParámetroTipoObligatorioEjemploDescripción
typeStringSítraffic_featureEl tipo de regla. Establezca el valor en traffic_feature.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configTrafficFeatureSí{"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]}La configuración de la regla. Para más información, consulte condition.
actionStringNoVacíoLa acción de la regla. No aplica aquí. Establézcalo en un valor vacío.

condition (Condiciones de coincidencia)

ParámetroTipoObligatorioEjemploDescripción
keyStringSíHeaderEl campo de coincidencia. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
subKeyStringNoUser-AgentEl subcampo de coincidencia. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
opValueStringSícontainEl operador. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
valuesStringNoChromeEl contenido de coincidencia. Separe varios valores con comas (,). Para valores específicos, consulte DescribeDcdnWafFilterInfo.

Ejemplo de configuración de características del tráfico:

[
  {
    "type":"traffic_feature",
    "status":"on",
    "config":{"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]},
    "action":""
  }
]

Categoría de regla 4: Gestión de bots legítimos

ParámetroTipoObligatorioEjemploDescripción
typeStringSíintelligence_crawlerEl tipo de regla. Establezca el valor en intelligence_crawler.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configIntelligenceCrawlerNo{"name":"intelligence_crawler_baidu"}La configuración de la regla. Para valores válidos, consulte name (Lista blanca de bots de motores de búsqueda).
actionStringSíbypassLa acción de la regla. Valor válido: bypass (permitir).

name (Lista blanca de bots de motores de búsqueda)

ValorDescripción
intelligence_crawler_allLista blanca de motores de búsqueda legítimos (Google, Bing, Baidu, Sogou, 360, Yandex)
intelligence_crawler_baiduLista blanca de bots de Baidu
intelligence_crawler_sogouLista blanca de bots de Sogou
intelligence_crawler_360Lista blanca de bots de 360
intelligence_crawler_googleLista blanca de bots de Google
intelligence_crawler_bingLista blanca de bots de Bing
intelligence_crawler_yandexLista blanca de bots de Yandex

Ejemplo de configuración de gestión de bots legítimos:

[
  {
    "type":"intelligence_crawler",
    "status":"on",
    "config":{"name":"intelligence_crawler_baidu"},
    "action":"bypass"
  },
  {
    "type":"intelligence_crawler",
    "status":"on",
    "config":{"name":"intelligence_crawler_google"},
    "action":"bypass"
  }
]

Categoría de regla 5: Filtrado de scripts simple (desafío de JavaScript)

ParámetroTipoObligatorioEjemploDescripción
typeStringSíjsEl tipo de regla. Establezca el valor en js.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configJsNoVacíoLa configuración de la regla. No aplica aquí. Establézcalo en un valor vacío.
actionStringSíjsLa acción de la regla. Valor válido: js (verificación de JavaScript).

Ejemplo de configuración de filtrado de scripts simple (desafío de JavaScript):

[
  {
    "type":"js",
    "status":"on",
    "config":{},
    "action":"js"
  }
]

Categoría de regla 6: Protección avanzada contra bots (desafío de token dinámico)

ParámetroTipoObligatorioEjemploDescripción
typeStringSísigchlEl tipo de regla. Establezca el valor en sigchl.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configSigchlNo{"sigchl":["sig","replay","driver"]}La configuración de la regla. Formato:
sigchl: la verificación de firma de datos de solicitud. Obligatorio. Valores válidos: sig (excepción de verificación de firma), replay (excepción de marca de tiempo de firma) y driver (ataque de WebDriver).

actionStringSísigchlLa acción de la regla. Valor válido: sigchl (bloquear).

Ejemplo de configuración de protección avanzada contra bots (desafío de token dinámico):

[
  {
    "type":"sigchl",
    "status":"on",
    "config":{"sigchl":["sig","replay","driver"]},
    "action":"sigchl"
  }
]

Categoría de regla 7: Protección inteligente basada en IA

ParámetroTipoObligatorioEjemploDescripción
typeStringSíalgorithmEl tipo de regla. Establezca el valor en algorithm.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configAlgorithmNoVacíoLa configuración de la regla. No aplica aquí. Establézcalo en un valor vacío.
actionStringSícaptchaLa acción de la regla. Valores válidos: monitor (monitorear) y captcha (CAPTCHA de control deslizante).

Ejemplo de configuración de protección inteligente basada en IA:

[
  {
    "type":"algorithm",
    "status":"on",
    "config":{},
    "action":"captcha"
  }
]

Categoría de regla 8: Limitación de tasa de IP

ParámetroTipoObligatorioEjemploDescripción
typeStringSícustom_cc_ipEl tipo de regla. Establezca el valor en custom_cc_ip.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configCustomCcIpSí{"interval":20,"target":"IP","threshold":50,"ttl":2800}La configuración de la regla. Para más información, consulte Descripción del parámetro de configuración de limitación de tasa de IP.
actionStringSímonitorLa acción de la regla. Valores válidos: deny (bloquear), monitor (monitorear) y captcha (CAPTCHA de control deslizante, aplicable solo a web).

Descripción del parámetro de configuración de limitación de tasa de IP

ParámetroTipoObligatorioEjemploDescripción
targetStringSíIPEl campo estadístico para el control de frecuencia. Valor válido: IP.
subKeyStringNoVacíoEl subcampo del campo estadístico. No aplica aquí. Establézcalo en un valor vacío.
IntervalIntegerSí20El período estadístico. Valores válidos: de 5 a 1800. Unidad: segundos.
thresholdIntegerSí50El umbral estadístico. Valores válidos: de 2 a 50000. Unidad: veces.
ttlIntegerSí2800El período de tiempo de espera de la lista negra. Valores válidos: de 60 a 86400. Unidad: segundos.

Ejemplo de configuración de limitación de tasa de IP:

[
  {
    "type":"custom_cc_ip",
    "status":"on",
    "config":{"interval":20,"target":"IP","threshold":50,"ttl":2800},
    "action":"monitor"
  },
  {
    "type":"custom_cc_ip",
    "status":"on",
    "config":{"interval":10,"target":"IP","threshold":30,"ttl":1800},
    "action":"monitor"
  }
]

Categoría de regla 9: Limitación de tasa de dispositivos

ParámetroTipoObligatorioEjemploDescripción
typeStringSícustom_cc_devEl tipo de regla. Establezca el valor en custom_cc_dev.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configCustomCcDevSí{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800}La configuración de la regla. Para más información, consulte Descripción del parámetro de configuración de limitación de tasa de dispositivos.
actionStringSímonitorLa acción de la regla. Valores válidos: deny (bloquear) y monitor (monitorear).

Descripción del parámetro de configuración de limitación de tasa de dispositivos

ParámetroTipoObligatorioEjemploDescripción
targetStringSíHeaderEl campo estadístico para el control de frecuencia. Valor válido: Header.
subKeyStringNoaliwaf_wxbb_umidEl subcampo del campo estadístico. Valor válido: aliwaf_wxbb_umid.
IntervalIntegerSí20El período estadístico. Valores válidos: de 5 a 1800. Unidad: segundos.
thresholdIntegerSí50El umbral estadístico. Valores válidos: de 2 a 50000. Unidad: veces.
ttlIntegerSí2800El período de tiempo de espera de la lista negra. Valores válidos: de 60 a 86400. Unidad: segundos.

Ejemplo de configuración de limitación de tasa de dispositivos:

[
  {
    "type":"custom_cc_dev",
    "status":"on",
    "config":{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800},
    "action":"monitor"
  },
  {
    "type":"custom_cc_dev",
    "status":"on",
    "config":{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800},
    "action":"deny"
  }
]

Categoría de regla 10: Limitación de tasa de sesiones personalizadas

ParámetroTipoObligatorioEjemploDescripción
typeStringSícustom_ccEl tipo de regla. Establezca el valor en custom_cc.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configCustomCcIpSí{"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800}La configuración de la regla. Para más información, consulte Descripción del parámetro de configuración de limitación de tasa de sesiones personalizadas.
actionStringSímonitorLa acción de la regla. Valores válidos: deny (bloquear), monitor (monitorear) y captcha (CAPTCHA de control deslizante, aplicable solo a web).

Descripción del parámetro de configuración de limitación de tasa de sesiones personalizadas

ParámetroTipoObligatorioEjemploDescripción
targetStringSíQuery String ParameterEl campo estadístico para el control de frecuencia. Valores válidos: Header (cuenta la frecuencia de solicitudes que contienen el encabezado especificado), Query String Parameter (cuenta la frecuencia de solicitudes que contienen el parámetro especificado), Cookie Name (cuenta la frecuencia de solicitudes que contienen la cookie especificada) y Session (cuenta la frecuencia de solicitudes de la misma sesión).
subKeyStringNoargEl subcampo del campo estadístico. Valor personalizado.
IntervalIntegerSí10El período estadístico. Valores válidos: de 5 a 1800. Unidad: segundos.
thresholdIntegerSí30El umbral estadístico. Valores válidos: de 2 a 50000. Unidad: veces.
ttlIntegerSí2800El período de tiempo de espera de la lista negra. Valores válidos: de 60 a 86400. Unidad: segundos.

Ejemplo de configuración de limitación de tasa de sesiones personalizadas:

[
  {
    "type":"custom_cc",
    "status":"on",
    "config":{"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800},
    "action":"deny"
  },
  {
    "type":"custom_cc",
    "status":"on",
    "config":{"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800},
    "action":"captcha"
  }
]

Categoría de regla 11: Biblioteca de inteligencia de amenazas de bots

ParámetroTipoObligatorioEjemploDescripción
typeStringSíintelligenceEl tipo de regla. Establezca el valor en intelligence.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configIntelligenceNoVacíoLa configuración de la regla. No aplica aquí. Establézcalo en un valor vacío.
actionStringSícaptchaLa acción de la regla. Valores válidos: monitor (monitorear) y captcha (CAPTCHA de control deslizante).

Ejemplo de configuración de biblioteca de inteligencia de amenazas de bots:

[
  {
    "type":"intelligence",
    "status":"on",
    "config":{},
    "action":"captcha"
  }
]

Categoría de regla 12: Lista negra de IP de IDC

ParámetroTipoObligatorioEjemploDescripción
typeStringSíintelligence_idcEl tipo de regla. Establezca el valor en intelligence_idc.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configIntelligenceIdcSí{"name":"intelligence_idc_alibaba"}La configuración de la regla. Para valores válidos, consulte Descripción del parámetro name.
actionStringSícaptchaLa acción de la regla. Valores válidos: deny (bloquear), monitor (monitorear) y captcha (CAPTCHA de control deslizante).

Descripción del parámetro name

ValorDescripción
intelligence_idc_alibabaBiblioteca de IP de IDC - Alibaba Cloud
intelligence_idc_tencentBiblioteca de IP de IDC - Tencent Cloud
intelligence_idc_mtyunBiblioteca de IP de IDC - Meituan Cloud
intelligence_idc_vnetBiblioteca de IP de IDC - 21Vianet
intelligence_idc_otherBiblioteca de IP de IDC - Otros

Ejemplo de configuración de lista negra de IP de IDC:

[
  {
    "type":"intelligence_idc",
    "status":"on",
    "config":{"name":"intelligence_idc_alibaba"},
    "action":"captcha"
  },
  {
    "type":"intelligence_idc",
    "status":"on",
    "config":{"name":"intelligence_idc_tencent"},
    "action":"captcha"
  }
]

Categoría de regla 13: Bloqueo de bots falsos

ParámetroTipoObligatorioEjemploDescripción
typeStringSíintelligence_fake_crawlerEl tipo de regla. Establezca el valor en intelligence_fake_crawler.
statusStringSíonEl interruptor de la regla. Valores válidos: on (habilitado) y off (deshabilitado).
configIntelligenceFakeCrawlerNoVacíoLa configuración de la regla. No aplica aquí. Establézcalo en un valor vacío.
actionStringSídenyLa acción de la regla. Valor válido: deny (bloquear).

Ejemplo de configuración de bloqueo de bots falsos:

[
  {
    "type": "intelligence_fake_crawler",
    "status": "on",
    "config":{},
    "action": "deny"
  }
]

Categoría de regla 14: Identificación de características de bots

ParámetroTipoObligatorioEjemploDescripción
typeStringSíapp_sdkEl tipo de regla. Establezca el valor en app_sdk.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configAppSdkSí{"featureAbnormal":["simulator","proxy","root","debugged","hook","virtual","antiReplay","signInvalid"],"customSignStatus":"on","customSign":{"key":"header","value":"ua"}}La configuración de la regla. Para más información, consulte Descripción del parámetro de configuración de identificación de características de bots.
actionStringSímonitorLa acción de la regla. Valores válidos: deny (bloquear) y monitor (monitorear).

Descripción del parámetro de configuración de identificación de características de bots

ParámetroTipoObligatorioEjemploDescripción
featureAbnormal[]StringSísimulatorsignInvalid: excepción de firma de aplicación.
antiReplay: firma caducada.
simulator: emulador en uso.
proxy: proxy en uso.
root: dispositivo con acceso root.
debugged: modo de depuración.
hook: aplicación con hook.
virtual: apertura múltiple de aplicación.



















customSignStatusStringNoonEl interruptor del campo de firma personalizada. Valores válidos: on (habilitado) y off (deshabilitado).
customSignCustomSignNo{"key":"header","value":"ua"}El campo de firma personalizada. Formato:
key: el nombre del campo. Obligatorio. Valores válidos: header, arg y cookie.
value: el valor del campo. Obligatorio.




Ejemplo de configuración de identificación de características de bots:

[
  {
    "type": "app_sdk",
    "status": "on",
    "config": {"featureAbnormal":["simulator","proxy","root","debugged","hook","virtual","antiReplay","signInvalid"],"customSignStatus":"on","customSign":{"key":"header","value":"ua"}},
    "action": "monitor"
  }
]

Categoría de regla 15: Protección avanzada (detección de aplicaciones reempaquetadas)

ParámetroTipoObligatorioEjemploDescripción
typeStringSíapp_packageEl tipo de regla. Establezca el valor en app_package.
statusStringSíonEl interruptor de la regla. Valor válido: on (habilitado).
configAppPackageNo{"packageSigns":[{"name":"aaaaa","sign":"bbbb"},{"name":"cccc","sign":"dddd"}]}La configuración de la regla. Para más información, consulte Descripción del parámetro packageSigns.
actionStringSímonitorLa acción de la regla. Valores válidos: deny (bloquear) y monitor (monitorear).

Descripción del parámetro packageSigns

ParámetroTipoObligatorioEjemploDescripción
nameStringSíaaaaaEl nombre de paquete válido.
signStringNobbbbLa firma del paquete.

Ejemplo de configuración de protección avanzada (detección de aplicaciones reempaquetadas):

[
  {
    "type": "app_package",
    "status": "on",
    "config": {"packageSigns":[{"name":"aaaaa","sign":"bbbb"},{"name":"cccc","sign":"dddd"}]},
    "action": "deny"
  }
]

Ejemplo de configuración de parámetros combinados para la protección de páginas web/navegadores en la gestión de bots

[
    {
        "type": "target_type",
        "status": "on",
        "config":
        {
            "target": "web"
        },
        "action": ""
    },
    {
        "type": "web_sdk",
        "status": "on",
        "config":
        {
            "mode": "automatic",
            "crossDomain": "example.com"
        },
        "action": ""
    },
    {
        "type": "traffic_feature",
        "status": "on",
        "config":
        {
            "conditions":
            [
                {
                    "key": "Header",
                    "subKey": "User-Agent",
                    "opValue": "contain",
                    "values": "Chrome"
                },
                {
                    "key": "IP",
                    "subKey": "",
                    "opValue": "ip-contain",
                    "values": "192.168.0.1/24"
                }
            ]
        },
        "action": ""
    },
    {
        "type": "intelligence_crawler",
        "status": "on",
        "config":
        {
            "name": "intelligence_crawler_baidu"
        },
        "action": "bypass"
    },
    {
        "type": "intelligence_crawler",
        "status": "on",
        "config":
        {
            "name": "intelligence_crawler_google"
        },
        "action": "bypass"
    },
    {
        "type": "js",
        "status": "on",
        "config":
        {},
        "action": "js"
    },
    {
        "type": "sigchl",
        "status": "on",
        "config":
        {
            "sigchl":
            [
                "sig",
                "replay",
                "driver"
            ]
        },
        "action": "sigchl"
    },
    {
        "type": "algorithm",
        "status": "on",
        "config":
        {},
        "action": "captcha"
    },
    {
        "type": "custom_cc_ip",
        "status": "on",
        "config":
        {
            "interval": 20,
            "target": "IP",
            "threshold": 50,
            "ttl": 2800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc_ip",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "IP",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "Query String Parameter",
            "subKey": "arg",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "deny"
    },
    {
        "type": "custom_cc",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "Query String Parameter",
            "subKey": "arg",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "captcha"
    },
    {
        "type": "intelligence",
        "status": "on",
        "config":
        {},
        "action": "captcha"
    },
    {
        "type": "intelligence_idc",
        "status": "on",
        "config":
        {
            "name": "intelligence_idc_alibaba"
        },
        "action": "captcha"
    },
    {
        "type": "intelligence_idc",
        "status": "on",
        "config":
        {
            "name": "intelligence_idc_tencent"
        },
        "action": "captcha"
    },
    {
        "type": "intelligence_fake_crawler",
        "status": "on",
        "config":
        {},
        "action": "deny"
    }
]

Ejemplo de configuración de parámetros combinados para la protección de aplicaciones en la gestión de bots

[
    {
        "type": "target_type",
        "status": "on",
        "config":
        {
            "target": "app"
        },
        "action": ""
    },
    {
        "type": "traffic_feature",
        "status": "on",
        "config":
        {
            "conditions":
            [
                {
                    "key": "Header",
                    "subKey": "User-Agent",
                    "opValue": "contain",
                    "values": "Chrome"
                },
                {
                    "key": "IP",
                    "subKey": "",
                    "opValue": "ip-contain",
                    "values": "192.168.0.1/24"
                }
            ]
        },
        "action": ""
    },
    {
        "type": "custom_cc_ip",
        "status": "on",
        "config":
        {
            "interval": 20,
            "target": "IP",
            "threshold": 50,
            "ttl": 2800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc_ip",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "IP",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc_dev",
        "status": "on",
        "config":
        {
            "interval": 20,
            "target": "Header",
            "subKey": "aliwaf_wxbb_umid",
            "threshold": 50,
            "ttl": 2800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc_dev",
        "status": "on",
        "config":
        {
            "interval": 20,
            "target": "Header",
            "subKey": "aliwaf_wxbb_umid",
            "threshold": 50,
            "ttl": 2800
        },
        "action": "deny"
    },
    {
        "type": "custom_cc",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "Query String Parameter",
            "subKey": "arg",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "monitor"
    },
    {
        "type": "custom_cc",
        "status": "on",
        "config":
        {
            "interval": 10,
            "target": "Query String Parameter",
            "subKey": "arg",
            "threshold": 30,
            "ttl": 1800
        },
        "action": "deny"
    },
    {
        "type": "app_sdk",
        "status": "on",
        "config":
        {
            "featureAbnormal":
            [
                "simulator",
                "proxy",
                "root",
                "debugged",
                "hook",
                "virtual",
                "antiReplay",
                "signInvalid"
            ],
            "customSignStatus": "on",
            "customSign":
            {
                "key": "header",
                "value": "ua"
            }
        },
        "action": "monitor"
    },
    {
        "type": "app_package",
        "status": "on",
        "config":
        {
            "packageSigns":
            [
                {
                    "name": "aaaaa",
                    "sign": "bbbb"
                },
                {
                    "name": "cccc",
                    "sign": "dddd"
                }
            ]
        },
        "action": "deny"
    }
]

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

CB1A380B-09F0-41BB-280B-72F8FD6DA2FE

RuleIds

object

RuleId

array

La lista de ID de reglas de protección.

string

La lista de ID de las reglas creadas.

100001,200002

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "CB1A380B-09F0-41BB-280B-72F8FD6DA2FE",
  "RuleIds": {
    "RuleId": [
      "100001,200002"
    ]
  }
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 InvalidParameter The specified parameter is invalid. El parámetro no es válido.
400 Policy.NotExist The specified policy does not exist. La política de protección especificada no existe.
400 RuleConfigs.Malformed The specified RuleConfigs format is invalid. El parámetro RuleConfigs especificado tiene un formato incorrecto.
400 RuleName.AlreadyExists Rule name already exists in specified policy. El nombre de la regla ya existe en la política especificada.
400 Rule.QuantityOverflow Rules are overflowed quantity in specified policy. El número de reglas en la política especificada ha excedido la cuota.
500 InternalError An internal error occurred; please try again later. Ocurrió un error interno. Inténtelo de nuevo. Si el error persiste después de varios intentos, envíe un ticket.
403 %s.NotSupport The specified resource type %s is not supported. El tipo de recurso especificado no es compatible. Para utilizar este tipo de recurso, póngase en contacto con nosotros.
403 %s.OverQuota The quantity of %s exceeds the quota. La cantidad de este recurso supera el límite de cuota. Para solicitar una cuota mayor, póngase en contacto con nosotros.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.