blog
Painéis

Cliente bloqueado no cPanel mesmo em outra rede: o cPHulk por usuário

O cPHulk conta falhas por conta e por endereço de forma independente. Veja como identificar qual travou, liberar o usuário, calibrar os limites e receber aviso antes do cliente ligar.

JR · · 8 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: o cPHulk mantém 2 contadores separados: um por IP e outro por nome de usuário. Quando a proteção por usuário vale para qualquer origem, a conta que estoura o limite fica bloqueada para qualquer endereço, então trocar de rede não ajuda.

Neste artigo
  1. Dois contadores, duas chaves diferentes
  2. Por que trocar de rede não libera a conta
  3. Diagnóstico rápido: qual contador travou
  4. Como liberar a conta bloqueada
  5. Ajustar as tentativas de cada contador
  6. Cadastrar o aviso de bloqueio
  7. Padronizar em vários servidores e explicar ao cliente

Dois contadores, duas chaves diferentes

O cPHulk, a proteção contra força bruta do cPanel & WHM, não tem um bloqueio só. A documentação oficial separa a configuração em blocos distintos na aba Configuration Settings: Username-based Protection (proteção por nome de usuário) e IP Address-based Protection (proteção por endereço IP). Cada bloco tem a própria janela de tempo e o próprio limite de falhas.

Na prática, isso significa que o servidor conta falhas de login de duas formas ao mesmo tempo:

Contador O que ele acompanha O que acontece ao estourar o limite Trocar de rede resolve
Por nome de usuário Falhas de login de uma conta, venham de onde vierem A conta fica bloqueada durante o período configurado Não
Por IP Falhas de login vindas de um mesmo endereço O endereço fica bloqueado durante o período configurado Sim, enquanto o novo IP não acumular falhas

Quem já resolveu um bloqueio de IP pedindo para o cliente desligar o Wi-Fi e usar o 4G costuma assumir que o problema é sempre esse. Não é. Quando o contador estourado é o de usuário, a chave do bloqueio é o nome da conta, e o endereço de origem deixa de importar.

Dois contadores, duas chavesContador por nome de usuárioContador por IP
Os dois contadores do cPHulk são independentes. Trocar de rede só ajuda quando o bloqueio é por IP.

Por que trocar de rede não libera a conta

O contador por nome de usuário existe justamente para o ataque distribuído: um atacante que tenta a mesma conta a partir de centenas de IPs nunca estouraria o limite por IP, mas estoura o limite da conta. Para isso funcionar, o bloqueio precisa valer para a conta inteira, independentemente da origem.

Esse comportamento depende de uma opção do bloco Username-based Protection: Apply protection to local addresses only. Segundo a documentação, ela restringe a proteção por usuário a tentativas vindas de endereços locais. Se estiver ativa no seu servidor, o cenário descrito a seguir não se aplica da mesma forma. Confira o estado dela antes de concluir que o bloqueio é por conta.

O efeito colateral aparece com o cliente legítimo. Ele erra a senha algumas vezes no escritório, o celular com senha antiga tenta autenticar o e-mail em segundo plano, o contador da conta sobe, e o bloqueio entra. A partir daí:

A saída é esperar o período configurado expirar ou um administrador do servidor liberar a conta manualmente.

Um detalhe que poupa tempo: o cPHulk é configurado no WHM, com acesso root. Se o site do cliente está em hospedagem compartilhada ou revenda, você não tem esse acesso. O caminho é abrir chamado no provedor informando o nome de usuário bloqueado, e não só o IP. Informar só o IP leva o suporte a liberar o endereço, e o cliente continua travado.

Ciclo do bloqueio por usuárioFalhas de senha antiga em vários aparelhosConta bloqueada por nome de usuárioTrocar de rede não liberaAtualizar senha e liberar a conta
Sem corrigir o aparelho com senha antiga, o bloqueio volta.

Diagnóstico rápido: qual contador travou

Antes de liberar qualquer coisa, descubra qual dos dois bloqueios está ativo. A documentação descreve a aba History Reports do cPHulk, onde o administrador escolhe o tipo de relatório: falhas de login por usuário, usuários bloqueados, IPs bloqueados e IPs bloqueados por um dia, entre outros.

Roteiro que funciona bem em atendimento:

  1. Pergunte ao cliente se o erro persiste em outra rede (dados móveis, por exemplo). Se persiste, a suspeita principal é o bloqueio por usuário. Confirme em Configuration Settings se a opção Apply protection to local addresses only está desativada, condição em que o bloqueio por usuário vale para qualquer origem.
  2. No WHM, abra Security Center » cPHulk Brute Force Protection » History Reports e consulte o relatório de usuários bloqueados.
  3. Procure o nome da conta. Lembre que o usuário pode ser o do cPanel ou um endereço de e-mail completo, conforme o serviço em que o login falhou.
  4. Consulte também o relatório de IPs bloqueados. Os dois bloqueios podem estar ativos juntos.
  5. Veja o relatório de falhas de login para identificar o serviço e o horário. Uma sequência regular de falhas, em intervalos parecidos, costuma ser um dispositivo com senha antiga, não uma pessoa.

O último item (relatório de falhas de login) é o que mais evita retrabalho. Se a origem é um celular ou um cliente de e-mail configurado com a senha antiga, liberar a conta sem corrigir o dispositivo só reinicia a contagem, e o bloqueio volta.

