Pular para o conteúdo
Documentação

WAF (Coraza)

Instale o OWASP Coraza WAF, ligue-o por domínio em modo detecção ou bloqueio, trie falsos-positivos e mantenha o OWASP CRS atualizado.

R Regis Manze 20/11/2026 6 min de leitura

O WAF do miniProxy usa o OWASP Coraza com as regras do OWASP Core Rule Set (CRS) para inspecionar cada requisição em busca de ataques como SQL injection, XSS e path traversal. Ele é ligado domínio a domínio, em modo Deteccao (só registra) ou Bloqueio (responde 403), e a tela Seguranca > WAF concentra a política, as exclusões e os eventos.

Instalar a infraestrutura

Enquanto o WAF não estiver instalado, a tela mostra a etiqueta infra nao instalada e o aviso para rodar o setup-waf.sh.

  1. Acesse o servidor do proxy por SSH como root.
  2. Na pasta do miniProxy, rode:
./setup-waf.sh

O script pode ser executado mais de uma vez sem problema. Ele:

  • instala o Go (se faltar) e compila o serviço coraza-spoa;
  • cria o serviço do systemd, o usuário e o /etc/coraza-spoa/config.yaml;
  • baixa o OWASP CRS para /etc/coraza-spoa/coreruleset/ (se o download falhar, usa o CRS embutido no binário);
  • cria o /etc/haproxy/coraza.cfg e liga o WAF ao HAProxy (filter spoe no frontend HTTPS e backend coraza-spoa);
  • configura a rotação dos logs do Coraza;
  • valida a config com haproxy -c e recarrega o HAProxy.

Ao final, o topo da tela WAF passa a mostrar daemon ativo.

Atenção: o script altera o haproxy.cfg e faz uma cópia antes (haproxy.cfg.waf-bak.<data>). Se a validação falhar, ele para e mostra o erro sem recarregar.

Ligar o WAF num domínio

O modo é escolhido na tela do domínio:

  1. Abra o domínio na lista de Dominios.
  2. No quadro Seguranca, localize WAF (OWASP).
  3. Escolha o modo e clique no botão de confirmar (✓):
Opção Efeito no tráfego
Desligado As requisições do domínio não passam pelo WAF.
Deteccao (so registra) O WAF analisa e registra os eventos, mas não bloqueia nada.
Bloqueio Requisições que ultrapassam o limite de anomalia recebem 403.

O domínio passa a exibir a etiqueta WAF det ou WAF bloq na lista. Se o serviço estiver parado, aparece daemon inativo ao lado do seletor.

Dica: comece sempre em Deteccao (so registra). Deixe rodar alguns dias com tráfego real, trate os falsos-positivos na aba Triagem e só então mude para Bloqueio.

IPs da Whitelist não são enviados ao WAF. Se o serviço coraza-spoa não responder, as requisições seguem sem inspeção (o site não cai por causa do WAF).

Abas da tela WAF

O topo mostra o estado do serviço, quantos domínios têm WAF, o total de exclusões por path e quantos bloqueios recentes houve.

Triagem

A aba Triagem agrupa os eventos recentes por domínio + regra + path e sugere um veredito:

Etiqueta Quando aparece
provavel falso-positivo Vários IPs diferentes, muitas ocorrências ou endpoint de aplicação/API (/rest, /api, /graphql, /media, /static, /admin...).
revisar Sinais mistos.
provavel ataque Um único IP e/ou severidade crítica.

Cada cartão mostra a regra, a mensagem, o domínio, o path, o número de hits e de IPs, e os motivos do veredito. Para decidir:

  1. Escolha o escopo da exclusão:
    • So neste dominio+path: desliga a regra apenas para URLs do domínio que começam com o prefixo do campo de path (você pode editar o prefixo);
    • Dominio inteiro: desliga a regra em todo o domínio;
    • Global: desliga a regra em todos os domínios.
  2. Clique em um dos botões:
    • Falso-positivo: cria a exclusão no escopo escolhido e recarrega o Coraza;
    • ícone de inseto (Marcar como ataque): só registra a decisão, sem mudar regras;
    • ícone de olho cortado (Ignorar): tira o item da lista.

O item decidido some da triagem. Para trazer de volta todos os itens decididos, use Limpar decisoes.

Atenção: as regras de pontuação do CRS (IDs 949xxx e 980xxx) não aparecem na triagem. Desligá-las desativaria todo o bloqueio do WAF.

Politica

OWASP Core Rule Set mostra de onde vem o CRS (disco, atualizável, ou embutido no binario) e a versão instalada.

  • Verificar atualizacoes consulta a última versão publicada. Se houver uma mais nova, aparece o botão Atualizar, que baixa, valida e aplica o novo CRS e recarrega o Coraza. Se algo falhar, o CRS anterior continua valendo.
  • Auto-update semanal do CRS (systemd timer) instala a versão mais recente toda semana, automaticamente.

Politica global do OWASP CRS:

Campo O que informar
Paranoia level PL1 (padrão) a PL4 (máximo). Nível maior detecta mais ataques, mas gera mais falsos-positivos.
Threshold de anomalia (entrada) Pontuação a partir da qual a requisição é considerada ataque. Menor = mais rígido (padrão 5).
Threshold de anomalia (saida) O mesmo, para as respostas.
Inspecionar corpo da requisicao (POST/JSON) Liga a análise do corpo de formulários e APIs.
Regras desligadas globalmente (IDs) IDs de regra separados por espaço ou vírgula, desligados em todos os domínios.
Diretivas SecLang customizadas (avancado) Regras próprias do Coraza, inseridas antes do CRS. Use IDs entre 1000 e 9999999.

Clique em Salvar e aplicar. O Coraza é recarregado sem derrubar conexões.

Exclusoes por dominio

  • Exclusoes globais por path: desligam uma regra para um prefixo de URL em todos os domínios, atuais e futuros (útil para a API REST de uma plataforma usada em várias lojas). Informe ID da regra e Prefixo do path (ex.: /rest/V1) e clique em Adicionar.
  • Exclusoes por dominio: tabela com o modo do WAF de cada domínio, as regras excluídas no domínio inteiro e as exclusões por path (criadas pela triagem). O botão X remove uma exclusão por path; o lápis abre Exclusoes do dominio, onde você digita os IDs de regra a desligar neste dominio e clica em Salvar e aplicar (deixar vazio remove todas).

A regra excluída continua ativa nos demais domínios e paths.

Eventos

Mostra Regras mais acionadas e a lista Eventos recentes (Hora, Regra, Mensagem, URI, Cliente). Use Só bloqueados e o campo de filtro para refinar. O botão Excluir (ou excluir na linha) abre Excluir regra, onde você escolhe Global (todos os dominios) ou um domínio e confirma em Excluir e aplicar.

Atenção: desligar uma regra reduz a proteção. Prefira sempre o escopo mais estreito: domínio + path, depois domínio inteiro, e global só em último caso.

Logs

Mostra o log bruto do coraza-spoa, lido do Arquivo ou do Servico (journal), com filtro por texto, nível (Todos, Warn+Erro, Só erros), quantidade de linhas, opção JSON, Tempo real e botão para baixar o log.

Veja também

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!