blog
Painéis

Token de segurança inválido no cPanel: as 3 causas

Como descobrir qual das três proteções do cPanel barrou a requisição, o que ajustar em cada caso e como explicar ao cliente que ninguém invadiu a conta.

JR · · 7 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: a mensagem vem de três checagens distintas do cPanel: o cookie de sessão amarrado ao IP, a validação de referrer/origem e o token `cpsess` da URL, que expira. Descubra qual falhou antes de mexer em Tweak Settings, porque desligar a validação inteira afeta todas as contas do servidor.

Neste artigo
  1. As três checagens que produzem a mesma mensagem
  2. Como identificar qual das três falhou em menos de dois minutos
  3. O que ajustar em cada caso, e só nesse caso
  4. Checklist de diagnóstico reutilizável
  5. Como padronizar isso em vários sites de uma vez
  6. Como explicar ao cliente que não houve invasão
  7. Quando o erro atinge todos os usuários ao mesmo tempo
  8. O que este artigo não mediu

As três checagens que produzem a mesma mensagem

Quando o cliente manda print de "token de segurança inválido" ou "a origem da requisição não é confiável", o cPanel está rejeitando a requisição em uma de três camadas independentes. Elas falham com textos parecidos, mas a causa e a correção são diferentes.

  1. Validação de IP do cookie de sessão. O cPanel amarra a sessão ao IP que fez o login. Se o IP da requisição seguinte for outro, a sessão é invalidada e o usuário volta para a tela de login ou recebe erro de token.
  2. Checagem de referrer/origem. O painel compara o cabeçalho Referer (e a origem) da requisição com o host do próprio painel. É a proteção contra CSRF: um formulário hospedado em outro domínio não pode disparar ação no cPanel do cliente.
  3. Token da URL. O endereço do painel carrega um segmento cpsess próprio daquela sessão. Quando a sessão expira ou é derrubada, esse token morre junto e qualquer link salvo com ele passa a dar erro.

Os três comportamentos são controlados em WHM > Server Configuration > Tweak Settings > aba Security, conforme a documentação oficial do cPanel. O conselho que circula em fórum ("desliga a validação") trata as três como se fossem uma só e aplica a mudança para todas as contas do servidor. É isso que você não deve fazer.

Como identificar qual das três falhou em menos de dois minutos

A mensagem na tela raramente diz a camada. O contexto diz.

Sintoma relatado pelo cliente Camada provável Pista que confirma
Entra, navega, e ao salvar um formulário cai para o login IP do cookie de sessão IP do cliente muda entre requisições (proxy corporativo, VPN, 4G/Wi-Fi alternando)
Erro aparece só quando ele usa o tradutor do Chrome ou um "modo leitura" Referrer/origem Desligar a tradução da página faz o erro sumir
Erro imediato ao abrir, antes de qualquer clique Token da URL expirado A URL tem um trecho cpsess colado no meio
Erro só em um computador, só naquela rede IP ou referrer Mesmo login funciona pelo celular em 4G
Erro para todos os usuários do servidor, ao mesmo tempo Nenhuma das três Olhe horário do servidor, certificado e proxy/CDN na frente do painel

Três perguntas resolvem a triagem: de onde ele acessa, como ele chegou na tela, e o endereço tem cpsess?

De onde o cliente acessa, e se o IP muda entre requisições

Peça o IP público em dois momentos, com cinco minutos de diferença. Se mudar, é a camada de IP.

# no computador do cliente (ou peça para abrir um site de "qual é meu IP")
curl -s https://ifconfig.me; echo

Saída com dois valores diferentes nas duas execuções significa saída NAT rotativa: típico de operadora móvel, VPN corporativa com múltiplos gateways e proxy de empresa.

Como ele chegou na tela: tradutor, extensão e o cabeçalho Referer

Tradutor de página, extensão que reescreve o DOM e alguns antivírus com "proteção de navegação" alteram ou removem o cabeçalho Referer. Peça para repetir em janela anônima, sem extensões. Se funcionar, é referrer.

O favorito tem `cpsess` no meio do endereço

Se o favorito do cliente aponta para algo como https://servidor.exemplo:2083/cpsess1234567890/frontend/..., o link está morto por definição. O favorito correto é a raiz do painel, sem o segmento de sessão.

