# 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.

> 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.

João Rizzon · 2026-10-27 · Painéis

---

## 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 `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](https://docs.cpanel.net/whm/server-configuration/tweak-settings/security/136/). 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.

```bash
# 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`, `Loose` e `Strict`. `Strict` exige o IP inteiro igual ao do login; `Loose` tolera variação dentro da mesma faixa; `Disabled` ignora 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 `Referer` aponta para outro host; a segunda rejeita requisição que chega sem `Referer` nenhum.

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:

> **** "Não houve invasão e nenhum dado foi acessado. O painel tem uma proteção que confere se a tela aberta no seu navegador é a mesma sessão que fez o login. Quando a sessão expira, quando a rede troca de IP no meio do acesso ou quando o link salvo é antigo, essa conferência falha e o painel bloqueia a ação, por precaução. Já identifiquei qual das situações foi a sua e corrigi. Use este endereço para entrar: [link da raiz do painel]."

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 `Secure` continua 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](https://docs.cpanel.net/whm/server-configuration/tweak-settings/security/136/), 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.

