# Bloquear força bruta em wp-login e xmlrpc antes do PHP

Um procedimento de carteira para contar a linha de base no access log, escolher a trava certa por cliente e validar sem se trancar do lado de fora.

> A linha de base é o pico de requisições por minuto em /wp-login.php e /xmlrpc.php no access log do próprio site, não um número universal de blog. Conte antes, aplique a trava no .htaccess acima do bloco # BEGIN WordPress, teste a saída de outra rede em aba anônima e reconte 15 minutos depois.

João Rizzon · 2026-09-25 · WordPress

---

## O número que importa está no seu log

Não temos medição própria para esta pauta. Não rodamos um laboratório contando tentativas de login em sites de terceiros, e qualquer número redondo que alguém publique sobre "quantas tentativas de força bruta seu WordPress recebe" é chute ou é a média de outra pessoa. O número que vale para decidir alguma coisa é o pico de requisições por minuto que aparece no access log do site que você está olhando agora.

É uma boa notícia para quem cuida de carteira. Esse número é barato de obter, dá para pegar em três comandos, e serve para duas coisas ao mesmo tempo: dimensionar se o problema é real naquele site e provar ao cliente, depois, que a trava funcionou. Sem linha de base, você entrega "protegi seu site" e o cliente ouve "você mexeu no meu site".

O procedimento abaixo é o mesmo para 1 ou 40 sites: conta, tranca, testa a saída, reconta. O que muda de cliente para cliente é só qual trava entra, e isso depende de o site usar ou não Jetpack, app móvel e editores remotos.

## Como medir a linha de base no access log

### Onde o cPanel guarda o access log

Em cPanel, o log bruto do domínio costuma estar em `~/logs/` ou em `/usr/local/apache/domlogs/`, e os arquivos rotacionados vêm em `.gz`. Se você não tem SSH na conta, baixe pelo **Raw Access Logs** do cPanel e rode os comandos na sua máquina. O formato é o combined log: primeiro campo é o IP, quarto campo é a data entre colchetes.

Um aviso antes dos comandos: se o site está atrás de CDN ou proxy, o primeiro campo pode ser o IP do proxy, não o do visitante. Confira uma linha inteira antes de confiar no ranking de IPs.

### Contar o pico de requisições por minuto

Este comando agrupa por minuto e mostra os minutos mais movimentados. O que ele mede é exatamente isso: quantas linhas de log com `wp-login.php` ou `xmlrpc.php` caíram em cada minuto do arquivo.

```
grep -E 'wp-login\.php|xmlrpc\.php' access.log \
  | awk '{print substr($4,2,17)}' \
  | sort | uniq -c | sort -rn | head -10
```

Saída de exemplo, ilustrativa, não é dado medido por nós:

```
    412 24/Sep/2026:03:17
    398 24/Sep/2026:03:18
     51 24/Sep/2026:11:04
      3 24/Sep/2026:14:22
```

Para log compactado, troque `grep` por `zgrep` e `access.log` por `access.log.*.gz`.

### Descobrir quais IPs estão batendo

```
grep -E 'wp-login\.php|xmlrpc\.php' access.log \
  | awk '{print $1}' \
  | sort | uniq -c | sort -rn | head -20
```

E a separação por alvo, que decide se vale desligar o XML-RPC:

```
grep -c 'POST /wp-login.php' access.log
grep -c 'xmlrpc.php' access.log
```

### Os três valores que você anota por site

Anote três valores por site: pico por minuto, total de POST em `/wp-login.php` no período do arquivo e total em `/xmlrpc.php`. Guarde numa planilha com a data. Essa é a linha de base, e ela é individual: um site institucional com dois editores e um e-commerce com trinta contas de autor não têm a mesma normalidade.

Se `xmlrpc.php` aparecer com volume e o cliente não usa Jetpack nem o app móvel do WordPress, você já tem a decisão mais fácil do dia.

## Qual trava serve para qual cliente

Todas as opções abaixo, com exceção do plugin, respondem antes de o PHP subir. É essa a diferença que interessa: uma tentativa barrada no servidor web não carrega o WordPress, não abre conexão com o banco e não consome worker de PHP.

