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.

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
- As três checagens que produzem a mesma mensagem
- Como identificar qual das três falhou em menos de dois minutos
- O que ajustar em cada caso, e só nesse caso
- Checklist de diagnóstico reutilizável
- Como padronizar isso em vários sites de uma vez
- Como explicar ao cliente que não houve invasão
- Quando o erro atinge todos os usuários ao mesmo tempo
- 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.
- 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.
- 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. - Token da URL. O endereço do painel carrega um segmento
cpsesspró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.
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):
- Cookie IP validation: aceita
Disabled,LooseeStrict.Strictexige o IP inteiro igual ao do login;Loosetolera variação dentro da mesma faixa;Disabledignora o IP. - Cookie IP validation for Webmail: mesma escala, aplicada só ao Webmail, e configurável em separado.
- Referer safety check e Blank referer safety check: a primeira rejeita requisição cujo
Refereraponta para outro host; a segunda rejeita requisição que chega semReferernenhum.
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.
- [ ] Pedir print com a barra de endereços visível (procure
cpsess). - [ ] Perguntar: rede de casa, escritório, VPN ou 4G.
- [ ] Pedir teste em janela anônima, sem extensões.
- [ ] Pedir teste em outra rede (celular com dados móveis).
- [ ] Verificar se o acesso usa sempre o mesmo hostname do painel.
- [ ] Confirmar que o relógio do computador do cliente está correto.
- [ ] Verificar se o erro afeta um usuário ou todos.
- [ ] Só então avaliar Tweak Settings, registrando qual opção foi alterada, por quem e por quê.
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:
- Um hostname único para o painel. Documente
https://painel.seudominio.com.br:2083(exemplo) e use sempre ele. Acesso pelo IP num dia e pelo domínio no outro gera inconsistência de origem. - Favoritos sem token. Ao entregar o acesso, mande o link da raiz do painel. Inclua uma linha no documento de entrega: "não salve o endereço que aparece depois do login, ele expira".
- Gerenciador de senhas no lugar de link salvo. O item do cofre guarda URL base, usuário e senha, e nunca captura o
cpsess.
Isso não depende do provedor e funciona igual em qualquer cPanel.
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:
- Proxy ou CDN na frente do painel reescrevendo cabeçalhos ou entregando o IP do proxy no lugar do IP real.
- Hora do servidor fora de sincronia, o que encurta ou invalida sessões.
- Certificado do hostname do painel vencido, o que faz o navegador exibir o aviso de conexão não privada antes da tela de login e, em alguns navegadores, bloquear o acesso até o usuário insistir. O cookie
Securecontinua sendo aceito depois que ele prossegue, o problema é o fluxo de login interrompido e o endereço que muda quando o cliente tenta contornar o aviso por outro host. - Sessões derrubadas por reinício de serviço, caso em que o próprio novo login resolve.
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
- Documentação oficial (cpanel) — Tweak Settings: Security (WHM). Consultado em 2026-10-26.