blog
Painéis

Forçar troca de senha no cPanel sem quebrar FTP e backup

O recurso do WHM que obriga o cliente a definir a senha nova sozinho, e a lista do que para de funcionar no minuto seguinte se você não checar antes.

JR · · 7 min de leitura · 1 tabela · 1 bloco de código

Resposta curta: em dois passos no WHM, mais o registro no seu controle: em Account Functions > Force Password Change, você marca a conta para exigir senha nova no próximo login sem nunca conhecê-la. Antes disso, inventarie FTP, backup agendado e scripts com credencial salva: eles não passam pela tela de login e param calados.

Neste artigo
  1. O que o Force Password Change resolve e o que continua funcionando com a senha antiga
  2. Onde a credencial está salva: tabela de sintomas e grep para achar senha em código
  3. Acesso ao WHM, permissão de revendedor e o caminho exato da interface
  4. Como acionar a troca forçada em três etapas
  5. O que o cliente vê na tela e o que ele precisa ter em mãos antes de tentar
  6. Cinco falhas que aparecem depois de acionar, e como sair de cada uma
  7. Frase pronta para avisar o cliente antes da troca
  8. Checklist de nove passos para repetir em vários sites

O que o Force Password Change resolve e o que continua funcionando com a senha antiga

O cenário é sempre o mesmo. Um funcionário do cliente saiu, a senha do cPanel circulou num grupo de WhatsApp, ou o cliente pediu acesso e você não quer ficar como depositário da senha dele. A saída comum é gerar uma senha nova, mandar por mensagem e torcer para ninguém encaminhar. Isso tem dois problemas: você passa a conhecer a senha do cliente, e a senha trafega por um canal que você não controla.

O WHM tem uma interface para isso: Force Password Change, em *Account Functions*. Ela marca contas cPanel para que o usuário seja obrigado a definir uma senha nova no próximo login, conforme a documentação oficial do cPanel. Você nunca chega a saber a senha final.

O que ele não resolve: qualquer coisa que autentique sem passar por tela de login. FTP, SFTP, rsync de backup, plugin de migração, script de deploy e integração com token continuam usando a credencial antiga até o momento em que ela deixa de valer. Aí param, e na prática não conte com aviso automático: o que costuma chegar até você é um backup que não aconteceu.

Onde a credencial está salva: tabela de sintomas e grep para achar senha em código

Esta é a parte que separa a troca tranquila da terça-feira perdida. Antes de forçar a troca, liste onde a credencial daquela conta está gravada. Em site de cliente mantido por agência, a lista costuma ser mais longa do que o cliente imagina.

Onde a senha costuma estar salva Sintoma quando a credencial quebra O que fazer antes
Cliente FTP/SFTP (FileZilla, Cyberduck, VS Code) Transferência falha com erro de autenticação Avisar quem usa; trocar depois no gerenciador de sites
Backup agendado externo (UpdraftPlus, BackupBuddy, rsync em cron) Backup para de rodar sem aviso visível Criar usuário FTP dedicado ou revisar o destino após a troca
Plugin de migração (Duplicator, All-in-One WP Migration via FTP) Importação para na etapa de upload Rodar a migração antes, ou reconfigurar depois
Script de deploy em CI, Makefile, .env Pipeline vermelho, deploy silenciosamente antigo Mover a credencial para secret e atualizar no mesmo dia
Gerenciador de sites da agência (ManageWP, MainWP, InfiniteWP) Conexão de manutenção cai Reconectar depois da troca
Contas de e-mail e clientes móveis Loop de pedido de senha no celular do cliente Tratar separadamente: e-mail tem senha própria
Conta de serviço (monitoramento, integração de ERP) Integração para e ninguém percebe por dias Deixar fora do escopo da troca forçada

Uma varredura rápida nos arquivos do site ajuda a achar credencial esquecida em código. Rode a partir do diretório do site, por SSH:

# procura credenciais de FTP gravadas em arquivos PHP do WordPress
grep -RIn --include="*.php" -e "FTP_USER" -e "FTP_PASS" -e "FTP_HOST" .

# procura arquivos de ambiente e de configuração fora do padrão
find . -maxdepth 3 \( -name ".env" -o -name "*.conf" -o -name "wp-config*.php" \)

Se FTP_PASS aparecer no wp-config.php, aquele site volta a pedir as credenciais de FTP na tela de atualização de plugins (ou a conexão simplesmente falha) assim que a senha mudar, até o valor ser atualizado no arquivo. Anote e trate.

Acesso ao WHM, permissão de revendedor e o caminho exato da interface

A interface é WHM > Account Functions > Force Password Change, documentada em docs.cpanel.net. Pré-requisitos práticos:

Se você só precisa invalidar o acesso de uma pessoa específica e não o do titular, pense em outra via: remover a conta FTP daquela pessoa, revogar a chave SSH, ou excluir o usuário de e-mail. Forçar a troca da conta cPanel inteira é o martelo, não a chave de fenda. Usar o martelo quando a chave resolve gera retrabalho em todas as integrações da tabela acima.

