blog
WordPress

Post não salva no WordPress: achar o ID da regra do ModSecurity

Como correlacionar o horário exato do POST com a linha do registro de acessos negados, desativar só o ID da regra que disparou e deixar a exceção documentada para repetir em qualquer site da carteira.

JR · · 12 min de leitura · 4 tabelas · 7 blocos de código

Resposta curta: Reproduza o POST anotando horário, código de status e IP, procure a linha `ModSecurity: Access denied` no registro de erros, extraia o `id` da regra dessa linha e desative apenas esse ID para aquele domínio, por root no WHM ou por chamado ao provedor. O resto do firewall continua ativo.

Neste artigo
  1. Por que salvar um post e não salvar outro aponta para regra de WAF
  2. O que o 403 e o 406 do ModSecurity viram na tela do cliente
  3. Reproduzir o POST uma vez, com horário, status e IP anotados
  4. Onde fica a linha Access denied e como extrair o id da regra
  5. Desativar só aquele ID, só naquele domínio
  6. Revalidar o salvamento e confirmar que a proteção continua ligada
  7. Registrar a exceção com caso de teste e data de revisão
  8. Como explicar ao cliente sem dizer que desligou o firewall
  9. Fonte: documentação do ModSecurity no cPanel

Por que salvar um post e não salvar outro aponta para regra de WAF

O caso clássico: o cliente escreve um post, clica em Publicar e o editor de blocos devolve "A atualização falhou" ou "Resposta não é uma resposta JSON válida". Em Elementor, aparece um erro genérico ao salvar. Em formulário de contato, a página volta com 403 e nenhum registro no banco.

O que separa isso de um 403 de permissão ou de .htaccess é uma característica só: o mesmo usuário, na mesma URL, consegue salvar um conteúdo e não consegue salvar outro. Permissão errada bloqueia sempre. Regra de WAF bloqueia quando o corpo da requisição casa com um padrão. Se o post com três palavras salva e o post com um trecho de código, uma tag <script>, um SELECT dentro de um tutorial ou uma URL longa não salva, o candidato número um é o ModSecurity.

O código de resposta costuma ser 403, mas depende de como a regra e o conjunto do fornecedor foram configurados no servidor. Anote o código exato que você viu em vez de assumir.

Uma observação de honestidade: este artigo é documental. Não há medição de laboratório da Napoleon aqui, porque o resultado depende inteiramente do conjunto de regras instalado em cada servidor e não daria número reproduzível. O que existe de verificável é a documentação do ModSecurity no cPanel e o registro do próprio servidor do cliente. Todos os IDs de regra citados abaixo são exemplos fictícios.

O que o 403 e o 406 do ModSecurity viram na tela do cliente

O bloqueio chega ao usuário traduzido pela interface, e cada tela traduz de um jeito. O que o cliente relata quase nunca é o código HTTP, é a frase.

O que o usuário vê Onde aparece Código por trás
"A atualização falhou" Editor de blocos, ao clicar em Publicar ou Atualizar 403 ou 406 na chamada a /wp-json/wp/v2/posts/123
"Resposta não é uma resposta JSON válida" Editor de blocos, mesma ação 403 ou 406 com corpo em HTML, que o editor não consegue interpretar como JSON
"Ocorreu um erro ao salvar" ou aviso genérico de conexão Elementor, Divi e outros construtores 403 ou 406 em /wp-admin/admin-ajax.php
Página recarrega sem salvar e sem aviso Editor clássico, /wp-admin/post.php 403
"Forbidden" ou "Not Acceptable" em página branca do servidor Formulário de contato, checkout, comentário 403 ou 406 servidos pelo Apache

O 406 costuma assustar mais porque é menos comum em WordPress. Nos conjuntos de regras que respondem com 406, a leitura prática é a mesma do 403: a requisição casou com um padrão e foi recusada antes de chegar ao PHP. Confirme sempre no DevTools qual dos dois você recebeu, porque esse número entra no chamado. Vale gastar dois minutos nisso, porque abrir chamado com o provedor dizendo "é o ModSecurity" e estar errado custa mais tempo do que o teste.

Sinal Aponta para Confirmação rápida
Falha em toda e qualquer edição, inclusive rascunho vazio Permissão, propriedade de arquivo ou disco cheio Conferir 755 em pastas, 644 em arquivos e espaço livre no cPanel
Erro 500, não 403 PHP, plugin ou .htaccess quebrado Ativar WP_DEBUG_LOG e ler o log do PHP
Falha some ao desativar plugins Conflito de plugin Desativar em lote e reativar um a um
Falha só com certo conteúdo no corpo do post Regra de WAF Bisseção do conteúdo (abaixo)
Falha só em um domínio da conta, com o mesmo tema e plugins Regra de WAF aplicada por domínio Comparar o registro de erros dos dois domínios