Como liberar a conta bloqueada

Corrija a origem das falhas antes de liberar

Antes de liberar, peça ao cliente para atualizar a senha em todos os dispositivos que acessam aquela conta (celular, notebook, Outlook, aplicativo de e-mail) ou desligar temporariamente os que não consegue atualizar. Se a senha foi trocada recentemente, esse é quase sempre o culpado.

Remova o bloqueio no History Reports

Na aba History Reports, selecione o relatório de usuários bloqueados e remova a entrada da conta. Faça o mesmo no relatório de IPs bloqueados se o endereço do cliente também aparecer lá. Os nomes exatos dos botões variam entre versões do WHM, então confira a página oficial da versão do seu servidor.

Valide o acesso com um único login

Peça ao cliente para fazer um único login, com a senha correta digitada manualmente. Se falhar de novo, volte ao relatório antes de qualquer nova tentativa e veja se a conta reapareceu.

Avalie a lista de permissões com cuidado

O cPHulk tem listas de permissão e de bloqueio (Whitelist Management e Blacklist Management). Incluir o IP fixo do escritório do cliente na lista de permissões evita que aquele endereço seja bloqueado, mas não substitui o passo 1. E não faça isso com IP dinâmico de operadora: amanhã o endereço pode ser de outra pessoa.

Ajustar as tentativas de cada contador

Na aba Configuration Settings, cada bloco tem seus parâmetros. Os principais, segundo a documentação:

Bloco Parâmetro Efeito
Username-based Protection Brute Force Protection Period (minutos) Janela em que as falhas da conta são somadas e duração do bloqueio
Username-based Protection Maximum Failures by Account Falhas permitidas por conta dentro da janela
IP Address-based Protection IP Address-based Brute Force Protection Period (minutos) Período de proteção por IP: janela e duração do bloqueio do endereço
IP Address-based Protection Maximum Failures per IP Address Falhas permitidas por IP dentro da janela
IP Address-based Protection Maximum Failures per IP Address before the IP Address is Blocked for One Day Máximo de falhas antes do bloqueio de um dia: limite que leva o IP ao bloqueio de 24 horas

Os valores padrão mudam entre versões, então leia os do seu servidor antes de alterar. Algumas orientações para decidir:

Exemplo ilustrativo, não parâmetro documentado: uma agência que gerencia um servidor só de sites institucionais pode decidir dobrar o limite de falhas por conta e manter a janela, observando o relatório de bloqueios por duas semanas antes de mexer de novo.

Cadastrar o aviso de bloqueio

Descobrir o bloqueio pela ligação do cliente é o pior cenário. O cPHulk pode notificar quando detecta um usuário em força bruta. A documentação lista as opções de notificação na própria aba Configuration Settings, e o destino dos avisos é definido no WHM em Server Contacts » Contact Manager, na categoria do cPHulk.

Procedimento:

  1. Em Configuration Settings, ative a notificação para quando o sistema detectar um usuário em força bruta.
  2. Em Contact Manager, confirme que o e-mail de contato do servidor é uma caixa que alguém lê, de preferência fora do próprio servidor.
  3. Ajuste o nível de importância para que o aviso do cPHulk seja de fato enviado.
  4. Provoque um teste controlado com uma conta de teste (exemplo: [email protected], criada só para isso) e confirme que o aviso chega. Faça as tentativas a partir de uma origem que não seja a do seu acesso administrativo (um celular em dados móveis, por exemplo) ou com o IP do administrador na Whitelist. Errar a senha várias vezes do mesmo IP que você usa no WHM também alimenta o contador por IP e pode bloquear o seu próprio acesso.
  5. Depois do teste, abra History Reports, confirme que a conta de teste e o IP usado aparecem nos relatórios de bloqueio, remova as duas entradas e apague a conta de teste.

Com o aviso ativo, você costuma saber do bloqueio antes do cliente e pode ligar para ele já com a causa provável.

Padronizar em vários servidores e explicar ao cliente

Para quem administra mais de um servidor, vale manter uma ficha por servidor com: valores atuais dos dois contadores, IPs fixos na lista de permissões (com o nome do cliente dono de cada um), destino das notificações e data da última revisão. Revisar a lista de permissões a cada trimestre evita IP de cliente antigo liberado para sempre.

A explicação ao cliente precisa ser curta e tirar a ideia de que "a internet dele" é o problema. Uma versão pronta:

O servidor bloqueou temporariamente a sua conta, não a sua internet,
porque registrou várias tentativas de login com senha errada. Por isso
trocar de rede não resolveu. Já liberamos a conta. Para não acontecer
de novo, atualize a senha em todos os aparelhos que acessam esse e-mail,
principalmente o celular.

E no chamado ao provedor, quando você não tem WHM:

Conta bloqueada pelo cPHulk por nome de usuário (persiste em outras redes).
Usuário: [conta ou e-mail completo]
IP de origem, se souber: [IP]
Já corrigimos o dispositivo com senha antiga. Favor remover o bloqueio
da conta e, se houver, do IP.

O ponto central para guardar: bloqueio que sobrevive à troca de rede é bloqueio de conta. Liberar só o IP não resolve, e liberar a conta sem corrigir o aparelho com senha antiga só adia o próximo chamado.

Referências

  1. Documentação oficial (cpanel) — cPHulk Brute Force Protection. Consultado em 2026-11-15.
Leia também