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.

Resposta curta: 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.
Neste artigo
- Antes de ativar, monte o caminho de volta
- Onde fica o 2FA no WHM: Security Center » Two-Factor Authentication
- Procedimento de ativação, na ordem segura
- Trocar de celular sem perder o acesso
- Exigir 2FA no WHM não liga 2FA no cPanel dos clientes
- O aviso pronto para copiar e mandar ao cliente
- Erros que custam uma madrugada
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. 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. 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.
Referências
- Documentação oficial (cpanel) — Two-Factor Authentication for WHM. Consultado em 2026-10-07.