Escolher o escopo antes de forçar a trocaPessoa específica perdeu acessoRemova usuário FTP ou chave SSHSó o e-mail vazouTroque a senha daquela caixaToken de API em usoRevogue o token, senha não bastaTitular da conta comprometidoAí sim, Force Password ChangeConta de serviço sem humanoFora do lote, trate à parte
Forçar a troca da conta cPanel inteira é o martelo. Antes dele, verifique se a chave de fenda resolve.

Como acionar a troca forçada em três etapas

Marcar só as contas que você inventariou

Na interface, as contas cPanel do servidor aparecem em lista com seleção. Marque apenas as que você já inventariou. Resista a selecionar tudo: contas de serviço e sites que rodam deploy automático precisam de tratamento à parte.

Confirmar e o que muda na conta a partir dali

Ao confirmar, as contas marcadas passam a exigir a definição de uma senha nova no próximo login no cPanel.

Registrar data, conta e integrações fora do WHM

Data, conta, quem pediu, quais integrações foram listadas no inventário. Quando o backup falhar em três dias, esse registro é a diferença entre diagnóstico em dois minutos e investigação do zero.

O que o cliente vê na tela e o que ele precisa ter em mãos antes de tentar

O cliente entra no cPanel com a senha antiga, que ainda é válida para esse primeiro acesso, e o painel exige que ele defina uma senha nova antes de liberar as demais telas. Ele escolhe a senha; você não vê.

Peça que ele tenha em mãos, antes de tentar:

Uma senha fraca pode ser recusada pelo próprio painel por causa da política de força de senha do servidor. Se o cliente travar nessa etapa, oriente-o a usar o gerador de senha da própria tela em vez de insistir em variações do nome da empresa.

Cinco falhas que aparecem depois de acionar, e como sair de cada uma

Usuário preso em loop de troca. Ele define a senha, sai, volta e o painel pede de novo. Quase sempre é sessão antiga em cache ou uma segunda aba aberta com a sessão anterior. Peça logout completo, fechar o navegador e entrar de novo em janela anônima. Se persistir, confirme no WHM se a marcação da conta continua ativa.

Acesso por API ou token continua funcionando. Chamadas com token de API não passam pela tela de login do painel. Se o objetivo é cortar o acesso de alguém que tinha token, a troca de senha sozinha não resolve: revogue o token.

Conta de serviço entrou no lote. Aconteceu de selecionar a conta usada por uma integração sem interface humana. Ela não tem quem faça o login e defina a senha nova, então fica num limbo: o painel exige uma ação que nenhuma pessoa vai executar. Identifique, desfaça a marcação dessa conta no WHM pela mesma interface e trate a credencial por outro caminho.

Backup sumiu sem erro. Destino FTP com credencial antiga falha e muitos plugins registram só no log interno. Depois de qualquer troca, abra o painel do plugin de backup e force uma execução manual para validar.

E-mail do cliente pedindo senha no celular. Se a senha de e-mail era igual à do cPanel, ou se o acesso de e-mail dependia da conta principal, o celular vai pedir autenticação. Isso costuma gerar a ligação mais aflita do dia. Avise antes.

Frase pronta para avisar o cliente antes da troca

Mande antes, não depois. Copie e ajuste o nome:

A última frase é a que evita o chamado de sexta à noite. Ela transfere para o cliente a informação que só ele tem: quem mais usa aquele acesso.

Checklist de nove passos para repetir em vários sites

Salve isto no seu gestor de tarefas e reaproveite por conta:

  1. Confirmar o motivo: desligamento, suspeita de vazamento, higiene periódica. O motivo define o escopo.
  2. Rodar o inventário de credenciais salvas (tabela e grep deste artigo) e colar o resultado no card da tarefa.
  3. Decidir escopo: conta cPanel inteira, ou apenas remover usuário FTP, chave SSH ou conta de e-mail.
  4. Separar contas de serviço e integrações do lote.
  5. Enviar a frase de aviso ao cliente e esperar a confirmação de leitura.
  6. Acionar o Force Password Change no WHM para as contas selecionadas.
  7. Pedir ao cliente que faça o login e conclua a troca, de preferência com você disponível no chat.
  8. Validar no mesmo dia: executar um backup manual, testar o FTP da agência, rodar um deploy de teste, abrir o gerenciador de sites e reconectar o que caiu.
  9. Registrar data, conta e itens reconfigurados.

O passo 8 é o que ninguém faz e o que mais custa depois. Entre forçar a troca e descobrir que o backup parou costuma haver dias de distância, e nesse intervalo o cliente acha que está protegido quando o que ele tem é uma senha nova e nenhuma cópia recente do site.

Do inventário à validação no mesmo diaInventariarTabela de sintomas mais grep no códigoAvisarFrase pronta e confirmação do clienteAcionarMarcar só as contas inventariadasTrocarCliente define a senha, você não vêValidarBackup manual, FTP, deploy, gerenciador
A última etapa é a que ninguém faz. Entre a troca e o backup que parou costumam passar dias.

Referências

  1. Documentação oficial (cpanel) — Force Password Change. Consultado em 2026-10-02.
Leia também