# Ativar 2FA no WHM da revenda sem se trancar fora

O que a documentação do cPanel descreve, mais o roteiro de recuperação, a troca de celular sem travar o painel e o aviso pronto para o cliente.

> a ativação do 2FA no WHM tem 4 etapas na ordem segura: habilitar o recurso e configurar a sua própria conta, testar o login em outra sessão, só então exigir o segundo fator dos demais usuários do painel e registrar tudo no inventário da agência.

João Rizzon · 2026-10-09 · Revenda

---

## Antes de ativar, monte o caminho de volta

O 2FA no WHM protege o painel que controla todas as contas da revenda. É exatamente por isso que ele é mais perigoso que o 2FA de uma conta cPanel isolada: se você perder o segundo fator da conta `root` ou do revendedor, não cai um site, cai o atendimento inteiro, incluindo criar conta, resetar senha de cliente e mexer em DNS.

Faça o caminho de recuperação antes de clicar em qualquer botão de ativação. Checklist mínimo:

- **Segredo (chave) guardado fora do celular.** Na hora de configurar, o WHM mostra o QR Code e também a chave em texto. Copie a chave para o gerenciador de senhas da agência, no mesmo registro da senha do WHM.
- **Segundo dispositivo já cadastrado.** Leia o mesmo QR em dois aparelhos ou em um app de desktop. Dois dispositivos com o mesmo segredo geram o mesmo código.
- **Acesso alternativo testado.** Confirme que você consegue entrar por SSH como `root` (ou com usuário sudo) antes de ativar. O 2FA do WHM é do painel, não do SSH; se o painel travar, o shell é a porta de serviço.
- **Quem libera.** Anote, no mesmo registro, qual canal do provedor desativa o 2FA de uma conta do WHM em servidor gerenciado, e qual a verificação de identidade exigida. Descobrir isso em pânico, às 2h da manhã, é caro.
- **Relógio do servidor e do celular sincronizados.** TOTP depende de hora. Servidor com NTP parado gera código "inválido" sem motivo aparente.

## Onde fica o 2FA no WHM: Security Center » Two-Factor Authentication

