A linguagem de regras do WAF
A sintaxe para escrever regras próprias de firewall: campos, operadores e ações. Com os enganos mais comuns e como evitá-los.
Quando vale a pena
Uma regra própria serve o que as prontas não sabem: o que é específico do teu site.
- Bloquear
/admina tudo o que não venha do IP do escritório. - Deixar passar sempre um integrador conhecido.
- Registar tudo o que traz um cabeçalho suspeito, para decidir depois.
Não vale a pena escrever uma regra para o que o nível de proteção já apanha. Ver Nível de proteção.
A forma de uma regra
http.request.uri.path contains "/admin" and ip.src ne "203.0.113.7"
Combinas campos com operadores, juntas condições com and, or e not, e agrupas com parênteses. A ação escolhe-se à parte.
Precedência
not liga mais do que and, que liga mais do que or. Como em quase todas as linguagens — e como em quase todas, põe parênteses quando misturas and e or:
# Não é o que parece: o `and` liga primeiro.
a or b and c
# Isto é inequívoco.
(a or b) and c
Esta é a origem da maioria das regras que «não fazem o que eu quero».
Campos
| Campo | O que é |
|---|---|
http.request.method | GET, POST, … |
http.request.uri.path | o caminho, sem query string |
http.request.uri.query | a query string em cru |
http.host | o cabeçalho Host, em minúsculas |
http.user_agent | o User-Agent, tal como veio |
ip.src | o IP do cliente, já resolvido através dos proxies de confiança |
http.request.body | o corpo, quando disponível |
Duas notas que evitam regras que nunca combinam:
uri.pathnão traz a query string. Uma regra sobre?admin=1tem de olhar parauri.query.http.request.bodyestá vazio em muitas fases. Só está disponível onde o corpo já foi lido; uma regra sobre o corpo que nunca combina costuma ser isto.
Operadores
| Operador | O que faz |
|---|---|
eq / ne | igual / diferente |
contains | contém, como texto — sem padrões |
matches | expressão regular |
in / not in | pertence a um conjunto |
Conjuntos
Para vários valores, um conjunto é mais legível — e mais rápido — do que uma cadeia de or:
ip.src in {"203.0.113.7", "203.0.113.8", "198.51.100.4"}
Expressões regulares
matches usa RE2. Não tem retrocesso, o que significa que não há expressões que rebentem em tempo exponencial — a garantia que torna seguro aceitar padrões escritos por quem quer que seja.
O que RE2 não tem: retrovisões ((?<=…)) e referências para trás (\1). Se a tua expressão as usa, tem de ser reescrita.
Âncora o que deve ser âncora. matches "admin" combina com /nao-e-admin-nenhum/ola. Se querias o início, escreve matches "^/admin".
Ações
| Ação | O que acontece |
|---|---|
log | registamos e continuamos a avaliar. Não bloqueia. |
block | 403, e o pedido acaba ali. |
challenge | por agora igual a block; reservado para desafio ao visitante. |
allow | salta o resto da firewall para este pedido. |
ban_ip | bloqueia e propaga um bloqueio do IP a toda a frota. |
allow é a mais perigosa das cinco
Um allow salta a firewall toda — o motor de anomalias e as outras regras. Uma expressão de allow mais larga do que se pensava é um buraco aberto de propósito.
Uma regra de allow deve ser tão específica quanto conseguires: um IP concreto, um caminho concreto. Nunca só um User-Agent, que qualquer pessoa pode escrever no pedido.
ban_ip é fleet-wide e persistente
Bloqueia aquele IP em todos os nossos servidores, não só naquele. Serve para abuso confirmado, e não para uma suspeita — um IP de CGNAT ou de proxy empresarial pode ter centenas de pessoas legítimas atrás.
O caminho seguro para pôr uma regra em produção
- Escreve-a com
log. - Deixa correr o tempo suficiente para passar tráfego real — um dia útil, no mínimo.
- Vê o que ela apanhou em Site → Atividade → Ameaças.
- Se só apanhou o que devia, passa a
block. Se apanhou um cliente, a expressão está larga.
Este ciclo custa um dia e evita a chamada de um cliente bloqueado.
Ordem
As regras são avaliadas na ordem que definires, e a primeira que decide manda. Consequência: uma regra de allow no topo tapa tudo o que estiver abaixo dela para os pedidos que ela apanhar.
Ver também
- Regras avançadas — a mesma linguagem, pelo painel.
- Firewall de aplicação — o que as regras prontas já fazem.