| Trava | Onde responde | Custo real para o cliente | Quando usar |
|---|---|---|---||
| Negar `xmlrpc.php` inteiro | Servidor web (`.htaccess`) | Quebra Jetpack, app móvel antigo, pingback e alguns plugins de publicação remota | Site institucional sem Jetpack e sem app móvel |
| Senha de diretório em `wp-login.php` (HTTP auth) | Servidor web, antes do PHP | Todo mundo que loga passa a digitar duas senhas; recuperação de senha por link também cai na trava | Painel usado por poucas pessoas, ou por você e mais ninguém |
| Allowlist de IP em `wp-login.php` | Servidor web | Trava editor remoto, cliente em casa, link móvel; só funciona com IP fixo de verdade | Agência com IP fixo e cliente que não acessa o painel |
| Proteção de força bruta do LiteSpeed (wp-protect) | Servidor web, no nível do servidor | Nenhum para o uso normal; é limite por IP, não bloqueio de URL | Sempre que estiver disponível, como camada de fundo |
| Plugin de limite de tentativas | PHP, depois de carregar o WordPress | Nenhum para o usuário, mas o PHP já subiu para responder | Complemento, nunca a única camada |

### O que a proteção de força bruta do LiteSpeed cobre

A LiteSpeed documenta uma proteção de força bruta para WordPress no plugin de cPanel/WHM, a [WordPress Brute Force Protection](https://docs.litespeedtech.com/lsws/cp/cpanel/wp-protect/). Ela é aplicada no nível do servidor web e a habilitação é do administrador do servidor, não do usuário do cPanel. Se você é revendedor ou está em compartilhado, a pergunta certa para o suporte é se o wp-protect está ativo na máquina e qual o limiar configurado. O parâmetro exato e as opções de exceção estão na própria documentação, e é dela que você deve tirar o valor vigente, não de um blog.

Essa camada não substitui as travas de `.htaccess`. Ela limita tentativas por IP; a senha de diretório e o bloqueio do XML-RPC eliminam a classe inteira de requisição. São complementares.

### Por que o plugin de limite de tentativas não basta

Um plugin de limite de tentativas precisa que o WordPress carregue para decidir bloquear. Com centenas de POST por minuto na mesma URL, você está pagando bootstrap de WordPress para cada uma delas. O plugin continua útil (ele registra usuário tentado, bloqueia por conta, manda alerta), mas a fila de PHP agradece quando a maior parte do ruído morre no servidor web.

## Antilockout: abrir a saída antes de fechar a porta

Esta é a etapa que as pessoas pulam e depois passam a noite resolvendo. Faça na ordem. O bloco de `.htaccess` mencionado no passo 4 é o da seção seguinte, **O bloco padrão da agência**: leia-o antes de começar e escolha a variante que serve para aquele cliente.

### Deixe o File Manager aberto numa aba

Antes de editar o `.htaccess`, abra o **File Manager** do cPanel numa aba, já navegado até `public_html`. Se a regra prender você do lado de fora, é por ali que você desfaz, sem depender de SSH e sem depender de login no WordPress. Se você só tem acesso por SFTP, deixe a sessão aberta e testada.

### Salve uma cópia do .htaccess original

```
cp public_html/.htaccess public_html/.htaccess.bak-$(date +%F)
```

Restaurar é copiar de volta. Em carteira, essa convenção de nome vale ouro seis meses depois, quando alguém pergunta o que mudou e quando.

### Combine o plano B com quem vai logar

Se o cliente loga no painel, mande a credencial da senha de diretório antes de aplicar, não depois. A frase que evita o ticket: "a partir de hoje o navegador vai pedir uma senha antes da tela de login do WordPress, é esta aqui, e é normal".

### Aplique o bloco acima de # BEGIN WordPress

Cole o bloco da próxima seção no `.htaccess` do `public_html`, acima de `# BEGIN WordPress`, com o `AuthUserFile` e o IP já ajustados para aquele site. Salve e confira que o site público continua abrindo. A partir daqui a regra está no ar.

### Teste de outra rede, em aba anônima

Abra `https://dominio.com.br/wp-login.php` numa janela anônima e, de preferência, no 4G do celular, fora do Wi-Fi do escritório. Aba anônima porque o navegador guarda credencial de HTTP auth; outra rede porque, se você criou allowlist de IP, o teste feito do seu IP não prova nada.

Só depois que esse teste passar você fecha a sessão de painel ou SSH onde estava trabalhando.

## O bloco padrão da agência

O bloco abaixo vai no `.htaccess` do `public_html`, **acima** do bloco `# BEGIN WordPress`. O WordPress reescreve a parte dele; o que está fora não é tocado por atualização do core. LiteSpeed interpreta diretivas de `.htaccess` do Apache, então o mesmo bloco serve nos dois servidores.

```apache
# --- Trava de acesso administrativo (padrao agencia) ---

# 1. XML-RPC desligado. Remova este bloco se o cliente usar
#    Jetpack, app movel ou publicacao remota.
<Files "xmlrpc.php">
    Require all denied
</Files>

# 2. wp-login.php atras de HTTP auth, com excecao por IP fixo.
<Files "wp-login.php">
    AuthType Basic
    AuthName "Area restrita"
    AuthUserFile "/home/USUARIO/.htpasswds/public_html/trava/passwd"
    <RequireAny>
        Require ip 203.0.113.7
        Require valid-user
    </RequireAny>
</Files>

# --- fim da trava ---
```

Três observações sobre esse bloco, todas práticas:

- O `AuthUserFile` precisa de um arquivo de senha que exista. O caminho mais rápido em cPanel é criar uma pasta qualquer (`trava`, por exemplo), aplicar **Directory Privacy** nela com um usuário e senha, e depois copiar o caminho exato do `AuthUserFile` que o cPanel gravou no `.htaccess` daquela pasta. Cole esse caminho aqui. Nunca aplique Directory Privacy direto no `public_html`: isso põe senha no site inteiro, inclusive para visitante e para o Google.
- `203.0.113.7` é IP de exemplo, da faixa reservada para documentação. Troque pelo IP fixo da agência ou apague a linha inteira. Em Apache 2.4, as duas diretivas dentro de `<RequireAny>` funcionam como "ou": quem vem do IP entra direto, os demais são desafiados pela senha.
- Se o site tem login de cliente final para área de membros e essa área usa `wp-login.php`, esse bloco não serve. Nesse caso, fique com o limite por IP no servidor e com o plugin, e trave só o `xmlrpc.php`.

### Variante para site com Jetpack ou app móvel

Remova o bloco do `xmlrpc.php` e mantenha apenas a trava do `wp-login.php`. Não tente montar allowlist de IP do Jetpack à mão: a lista muda e você vai descobrir isso quando a sincronização quebrar num sábado.

## Recontar e validar o que pode ter quebrado

Espere 15 minutos com a regra no ar. A validação tem dois passos, e eles medem coisas diferentes: primeiro a distribuição de código de status, que diz se a regra está mesmo pegando; depois o pico por minuto, que é o número que vai para a planilha e para o cliente.

### Ver se a regra está pegando pelo código de status

```
tail -5000 access.log \
  | grep -E 'wp-login\.php|xmlrpc\.php' \
  | awk '{print $9}' \
  | sort | uniq -c | sort -rn
```

O campo `$9` no combined log é o código de status. Depois da trava, as tentativas anônimas aparecem como `401` (HTTP auth pedindo credencial) ou `403` (negado), em vez de `200` com o HTML da tela de login. Saída de exemplo, ilustrativa:

```
    287 401
     14 403
      2 200
```

Esse é o sinal de que a requisição está morrendo antes do PHP. Se continuar aparecendo `200` em volume, a regra não está sendo aplicada, e o suspeito número um é o bloco ter caído dentro da área `# BEGIN WordPress`.

### Comparar o pico por minuto com a linha de base

Cuidado com uma expectativa errada aqui: o pico total de requisições por minuto não cai no primeiro quarto de hora. O bot continua batendo, só que agora recebe 401. O que cai na hora é o número de requisições que chegam a carregar o WordPress. Então compare duas séries.

A primeira é o pico por minuto considerando só as respostas `200`, ou seja, o que ainda chega ao PHP. Este é o número que deve desabar imediatamente:

```
grep -E 'wp-login\.php|xmlrpc\.php' access.log \
  | awk '$9==200 {print substr($4,2,17)}' \
  | sort | uniq -c | sort -rn | head -10
```

A segunda é o pico por minuto total, o mesmo comando da linha de base, recortado para o período posterior à mudança (troque o padrão pela hora em que você aplicou):

```
grep -E 'wp-login\.php|xmlrpc\.php' access.log \
  | grep '24/Sep/2026:15:' \
  | awk '{print substr($4,2,17)}' \
  | sort | uniq -c | sort -rn | head -10
```

Esse segundo número costuma cair em dias, não em minutos, conforme os IPs desistem. Rode de novo no dia seguinte e uma semana depois, e anote as três datas na planilha. É a série que faz sentido mostrar ao cliente.

### O que checar antes de dar a tarefa por encerrada

| Checagem | Como validar | Se falhar |
|---|---|---||
| Site público | Abra a home e uma página interna em aba anônima | Regra escapou do `<Files>`, revise o bloco |
| Login do painel | Aba anônima, outra rede, senha de diretório e depois a do WP | Restaure o `.bak` pelo File Manager |
| Editor de blocos | Edite e salve um post; veja se o autosave responde | Editor usa `/wp-json`, não `wp-login.php`; se falhou, o problema é outro |
| WP-Cron | Site Health, teste de requisição em loopback | `wp-cron.php` não é tocado pelo bloco; falha aqui costuma ser anterior |
| App oficial / Jetpack | Abra o app e sincronize | Você bloqueou `xmlrpc.php` num site que precisa dele; remova o bloco |
| Recuperação de senha | Peça o link de redefinição e clique | O link cai em `wp-login.php` e vai pedir a senha de diretório; é esperado, avise o cliente |

Uma coisa que costuma assustar sem motivo: o editor de blocos e a API REST conversam por `/wp-json/`, e o bloco acima não mexe nessa rota. Bloquear `xmlrpc.php` não desliga a API REST, são coisas diferentes.

## Padronizar na carteira e explicar ao cliente

Para quem mantém dezenas de sites, o ganho está em transformar isso em item de checklist, não em heroísmo pontual.

- Levante a linha de base de todos os sites com o mesmo comando e jogue numa planilha: domínio, data, pico por minuto, POST em `wp-login.php`, hits em `xmlrpc.php`.
- Classifique cada site em três colunas: usa Jetpack ou app (sim/não), tem login de cliente final (sim/não), a agência tem IP fixo (sim/não). Essas três respostas escolhem a variante do bloco sozinhas.
- Aplique primeiro nos dois ou três sites com maior pico, valide, e só então replique. Aplicar em 40 de uma vez multiplica o erro por 40.
- Versione o bloco num arquivo interno com data. Quando um site der problema, você quer saber qual versão do bloco ele recebeu.
- Reveja a planilha a cada trimestre. Linha de base velha não serve para provar melhora nenhuma.

### A frase para mandar ao cliente

"Passamos a barrar no servidor as tentativas automáticas de login que estavam batendo no seu site: nada mudou para quem visita as páginas, o site só deixou de gastar processamento respondendo a esses acessos, e o acesso ao painel agora pede uma senha adicional antes da tela de login."

Se o cliente pedir números, mostre os dois valores da planilha, o de antes e o de depois, e diga de onde vieram: do log do servidor dele, no período X. É o único número honesto que existe nessa conversa.

### O que esta trava não resolve

Senha de diretório e bloqueio de `xmlrpc.php` reduzem ruído automatizado. Não resolvem credencial vazada, plugin desatualizado com falha conhecida nem usuário `admin` com senha fraca. Se a tentativa que preocupa vem de um IP só, com poucas requisições e acertando o nome de usuário certo, o problema é outro e a resposta também: rotação de senha, revisão de usuários com papel de administrador e atualização do que estiver pendente. A trava no servidor web limpa a paisagem para você enxergar esse caso, e é mais ou menos esse o serviço que ela presta.

**Fonte consultada:** documentação oficial da LiteSpeed, [WordPress Brute Force Protection (wp-protect)](https://docs.litespeedtech.com/lsws/cp/cpanel/wp-protect/), consultada em 24/09/2026. Todos os trechos de log e o IP `203.0.113.7` são exemplos ilustrativos, não medições nossas.