No WHM, a funcionalidade vive em **Home » Security Center » Two-Factor Authentication**, segundo a [documentação oficial do cPanel](https://docs.cpanel.net/whm/security-center/two-factor-authentication-for-whm/82/). A interface separa duas coisas que costumam ser confundidas:

| O que você quer | Onde se faz | Efeito |
|---|---|---||
| Ligar o recurso no servidor | Aba de configuração do 2FA (Security Center) | Habilita o 2FA como opção para as contas do servidor |
| Cadastrar seu próprio segundo fator | Gerenciamento da sua conta, dentro da mesma interface | Passa a pedir código no seu login do WHM |
| Obrigar os demais usuários | Política de segurança do 2FA | Usuários sem 2FA são levados à tela de configuração ao entrar |
| Remover o 2FA de alguém que perdeu o aparelho | Gerenciamento de usuários | Zera a configuração daquele usuário |

Quem opera revenda sem acesso `root` depende do provedor para a etapa de servidor. Nesse caso, confirme com ele se o recurso já está habilitado antes de prometer a política ao cliente.

## Procedimento de ativação, na ordem segura

### Habilite o recurso e configure a sua conta primeiro

Entre no WHM, vá em **Security Center » Two-Factor Authentication** e habilite o recurso. Em seguida, configure o segundo fator da **sua** conta: o painel exibe um QR Code e a chave correspondente. Leia o QR no app autenticador, copie a chave para o cofre de senhas e digite o código de seis dígitos para confirmar. Sem confirmar o código, a configuração não é salva.

### Teste o login em outra sessão antes de seguir

Não feche a sessão atual. Abra uma janela anônima, faça login de novo no WHM e confirme que o código é aceito. Esse é o momento de descobrir problema de relógio, não depois.

### Só então exija o segundo fator dos outros usuários

Com o seu acesso comprovadamente funcionando, ative a política que exige 2FA. A documentação do cPanel descreve o comportamento: usuários sem segundo fator configurado são direcionados à tela de configuração no próximo login, em vez de serem bloqueados. É bom, mas não elimina o aviso prévio: um usuário que entra no painel sem o celular em mãos fica parado.

### Documente no inventário da agência

Registre, por servidor: data de ativação, quais usuários têm 2FA, onde está a chave de cada um, quem é o contato de recuperação do provedor. Se a agência tem vários servidores ou várias revendas, a planilha é o que impede que o procedimento dependa de uma pessoa só.

## Trocar de celular sem perder o acesso

O erro clássico é apagar o app antigo antes de validar o novo. Roteiro na ordem certa, com os dois aparelhos na mesa:

- Entre no WHM pelo computador, com o celular **antigo** ainda funcionando.
- Vá em **Security Center » Two-Factor Authentication** e reconfigure a sua conta: gere um novo QR Code.
- Leia o QR no celular **novo** e confirme com o código gerado por ele.
- Faça logout e login de novo usando o aparelho novo. Só depois disso remova a entrada antiga do celular velho.
- Atualize a chave salva no cofre de senhas. A chave antiga virou lixo e, se ficar lá, vai confundir você daqui a oito meses.

Se o aparelho já foi perdido: quem tem `root` remove o 2FA do usuário pela aba de gerenciamento de usuários do WHM. Se o usuário travado for o próprio `root`, a saída é mais estreita do que parece: a documentação citada descreve a remoção do segundo fator pela interface do WHM, por um usuário que já esteja autenticado, e não descreve nenhum caminho de remoção do 2FA por linha de comando. Então, na prática, sobram três portas. A primeira é o segundo dispositivo cadastrado ou a chave em texto salva no cofre, que recoloca você dentro do painel em segundos. A segunda é outra conta do WHM com privilégio de nível root (ou com a ACL que permite gerenciar o 2FA de outros usuários), capaz de zerar o segundo fator do `root` pela aba de gerenciamento de usuários; revendedor comum não tem esse privilégio, e a documentação citada não descreve essa remoção entre contas, então verifique no seu servidor, antes de precisar, se alguma conta além do `root` enxerga essa aba. A terceira, em servidor gerenciado, é o pedido formal ao provedor, com a verificação de identidade que ele exigir. O SSH continua valendo para manter o servidor de pé (serviço, log, backup), mas não assuma que ele destrava o painel. Por isso a etapa de "quem libera" entra no checklist antes, e não depois.

## Exigir 2FA no WHM não liga 2FA no cPanel dos clientes

Vale separar os dois escopos para não prometer ao cliente algo que não acontece:

| Escopo | Quem é afetado | Quem gerencia |
|---|---|---||
| 2FA no WHM | você, sócios, equipe técnica, revendedores com acesso ao WHM | administrador do servidor / revendedor |
| 2FA no cPanel da conta | o dono do site, no login do cPanel dele | o próprio usuário, dentro do cPanel |

Exigir 2FA no WHM não liga 2FA no cPanel de cada cliente. São interfaces diferentes. Se a política da agência for cobrir também as contas dos clientes, isso é uma segunda campanha, com outro aviso e outro suporte.

## O aviso pronto para copiar e mandar ao cliente

Quando a política atinge alguém que não é da equipe (um cliente com acesso de revendedor, um sócio do cliente), avise antes. Texto curto, sem jargão, que você pode copiar:

```
Olá, [nome]. A partir de [data], o acesso ao painel vai pedir, além da senha,
um código de 6 dígitos gerado no seu celular. É o mesmo esquema do app do banco.
No primeiro login depois dessa data, a própria tela mostra um QR Code:
instale um app autenticador (Google Authenticator, Authy ou similar),
leia o código e pronto. Guarde a chave em texto que aparece junto com o QR,
ela é o que permite recuperar o acesso se você trocar de celular.
Se travar, me chame antes de reinstalar o app.
```

E um complemento útil para e-mail interno de equipe: "quem for trocar de aparelho, fala comigo **antes** de apagar o app".

## Erros que custam uma madrugada

- **Ativar a exigência geral na sexta à noite.** Faça em manhã de dia útil, com você disponível para destravar gente.
- **Guardar a chave só no celular.** Celular molha, cai e é roubado. A chave tem que estar no cofre da agência.
- **Confiar em backup do app que você nunca restaurou.** Backup em nuvem de autenticador resolve na maioria dos casos, mas só descobrir no dia é aposta.
- **Esquecer o NTP.** Código correto recusado, duas vezes seguidas, com relógio divergente, é quase sempre hora fora de sincronia.
- **Não registrar quem no provedor faz a remoção.** Em servidor gerenciado, essa informação é parte do plano de recuperação, não detalhe burocrático.

Nada aqui foi medido por nós: o comportamento das telas e a localização da funcionalidade vêm da [documentação oficial do cPanel sobre Two-Factor Authentication for WHM](https://docs.cpanel.net/whm/security-center/two-factor-authentication-for-whm/82/). Os textos de aviso ao cliente e a planilha de inventário são sugestão de processo, não parâmetro do produto, e devem ser adaptados ao seu contrato.