Bisseção do conteúdo para isolar o trecho que dispara a regra

É o teste mais barato e o que mais convence o cliente depois. Copie o conteúdo do post para um arquivo local. Apague metade, salve. Se salvou, o gatilho está na metade que você apagou. Traga metade dela de volta, salve de novo. Em quatro ou cinco rodadas você chega no parágrafo, e muitas vezes na linha exata, que dispara a regra.

Guardar esse trecho vale ouro: ele é o seu caso de teste para revalidar depois da exceção, e é a prova visual para o cliente de que não foi o WordPress que quebrou.

Como descartar as outras causas do erroFalha em toda ediçãoPermissão, dono do arquivo ou discoErro 500PHP, plugin ou .htaccessSome ao desativar pluginsConflito de pluginFalha só com certo conteúdoRegra de WAF: faça bisseção
Ordem de descarte antes de abrir chamado alegando ModSecurity. Só o último sinal aponta para regra de firewall de aplicação.

Reproduzir o POST uma vez, com horário, status e IP anotados

O erro mais comum nessa investigação é clicar em Publicar quinze vezes com raiva e depois tentar achar a linha certa no log. Faça uma reprodução limpa.

URL, status, horário e IP: o que o DevTools mostra antes de clicar em Publicar

No Chrome ou Firefox, aba Network, filtro em XHR/Fetch. Clique em Publicar. Você vai ver a requisição falhar. Registre:

Clique com o botão direito na requisição e use "Copy as cURL". Esse comando reproduz o POST idêntico, com cookies e nonce, direto do terminal. É o que você vai usar para revalidar sem depender do navegador.

Confirmar o fuso do servidor para não procurar no minuto errado

O relógio do log é o do servidor, não o do seu notebook. Se houver diferença de fuso, você procura no minuto errado e conclui que não há nada no log. Com SSH:

date

Sem SSH, o cPanel mostra a hora do servidor na área de informações do servidor. Anote a diferença em horas antes de abrir o log.

Onde fica a linha Access denied e como extrair o id da regra

Um bloqueio do ModSecurity deixa rastro no registro de erros do Apache, com uma linha que começa por ModSecurity: Access denied. Pelo cPanel, a leitura mais direta é a interface de erros, em Métricas, que exibe as entradas mais recentes do registro de erros da conta. Com acesso SSH, dá para filtrar melhor.

