blog
Revenda

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.

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

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
  1. Antes de ativar, monte o caminho de volta
  2. Onde fica o 2FA no WHM: Security Center » Two-Factor Authentication
  3. Procedimento de ativação, na ordem segura
  4. Trocar de celular sem perder o acesso
  5. Exigir 2FA no WHM não liga 2FA no cPanel dos clientes
  6. O aviso pronto para copiar e mandar ao cliente
  7. 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:

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

Ordem segura de ativação do 2FA no WHMPreparar voltaChave no cofre, SSH testadoHabilitar recursoSecurity Center, Two-Factor AuthenticationConfigurar sua contaQR em dois dispositivosTestar em aba anônimaLogin novo antes de seguirExigir dos demaisPolítica ligada e documentada
Ordem de ativação do 2FA no WHM sem risco de trancar o painel.

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:

  1. Entre no WHM pelo computador, com o celular antigo ainda funcionando.
  2. Vá em Security Center » Two-Factor Authentication e reconfigure a sua conta: gere um novo QR Code.
  3. Leia o QR no celular novo e confirme com o código gerado por ele.
  4. Faça logout e login de novo usando o aparelho novo. Só depois disso remova a entrada antiga do celular velho.
  5. 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.

Perdeu o segundo fator: por onde sairAparelho perdidoSem código, painel fechadoPorta 1: chave ou 2º aparelhoResolve em segundosPorta 2: outra conta rootZera o 2FA do usuárioPorta 3: provedorPedido formal com verificaçãoSSH não destrava painelServe para manter serviços
Caminhos de recuperação quando o segundo fator do WHM é perdido.

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

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

  1. Documentação oficial (cpanel) — Two-Factor Authentication for WHM. Consultado em 2026-10-07.
Leia também