Configura regras de proteção do WAF.
Descrição da operação
Limite de taxa por usuário: 20 chamadas por segundo.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
dcdn:BatchCreateDcdnWafRules |
create |
*All resources.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| PolicyId |
integer |
Sim |
O ID da política. |
1000001 |
| RuleConfigs |
string |
Sim |
A configuração das regras de proteção. |
[{"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"}] |
Descrição do valor de RuleConfigs
RuleConfigs é uma lista (list slice), onde cada struct representa uma regra.
O formato de RuleConfigs varia de acordo com o tipo da política de proteção especificada por PolicyId.
Cenário de proteção 1: Proteção por regex web (waf_group)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| status | String | Não | on | A chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on. |
| action | String | Sim | block | A ação da regra. Valores válidos: block (bloquear solicitações) e monitor (monitorar solicitações). |
| wafGroupIds | String | Não | 1012 | O ID do grupo de regras do WAF. Valor padrão: 1012. Separe vários IDs com vírgulas (,). |
Exemplo de configuração de waf_group:
// A proteção por regex web atualmente suporta apenas uma regra por política.
[
{
"status": "on",
"action": "block"
}
]
Cenário de proteção 2: Regras personalizadas (custom_acl)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| name | string | Sim | acl_1 | O nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres. |
| status | string | Não | on | A chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on. |
| conditions | Condition | Sim | [ {"key": "URI", "subKey": "","opValue": "contain", "values": "/login.php" }] | As condições que acionam a regra. Para mais informações sobre os parâmetros, consulte a Tabela 1 Descrição da métrica Condition. |
| ccStatus | string | Sim | off | A chave para controle de frequência. Valores válidos: on (ativar) e off (desativar). |
| rateLimit | RateLimit | Não | { "target": "Header", "subKey": "User-Agent", "interval": 5, "threshold": 2, "ttl": 1800} | A regra de controle de frequência. Este parâmetro é obrigatório quando ccStatus é definido como on. Para mais informações sobre os parâmetros, consulte a Tabela 2 Descrição da métrica RateLimit. |
| effect | string | Não | service | O escopo efetivo da lista negra de controle de frequência. Este parâmetro é obrigatório quando ccStatus é definido como on. Valores válidos: rule (efetivo para a regra atual) e service (efetivo globalmente). |
| action | string | Sim | deny | A ação da regra. Valores válidos: deny (bloquear), js (verificação JavaScript) e monitor (monitorar). |
Tabela 1 Descrição da métrica Condition
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Key | string | Sim | Query String Parameter | O campo de correspondência. Para mais informações, consulte DescribeDcdnWafFilterInfo. |
| subKey | string | Não | action | O subcampo de correspondência. Para mais informações, consulte DescribeDcdnWafFilterInfo. |
| opValue | String | Sim | eq | O operador lógico. Para mais informações, consulte DescribeDcdnWafFilterInfo. |
| values | String | Não | js | O conteúdo de correspondência. Separe vários valores com vírgulas (,). Para mais informações, consulte DescribeDcdnWafFilterInfo. |
Tabela 2 Descrição da métrica RateLimit
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| target | string | Sim | Header | O campo estatístico para controle de frequência. Valores válidos: IP (conta a frequência de solicitações do mesmo endereço IP), Header (conta a frequência de solicitações que contêm o cabeçalho especificado), Query String Parameter (conta a frequência de solicitações que contêm o parâmetro especificado), Cookie Name (conta a frequência de solicitações que contêm o cookie especificado) e Session (conta a frequência de solicitações da mesma sessão). |
| subKey | string | Não | User-Agent | O subcampo do campo unificado. Este parâmetro é obrigatório quando target é definido como Header, Query String Parameter ou Cookie Name. |
| Interval | Integer | Sim | 5 | O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos. |
| threshold | Integer | Sim | 2 | O limite estatístico. Valores válidos: 2 a 500000. Unidade: vezes. |
| ttl | Integer | Sim | 1800 | O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos. |
| status | RateLimitStatus | Não | {"code": "404", "ratio": 10} | As estatísticas de códigos de resposta. Para mais informações sobre os parâmetros, consulte a Tabela 3 Descrição da métrica RateLimitStatus. |
Tabela 3 Descrição da métrica RateLimitStatus
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| codet | string | Sim | 404 | O código de status HTTP. |
| ratio | Integer | Não | 10 | A porcentagem estatística (%). Valores válidos: 1 a 100. Este parâmetro e o parâmetro count são mutuamente exclusivos. |
| count | Integer | Não | 10 | A contagem estatística. Valores válidos: 2 a 50000. Este parâmetro e o parâmetro ratio são mutuamente exclusivos. |
Exemplo de configuração de custom_acl:
[
// Controle de acesso
{
"name": "acl_1",
"status": "off",
"conditions":
[
{
"key": "Query String Parameter",
"subKey": "action",
"opValue": "eq",
"values": "js"
}
],
"ccStatus": "off",
"action": "js"
},
// Controle de frequência
{
"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"
}
]
Cenário de proteção 3: Lista de permissões (whitelist)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| name | string | Sim | on | O nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres. |
| status | string | Não | on | A chave da regra de proteção. Valores válidos: on (padrão, ativar) e off (desativar). |
| conditions | Condition | Sim | [{ "key": "Http-Method","subKey": "","opValue": "match-one", "values": "GET,POST,DELETE" }] | As condições que acionam a regra. Para mais informações sobre os parâmetros, consulte a Tabela 1 Descrição da métrica Condition. |
| tags | String | Sim | [ "waf_group", "custom_acl"] | A lista de tipos de políticas de proteção. |
| regularTypes | String | Não | [ [ "sqli", "xss","code_exec", "crlf", "lfilei", "rfilei", "webshell","vvip", "other"] | O tipo da regra de expressão regular. Este parâmetro pode ser especificado quando waf_group está incluído em tags. Valores válidos: sqli, xss, code_exec, crlf, lfilei, rfilei, webshell, vvip e other. |
| regularRules | String | Não | [ "100001", "100002", "100003"] | A regra de expressão regular. Este parâmetro pode ser especificado quando waf_group está incluído em tags. Este parâmetro e regularTypes são mutuamente exclusivos. O valor é uma lista de strings de seis dígitos. |
Exemplo de configuração de whitelist:
[
// Ignorar todos os cenários
{
"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"
]
},
// Ignorar IDs de regras especificados em 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"
]
},
{
// Ignorar tipos de regras especificados em 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"
]
},
// Ignorar regras personalizadas
{
"name": "wl_custom_acl",
"status": "on",
"conditions":
[
{
"key": "Http-Method",
"subKey": "",
"opValue": "match-one",
"values": "GET,POST,DELETE"
}
],
"tags":
[
"custom_acl"
]
},
// Ignorar lista negra de IPs
{
"name": "wl_ip_blacklist",
"status": "on",
"conditions":
[
{
"key": "Http-Method",
"subKey": "",
"opValue": "match-one",
"values": "GET,POST,DELETE"
}
],
"tags":
[
"ip_blacklist"
]
},
// Ignorar bloqueio de região
{
"name": "wl_region_block",
"status": "on",
"conditions":
[
{
"key": "Http-Method",
"subKey": "",
"opValue": "match-one",
"values": "GET,POST,DELETE"
}
],
"tags":
[
"region_block"
]
}
]
Cenário de proteção 4: Lista negra de IPs (ip_blacklist)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| name | string | Sim | ipblacklist | O nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres. |
| status | string | Não | on | A chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on. |
| remoteAddr | []String | Sim | ["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"] | Filtra por endereço IP. Para mais informações, consulte DescribeDcdnWafFilterInfo. |
| action | string | Sim | deny | A ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar). |
Exemplo de configuração de ipblacklist:
[
{
"name": "ipblacklist",
"status": "on",
"remoteAddr": ["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"],
"action": "deny"
}
]
Cenário de proteção 5: Bloqueio de região (region_block)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| status | string | Não | on | A chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on. |
| cnRegionList | string | Não | 110000,TW,MO | As regiões bloqueadas na parte continental da China, separadas por vírgulas (,). Para mais informações sobre as regiões suportadas, consulte DescribeDcdnWafGeoInfo. |
| otherRegionList | string | Não | JP,GB | As regiões bloqueadas fora da parte continental da China, separadas por vírgulas (,). Para mais informações sobre as regiões suportadas, consulte DescribeDcdnWafGeoInfo. |
| action | string | Sim | deny | A ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar). |
Você deve especificar pelo menos um entre cnRegionList e otherRegionList.
Exemplo de configuração de region_block:
[
{
"status": "on",
"cnRegionList": "110000,TW,MO",
"otherRegionList": "JP,GB",
"action": "deny"
}
]
Cenário de proteção 6: Gerenciamento de bots (bot)
Modelo de regra
Todos os parâmetros da regra incluem os quatro campos a seguir. Para valores específicos, consulte a categoria de regra correspondente.
| Parâmetro | Tipo | Obrigatório | Descrição |
| type | String | Sim | O tipo da regra. Para mais informações, consulte a categoria de regra específica. |
| status | String | Sim | O status da regra. Valores válidos: on (ativado) e off (desativado). |
| config | TargetType | Não | A configuração da regra. Para mais informações, consulte a categoria de regra específica. |
| action | String | Não | A ação da regra. Para mais informações, consulte a categoria de regra específica. |
Categoria de regra 1: Tipo de objeto protegido
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | target_type | O tipo da regra. Defina o valor como target_type. |
| status | String | Sim | on | A chave da regra. Valor válido: on (ativado). |
| config | TargetType | Não | {"target":"app"} | A configuração da regra. Formato: target: o tipo de objeto protegido. Obrigatório. Valores válidos: web (páginas da web/navegadores) e app (aplicativos). |
| action | String | Não | Vazio | A ação da regra. Não aplicável aqui. Defina como um valor vazio. |
Exemplo de configuração de tipo de objeto protegido:
[
{
"type":"target_type",
"status":"on",
"config":{"target":"app"},
"action":""
}
]
Categoria de regra 2: Integração do Web SDK
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | web_sdk | O tipo da regra. Defina o valor como web_sdk. |
| status | String | Sim | on | A chave da regra. Valor válido: on (ativado). |
| config | WebSdk | Não | {"mode":"automatic","crossDomain":"example.com"} | A configuração da regra. Formato: mode: o método de integração do Web SDK. Obrigatório. Valores válidos: automatic (integração automática) e manual (integração manual). crossDomain: a chamada de nome de domínio entre domínios. Opcional. Este parâmetro só entra em vigor quando mode é definido como automatic. |
| action | String | Não | Vazio | A ação da regra. Não aplicável aqui. Defina como um valor vazio. |
Exemplo de configuração de integração do Web SDK:
[
{
"type":"web_sdk",
"status":"on",
"config":{"mode":"automatic","crossDomain":"example.com"},
"action":""
}
]
Categoria de regra 3: Recursos de tráfego
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | traffic_feature | O tipo da regra. Defina o valor como traffic_feature. |
| status | String | Sim | on | A chave da regra. Valor válido: on (ativado). |
| config | TrafficFeature | Sim | {"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]} | A configuração da regra. Para mais informações, consulte condition. |
| action | String | Não | Vazio | A ação da regra. Não aplicável aqui. Defina como um valor vazio. |
condition (Condições de correspondência)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| key | String | Sim | Header | O campo de correspondência. Para valores específicos, consulte DescribeDcdnWafFilterInfo. |
| subKey | String | Não | User-Agent | O subcampo de correspondência. Para valores específicos, consulte DescribeDcdnWafFilterInfo. |
| opValue | String | Sim | contain | O operador. Para valores específicos, consulte DescribeDcdnWafFilterInfo. |
| values | String | Não | Chrome | O conteúdo de correspondência. Separe vários valores com vírgulas (,). Para valores específicos, consulte DescribeDcdnWafFilterInfo. |
Exemplo de configuração de recursos de tráfego:
[
{
"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":""
}
]
Categoria de regra 4: Gerenciamento de bots legítimos
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | intelligence_crawler | O tipo da regra. Defina o valor como intelligence_crawler. |
| status | String | Sim | on | A chave da regra. Valor válido: on (ativado). |
| config | IntelligenceCrawler | Não | {"name":"intelligence_crawler_baidu"} | A configuração da regra. Para valores válidos, consulte name (Lista de permissões de bots de mecanismos de busca). |
| action | String | Sim | bypass | A ação da regra. Valor válido: bypass (permitir). |
name (Lista de permissões de bots de mecanismos de busca)
| Valor | Descrição |
| intelligence_crawler_all | Lista de permissões de mecanismos de busca legítimos (Google, Bing, Baidu, Sogou, 360, Yandex) |
| intelligence_crawler_baidu | Lista de permissões de bots do Baidu |
| intelligence_crawler_sogou | Lista de permissões de bots do Sogou |
| intelligence_crawler_360 | Lista de permissões de bots do 360 |
| intelligence_crawler_google | Lista de permissões de bots do Google |
| intelligence_crawler_bing | Lista de permissões de bots do Bing |
| intelligence_crawler_yandex | Lista de permissões de bots do Yandex |
Exemplo de configuração de gerenciamento 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"
}
]
Categoria de regra 5: Filtragem de script simples (desafio JavaScript)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | js | O tipo da regra. Defina o valor como js. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | Js | Não | Vazio | A configuração da regra. Não aplicável aqui. Defina como um valor vazio. |
| action | String | Sim | js | A ação da regra. Valor válido: js (verificação JavaScript). |
Exemplo de configuração de filtragem de script simples (desafio JavaScript):
[
{
"type":"js",
"status":"on",
"config":{},
"action":"js"
}
]
Categoria de regra 6: Proteção avançada contra bots (desafio de token dinâmico)
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | sigchl | O tipo da regra. Defina o valor como sigchl. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | Sigchl | Não | {"sigchl":["sig","replay","driver"]} | A configuração da regra. Formato: sigchl: a verificação de assinatura de dados da solicitação. Obrigatório. Valores válidos: sig (exceção de verificação de assinatura), replay (exceção de carimbo de data/hora da assinatura) e driver (ataque WebDriver). |
| action | String | Sim | sigchl | A ação da regra. Valor válido: sigchl (bloquear). |
Exemplo de configuração de proteção avançada contra bots (desafio de token dinâmico):
[
{
"type":"sigchl",
"status":"on",
"config":{"sigchl":["sig","replay","driver"]},
"action":"sigchl"
}
]
Categoria de regra 7: Proteção inteligente baseada em IA
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | algorithm | O tipo da regra. Defina o valor como algorithm. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | Algorithm | Não | Vazio | A configuração da regra. Não aplicável aqui. Defina como um valor vazio. |
| action | String | Sim | captcha | A ação da regra. Valores válidos: monitor (monitorar) e captcha (CAPTCHA de controle deslizante). |
Exemplo de configuração de proteção inteligente baseada em IA:
[
{
"type":"algorithm",
"status":"on",
"config":{},
"action":"captcha"
}
]
Categoria de regra 8: Limitação de taxa de IP
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | custom_cc_ip | O tipo da regra. Defina o valor como custom_cc_ip. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | CustomCcIp | Sim | {"interval":20,"target":"IP","threshold":50,"ttl":2800} | A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de IP. |
| action | String | Sim | monitor | A ação da regra. Valores válidos: deny (bloquear), monitor (monitorar) e captcha (CAPTCHA de controle deslizante, aplicável apenas à web). |
Descrição do parâmetro de configuração de limitação de taxa de IP
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| target | String | Sim | IP | O campo estatístico para controle de frequência. Valor válido: IP. |
| subKey | String | Não | Vazio | O subcampo do campo estatístico. Não aplicável aqui. Defina como um valor vazio. |
| Interval | Integer | Sim | 20 | O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos. |
| threshold | Integer | Sim | 50 | O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes. |
| ttl | Integer | Sim | 2800 | O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos. |
Exemplo de configuração de limitação de taxa 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"
}
]
Categoria de regra 9: Limitação de taxa de dispositivo
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | custom_cc_dev | O tipo da regra. Defina o valor como custom_cc_dev. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | CustomCcDev | Sim | {"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800} | A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de dispositivo. |
| action | String | Sim | monitor | A ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar). |
Descrição do parâmetro de configuração de limitação de taxa de dispositivo
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| target | String | Sim | Header | O campo estatístico para controle de frequência. Valor válido: Header. |
| subKey | String | Não | aliwaf_wxbb_umid | O subcampo do campo estatístico. Valor válido: aliwaf_wxbb_umid. |
| Interval | Integer | Sim | 20 | O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos. |
| threshold | Integer | Sim | 50 | O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes. |
| ttl | Integer | Sim | 2800 | O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos. |
Exemplo de configuração de limitação de taxa de dispositivo:
[
{
"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"
}
]
Categoria de regra 10: Limitação de taxa de sessão personalizada
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| type | String | Sim | custom_cc | O tipo da regra. Defina o valor como custom_cc. |
| status | String | Sim | on | A chave da regra. Valores válidos: on (ativado) e off (desativado). |
| config | CustomCcIp | Sim | {"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800} | A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de sessão personalizada. |
| action | String | Sim | monitor | A ação da regra. Valores válidos: deny (bloquear), monitor (monitorar) e captcha (CAPTCHA de controle deslizante, aplicável apenas à web). |
Descrição do parâmetro de configuração de limitação de taxa de sessão personalizada
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| target | String | Sim | Query String Parameter | O campo estatístico para controle de frequência. Valores válidos: Header (conta a frequência de solicitações que contêm o cabeçalho especificado), Query String Parameter (conta a frequência de solicitações que contêm o parâmetro especificado), Cookie Name (conta a frequência de solicitações que contêm o cookie especificado) e Session (conta a frequência de solicitações da mesma sessão). |
| subKey | String | Não | arg | O subcampo do campo estatístico. Valor personalizado. |
| Interval | Integer | Sim | 10 | O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos. |
| threshold | Integer | Sim | 30 | O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes. |
| ttl | Integer | Sim | 2800 | O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos. |
Exemplo de configuração de limitação de taxa de sessão personalizada:
[
{
"type":"custom_cc",
"status":"on",
"config":{"
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
CB1A380B-09F0-41BB-280B-72F8FD6DA2FE |
| RuleIds |
object |
||
| RuleId |
array |
A lista de IDs de regras de proteção. |
|
|
string |
A lista de IDs das regras criadas. |
100001,200002 |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "CB1A380B-09F0-41BB-280B-72F8FD6DA2FE",
"RuleIds": {
"RuleId": [
"100001,200002"
]
}
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | O parâmetro é inválido. |
| 400 | Policy.NotExist | The specified policy does not exist. | A política de proteção especificada não existe. |
| 400 | RuleConfigs.Malformed | The specified RuleConfigs format is invalid. | O parâmetro RuleConfigs especificado está malformado. |
| 400 | RuleName.AlreadyExists | Rule name already exists in specified policy. | O nome da regra já existe na política especificada. |
| 400 | Rule.QuantityOverflow | Rules are overflowed quantity in specified policy. | O número de regras na política especificada excedeu a cota. |
| 500 | InternalError | An internal error occurred; please try again later. | Ocorreu um erro interno. Tente novamente. Se o erro persistir após várias tentativas, abra um ticket. |
| 403 | %s.NotSupport | The specified resource type %s is not supported. | O tipo de recurso especificado não é suportado. Para usar este tipo de recurso, entre em contato conosco. |
| 403 | %s.OverQuota | The quantity of %s exceeds the quota. | A quantidade deste recurso excede o limite de cota. Para solicitar uma cota maior, entre em contato conosco. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.