ls ~/logs/
grep "ModSecurity" ~/logs/*error*.log | tail -n 20

O caminho dos registros varia conforme a configuração do servidor. Se ~/logs/ não existir, pergunte ao provedor onde fica o registro de erros do domínio.

Filtre pelo minuto que você anotou e pelo IP de quem reproduziu:

grep "ModSecurity" ~/logs/*error*.log | grep "14:22:" | grep "203.0.113.45"

Uma linha de bloqueio tem esta forma (exemplo fictício, com ID e IP de documentação):

[Tue Sep 15 14:22:31.118342 2026] [:error] [pid 20481] [client 203.0.113.45] 
ModSecurity: Access denied with code 403 (phase 2). 
Pattern match "..." at ARGS:content. 
[file "/etc/apache2/conf.d/modsec_vendor_configs/exemplo/regras.conf"] 
[line "812"] [id "999999"] [msg "Exemplo de mensagem da regra"] 
[severity "CRITICAL"] [hostname "exemplo.com.br"] 
[uri "/wp-admin/post.php"] [unique_id "aBcDeFgHiJk"]

O que interessa em cada campo:

Campo Para que você usa
id O identificador da regra. É o único dado que permite desativação cirúrgica.
msg Descrição da regra. Vira a justificativa do chamado e a explicação ao cliente.
file e line Mostram de qual conjunto de regras (fornecedor) veio o bloqueio.
uri Confirma que o bloqueio foi na URL que você reproduziu.
hostname Confirma o domínio, importante em conta com vários sites.
ARGS:... Diz qual campo do formulário disparou (content, post_title, um campo do seu formulário).
unique_id Identificador único do evento. Serve para o provedor achar a entrada completa.

Quando mais de uma regra dispara na mesma requisição, liste os IDs por frequência:

grep "ModSecurity" ~/logs/*error*.log | grep -o 'id "[0-9]*"' | sort | uniq -c | sort -rn

Se você tem acesso root ao WHM (VPS ou servidor dedicado próprio), há ferramentas de ModSecurity no Security Center que dispensam o grep, incluindo visualização de acertos recentes e desativação de regra por ID. Vale registrar o limite da afirmação: a única fonte que eu cito neste artigo é a documentação de usuário do cPanel, que cobre a interface da conta, não a do WHM. Antes de prometer esse caminho ao cliente, confirme na tela do seu servidor. Em revenda sem root, essas ferramentas não aparecem: o caminho é o chamado ao provedor, como descrito na próxima seção.

Achar o id no modsec_audit.log pelo gerenciador de arquivos do cPanel

Sem SSH, o caminho é o Gerenciador de Arquivos. Funciona quando o provedor grava o registro de auditoria dentro da sua conta, o que nem sempre acontece. Teste assim:

  1. cPanel, Arquivos, Gerenciador de Arquivos.
  2. No menu Configurações, marque Mostrar arquivos ocultos (dotfiles). Sem isso você não vê .logs nem outras pastas iniciadas por ponto.
  3. Navegue até a pasta pessoal e procure por logs, .logs ou modsec_audit.log. Em algumas configurações o arquivo fica em ~/logs/modsec_audit.log; em outras, dentro de uma pasta com o nome do domínio.
  4. Se o arquivo for grande, não use Editar: use Baixar e abra no seu editor local. Abrir um arquivo de dezenas de megabytes no editor do navegador trava a aba.
  5. No editor local, busque pelo horário que você anotou (no fuso do servidor) e pelo seu IP público. Com o arquivo aberto, uma busca por id " já lista as regras que dispararam.

No registro de auditoria, o id vem na linha do cabeçalho H, dentro dos colchetes da diretiva, nesta forma (exemplo fictício):

Message: Access denied with code 403 (phase 2). Pattern match "..." at ARGS:content. [file "/etc/apache2/conf.d/modsec_vendor_configs/exemplo/regras.conf"] [line "812"] [id "999999"] [msg "Exemplo de mensagem da regra"] [severity "CRITICAL"]

O que você quer é só o conteúdo entre aspas depois de id: 999999. Logo acima, nas seções A e B do mesmo evento, estão o horário com fuso, o IP de origem, o método e a URI, que confirmam que é a sua tentativa e não a de outra pessoa.

Se a pasta não existir ou o arquivo não contiver nada do seu horário, pare de procurar: o registro de auditoria está no nível do servidor e só o provedor alcança.

Três causas para o log não mostrar nada, na ordem em que você deve testar

Três causas, nesta ordem: você procurou no minuto errado por causa do fuso; o registro consultado é o da conta e o bloqueio foi registrado só no registro do servidor, ao qual você não tem acesso; ou não foi o ModSecurity. Nesse terceiro caso, volte para a tabela de descartes. Abrir chamado dizendo "reproduzi às 14:22:31 do horário do servidor, IP 203.0.113.45, POST em /wp-admin/post.php, retorno 403, e não encontrei a entrada no registro da conta" elimina a ida e volta sobre o item dois, porque não sobra informação básica para o suporte pedir.

Desativar só aquele ID, só naquele domínio

Existe uma escala de intervenções, da mais cirúrgica para a mais destrutiva. Suba nela só quando a anterior não for possível.

Ação Alcance do risco Quem consegue aplicar e quando
Desativar o ID específico no domínio Uma regra, um site Root no WHM, ou o provedor a seu pedido. Primeira escolha sempre
Desativar o ID específico no servidor inteiro Uma regra, todos os sites Só root em servidor próprio, com a regra comprovadamente ruidosa
Desligar o ModSecurity para o domínio Todas as regras, um site Você, pelo cPanel, se o provedor permitir. Diagnóstico de minutos, nunca permanente
Desligar o ModSecurity na conta ou no servidor Todas as regras, tudo Não

A documentação do cPanel descreve a interface ModSecurity da conta como o lugar onde os domínios são listados e onde é possível ligar e desligar a proteção por domínio, quando o provedor permite essa configuração. Ou seja: pela interface de usuário, o controle é liga/desliga por domínio, não por regra. A desativação por ID fica do lado do WHM e depende de acesso root ao servidor.

O que isso significa na prática para quem cuida de sites de cliente em hospedagem compartilhada, e também para o revendedor sem root: você identifica o ID e pede ao provedor a desativação daquele ID para aquele domínio. Um chamado com ID, mensagem, URI, horário e IP reduz a ida e volta, porque não sobra informação para o suporte pedir antes de agir.

Se você administra o próprio servidor com root no WHM, faça a desativação por ali mesmo, pelo ID que apareceu no log, mantendo o restante do conjunto ativo.

Por que SecRuleRemoveById no .htaccess costuma derrubar o site com erro 500

É comum encontrar receita mandando colocar SecRuleRemoveById ou SecRuleEngine Off no .htaccess. Em boa parte dos servidores cPanel, diretivas do ModSecurity não são aceitas em .htaccess, e o resultado de colar a linha é erro 500 no site inteiro. Se for testar, faça com o cliente avisado, em horário de baixo movimento, e com a linha pronta para ser removida. Preferir o caminho do WHM ou do chamado evita transformar um post que não salva em site fora do ar.

Desligar o ModSecurity por trinta segundos prova a causa e não resolve

Se você precisa de certeza absoluta antes de abrir o chamado, desligue o ModSecurity para aquele domínio pela interface do cPanel, tente salvar, e ligue de novo em seguida. Isso prova a causa em trinta segundos. Deixar desligado é trocar um post que não salva por um site sem filtro de aplicação, e é exatamente o que o cliente vai lembrar quando algo der errado dali a seis meses.

Escala de intervenção, do cirúrgico ao destrutivoDesativar o ID no domínioUma regra, um site. Primeira escolhaDesativar o ID no servidorUma regra, todos os sites. Só rootDesligar ModSecurity no domínioTodas as regras, um site. MinutosDesligar na conta ou servidorNão faça
Escala de intervenções, da mais cirúrgica para a mais destrutiva. Suba um degrau só quando o anterior for impossível.

Revalidar o salvamento e confirmar que a proteção continua ligada

Depois da exceção aplicada, a revalidação tem três partes e nenhuma delas é opcional.

  1. Reproduza o caso de teste original. Cole de volta o trecho exato que você isolou na bisseção e salve. Tem que salvar. Se você guardou o "Copy as cURL", rode o comando e confira que o retorno é 200.
  2. Confira que não há acerto novo no log. Rode o grep filtrando pelo minuto da nova tentativa. Se aparecer outro ID, a requisição casava com mais de uma regra. Repita o procedimento para o novo ID.
  3. Confirme que o ModSecurity continua ativo no domínio. Na interface do cPanel, o domínio deve continuar marcado como ativo. Se alguém desligou durante o diagnóstico e esqueceu de religar, é agora que você descobre.

Vale também um teste de sanidade no fluxo do cliente final: salvar um post normal, enviar o formulário de contato, fazer um pedido de teste na loja. A exceção retirou uma regra, e você quer saber se retirou a certa.

Registrar a exceção com caso de teste e data de revisão

Exceção de WAF sem registro é dívida técnica invisível. Seis meses depois, ninguém lembra por que aquela regra está desativada, e ninguém tem coragem de religar. Mantenha um arquivo por cliente, versionado junto com a documentação do site.

## Exceções de ModSecurity - cliente Exemplo Ltda

### exemplo.com.br
- Regra: 999999 (ID de exemplo)
- Mensagem: "Exemplo de mensagem da regra"
- URI afetada: /wp-admin/post.php (ARGS:content)
- Sintoma relatado: "A atualização falhou" ao publicar post com trecho de código
- Data da reprodução: 2026-09-15 14:22:31 (horário do servidor)
- IP usado no teste: 203.0.113.45
- Ação: desativado o ID apenas para exemplo.com.br
- Quem aplicou: provedor, chamado #0000 / ou eu, com root no WHM
- Caso de teste salvo em: /docs/waf/caso-999999.txt
- ModSecurity segue ativo no domínio: sim
- Revisão prevista: 2026-12-15

O campo de revisão existe por um motivo: conjuntos de regras são atualizados pelos fornecedores, e a regra que gerava falso positivo pode ter sido corrigida. Na revisão, reative o ID, rode o caso de teste guardado e veja se ainda bloqueia. Se não bloquear mais, apague a exceção e o site volta com a proteção completa.

Padronizar o registro de exceções em toda a carteira de clientes

Como explicar ao cliente sem dizer que desligou o firewall

O cliente não quer saber de phase 2 nem de ARGS:content. Ele quer saber se o site está seguro e se vai acontecer de novo. Uma versão pronta, para e-mail ou WhatsApp:

Duas coisas que essa mensagem faz e que valem a pena preservar em qualquer reescrita sua: ela diz o que continua protegido (o cliente ouviu "desativamos" e precisa ouvir o limite disso na mesma frase) e ela dá data de revisão (mostra que a exceção é temporária e controlada, não uma gambiarra).

O que não dizer: "desliguei o firewall", mesmo que a intervenção tenha sido cirúrgica. A frase vira lembrança, e a lembrança vira acusação no primeiro incidente de segurança que aparecer, mesmo sem relação nenhuma.

Fonte: documentação do ModSecurity no cPanel

Referências

  1. Documentação oficial (cpanel) — ModSecurity (cPanel). Consultado em 2026-09-16.
Leia também