Triagem do token inválido em quatro perguntasBarra de endereços tem cpsess?Sim: favorito morto, troque o linkIP muda entre requisições?Sim: camada de IP da sessãoFunciona em janela anônima?Sim: extensão ou tradutor alterou RefererFalha para todos ao mesmo tempo?Olhe proxy, relógio e certificadoNada disso explicouSó então avaliar Tweak Settings
Ordem de triagem: cada pergunta elimina uma das camadas antes de mexer no servidor.

O que ajustar em cada caso, e só nesse caso

Na aba Security do Tweak Settings, três opções respondem por esses casos (confira o nome exato na sua versão, ele varia entre releases):

A lógica de decisão:

Caso real Ajuste proporcional O que você NÃO deve fazer
Cliente atrás de proxy corporativo com IP de saída variável Baixar Cookie IP validation de Strict para Loose, mantendo Referer safety check e Blank referer safety check ligados Desligar a checagem de referrer "para garantir"
Tradutor do Chrome ou extensão apagando o Referer Orientar o uso sem tradução; só desligue Blank referer safety check se não houver alternativa, deixando Referer safety check ligado Desligar a validação de referrer por completo no servidor
Favorito antigo com cpsess Nenhum ajuste de servidor. Troque o favorito Mexer em Tweak Settings por causa de um link ruim
Acesso por domínio diferente do que hospeda o painel Padronizar um único hostname de acesso ao painel Criar exceção permanente de origem

Afrouxar a validação de IP tem custo conhecido: um cookie de sessão roubado passa a ser utilizável de outra rede. Afrouxar o referrer tem custo maior, porque reabre a porta para CSRF, que é exatamente o ataque que a checagem existe para barrar. Entre as duas, a de IP é a que eu afrouxaria primeiro, e a de referrer é a última.

E o óbvio que economiza discussão: se o cliente acessa de um lugar só e o problema é o favorito, a correção é no favorito, não no servidor. Tweak Settings vale para o servidor inteiro, inclusive para contas que não têm problema nenhum.

Checklist de diagnóstico reutilizável

Salve isso como template de resposta na sua ferramenta de chamados.

O último item é o que diferencia manutenção de gambiarra. Ajuste de segurança sem registro vira dívida: seis meses depois ninguém lembra por que a validação está frouxa, e ninguém se atreve a religar.

Como padronizar isso em vários sites de uma vez

Quem cuida de dez a cem sites não quer repetir esse diagnóstico toda semana. Três padronizações cortam a maioria dos chamados desse tipo:

Isso não depende do provedor e funciona igual em qualquer cPanel.

Padronização de acesso ao painel em vários sitesHostname únicoUm só endereço de painel documentadoLink da raizEntregue sem o trecho cpsessCofre de senhasURL base, usuário e senhaRegistro de ajustesO que mudou, por quem, por quê
Padronização de entrega de acesso aplicável a qualquer cPanel, independente do provedor.

Como explicar ao cliente que não houve invasão

O cliente lê "token de segurança inválido" e pensa em invasão. Responda antes que ele ligue:

Ajuste a última frase conforme o caso. Se foi favorito antigo, diga isso explicitamente: cliente que entende a causa não abre o mesmo chamado de novo.

Quando o erro atinge todos os usuários ao mesmo tempo

Se o erro atinge todos os usuários ao mesmo tempo, pare de olhar para o navegador do cliente. Candidatos, em ordem de facilidade de verificação:

Colocar CDN na frente da porta do painel costuma gerar mais problema do que ganho. O painel não precisa de cache nem de borda. Deixe o acesso administrativo direto no hostname do servidor.

O que este artigo não mediu

Aqui não há medição própria. O conteúdo descreve o comportamento documentado das opções de segurança do Tweak Settings do cPanel, conforme a documentação oficial, mais a rotina de triagem que decorre dele. Nomes exatos e valores disponíveis de cada opção mudam entre versões do cPanel: confira na aba Security da sua instalação antes de alterar qualquer coisa, e confirme o nome da opção na documentação da versão que você opera.

Também não medi quanto cada ajuste muda o risco real de CSRF ou de sequestro de sessão. O raciocínio de proporcionalidade aqui é de superfície de ataque, não de incidência observada: afrouxar para um caso específico expõe menos que afrouxar para o servidor inteiro, e essa é a única afirmação que o texto sustenta.

Referências

  1. Documentação oficial (cpanel) — Tweak Settings: Security (WHM). Consultado em 2026-10-26.
Leia também