Verifique ou altere o modo do WAF

O modo fica no comportamento Set WAF de uma regra do Rules Engine, não no rule set. Leia-o ali, e altere-o ali.

Última atualização

Ver como Markdown Configurar agente

Você pode ler o modo de um rule set do Web Application Firewall (WAF), e alterá-lo, pelo Azion Console ou pela API.

O modo é um atributo do comportamento Set WAF de uma regra do Rules Engine for Firewall. Ele não é um campo do rule set. Por isso um mesmo rule set pode rodar em um modo em uma regra e em outro modo em outro lugar. Aplicar um rule set pela primeira vez é assunto de Crie e aplique um WAF rule set.

Selecione a interface que você vai usar. Os pré-requisitos e as duas tarefas abaixo seguem essa escolha.

Pré-requisitos

  • Um personal token e o curl. Para criar um token, consulte Personal Tokens.
  • O id do firewall que carrega a regra.

Verifique o modo

Um firewall guarda várias regras, e só a que carrega Set WAF decide o modo. Encontre essa regra primeiro.

Para ler o modo no Azion Console:

Abra o firewall

Acesse o Azion Console > Firewalls e selecione o firewall que roda o rule set.

Selecione a aba Rules Engine
Selecione a regra que aplica o rule set

Uma regra que aplica um rule set a todas as requisições traz If Request Uri starts with / em Criteria, e Set WAF em Behaviors.

Leia o modo

Na seção Behaviors, o comportamento Set WAF nomeia o rule set. O dropdown de modo ao lado dele mostra Logging ou Blocking.

Esse valor é o modo sob o qual roda toda requisição selecionada por essa regra. Uma regra carrega no máximo um comportamento Set WAF.

Para ler o modo pela API:

Liste as regras do firewall

Substitua <firewall-id> pelo id do seu firewall, e [TOKEN VALUE] pelo seu personal token:

Shell
01curl --request GET \
02 --url https://api.azion.com/v4/workspace/firewalls/<firewall-id>/request_rules \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]'
Encontre o comportamento set_waf

A chamada responde 200. A regra que aplica um rule set retorna com este comportamento:

JSON
01"behaviors": [
02 { "type": "set_waf", "attributes": { "waf_id": 12345, "mode": "blocking" } }
03]

mode carrega logging ou blocking, os dois valores que o Azion Console renderiza como Logging e Blocking. Anote o id dessa regra. Alterar o modo precisa dele.

Altere o modo

O modo tem exatamente dois valores, e learning não é um deles. Para o que cada modo faz com uma requisição que alcança um limiar, consulte Score e modos.

Para alterar o modo no Azion Console:

Abra a regra

Chegue até a regra pelos passos de Verifique o modo.

Abra o dropdown de modo no comportamento Set WAF
Selecione Logging ou Blocking
Selecione Save

A regra agora nomeia o novo modo. A alteração leva algum tempo para alcançar a infraestrutura distribuída da Azion. Uma requisição que ainda se comporta sob o modo anterior não quebrou nada: espere e envie de novo.

Envie o comportamento set_waf inteiro, porque mode é obrigatório dentro dele. Um comportamento que omite mode é recusado com 400 e o erro 10059 Required Field, no pointer /data/behaviors/0/attributes/mode.

Envie a alteração

Substitua <firewall-id> e <rule-id> pelos ids que você anotou, e waf_id pelo id do seu rule set. Envie o array behaviors completo da regra, e não apenas a entrada set_waf:

Shell
01curl --request PATCH \
02 --url https://api.azion.com/v4/workspace/firewalls/<firewall-id>/request_rules/<rule-id> \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "behaviors": [
08 {
09 "type": "set_waf",
10 "attributes": {
11 "waf_id": 12345,
12 "mode": "logging"
13 }
14 }
15 ]
16}
Leia o modo de volta

Rode de novo o GET de Verifique o modo, e confirme que mode carrega o valor que você enviou.

Qualquer outro valor é recusado. Outras superfícies da Azion escrevem esse modo como learning, e um comportamento que carregue esse valor retorna:

JSON
01{
02 "errors": [
03 {
04 "code": "10039",
05 "title": "Invalid Choice",
06 "detail": "\"learning\" is not a valid choice.",
07 "status": "400",
08 "source": { "pointer": "/data/behaviors/0/attributes/mode" }
09 }
10 ]
11}

Próximos passos

Score e modosO que cada modo faz com uma requisição, e o que uma requisição bloqueada recebe.Ajuste um WAF rule setLeia o que um rule set correspondeu em Logging e transforme um falso positivo em uma exceção.Encontre o score de uma requisição bloqueadaEncontre o score e a regra que disparou em uma requisição.Solucionar problemas de FirewallO que verificar quando um rule set não bloqueia nada, ou bloqueia o tráfego errado.