blog
Revenda

Trocar senha de cPanel pelo WHM sem derrubar o site

O que marcar "Sync MySQL password" realmente faz, o que perde credencial no mesmo minuto e o inventário para rodar antes de clicar.

JR · · 8 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: a troca é imediata e sem aviso. Antes de clicar, decida o "Sync MySQL password": marcado, ele muda também a senha do usuário MySQL homônimo e pode derrubar o site até você atualizar o wp-config.php. Rode o inventário de 10 minutos primeiro.

Neste artigo
  1. O que o WHM muda de fato quando você troca a senha pelo painel
  2. Quando marcar e quando desmarcar o Sync MySQL password
  3. O que para de funcionar no mesmo minuto da troca
  4. Inventário de 10 minutos antes de clicar em trocar
  5. Checklist de execução, em ordem
  6. A frase pronta para avisar o cliente antes da troca
  7. Erros que aparecem depois da troca e o que cada um significa
  8. Padronizando a troca de senha em carteira de vários sites

O que o WHM muda de fato quando você troca a senha pelo painel

Em Account Functions > Password Modification, você escolhe a conta cPanel, digita a nova senha e confirma. A documentação oficial do cPanel descreve essa interface como a forma de alterar a senha de uma conta cPanel a partir do WHM, sem precisar da senha antiga e sem entrar na conta.

Duas coisas importam para quem administra conta de terceiro:

Não há tela de confirmação por e-mail, não há janela de carência, não há "aplicar em 5 minutos". É imediato e silencioso: nada avisa o cliente, nada avisa o desenvolvedor que mantém o deploy, nada avisa o script de backup remoto. Por isso o trabalho real não é clicar no botão, é o inventário de dez minutos antes de clicar.

Quando marcar e quando desmarcar o Sync MySQL password

O usuário MySQL que leva o mesmo nome da conta cPanel (o usuário "dono" dos bancos) é o que entra na sincronização. Usuários de banco adicionais, criados em MySQL Databases com sufixo (conta_wp, conta_app), não são alterados pela troca da senha da conta.

Situação Sync MySQL marcado Sync MySQL desmarcado
Vazamento de senha, credencial possivelmente exposta inteira Recomendado: a senha do usuário MySQL homônimo também muda Deixa uma credencial conhecida pelo invasor ativa no banco
Saída de funcionário que tinha só acesso ao painel Opcional Suficiente se ele nunca teve a string de conexão
Site que conecta ao banco com usuário homônimo da conta Vai derrubar o site até você atualizar wp-config.php Site continua no ar
Site que conecta com usuário de banco dedicado Não afeta o site Não afeta o site

A regra prática que eu uso: em resposta a incidente, marque. Em troca de rotina ou higiene de acesso, desmarque e trate a senha do banco separadamente, no próprio cPanel, com usuário dedicado por aplicação.

Se marcar, assuma que o site pode cair. O tempo entre a troca e a atualização do wp-config.php é indisponibilidade real, com erro de conexão com o banco de dados na tela. Isso precisa estar combinado com o cliente antes, não depois.

Decidir o Sync MySQL antes de clicarTroca é rotina ou incidenteIncidente: marque Sync MySQLQual usuário o site usagrep DB_USER no wp-config.phpUsuário homônimo da contaMarcar Sync derruba o siteUsuário dedicado com sufixoSite segue no arDecidir e avisar o clienteCombine a janela antes

O que para de funcionar no mesmo minuto da troca

Lista nominal, para você conferir item a item:

  1. Sessões abertas do cPanel do cliente e de quem mais tiver o login. O comportamento esperado é que a sessão aberta deixe de valer logo após a troca, mas não testamos isso e a página de Password Modification não descreve esse comportamento: confirme no seu servidor antes de prometer ao cliente.
  2. Webmail acessado pelo login da conta cPanel. Contas de e-mail individuais (contato@dominio) têm senha própria e não são afetadas.
  3. Conta FTP principal, aquela cujo usuário é o próprio nome da conta cPanel. Contas FTP adicionais criadas no cPanel mantêm as senhas delas.
  4. Acesso SSH/SFTP por senha, se o plano permitir. Chave pública continua funcionando.
  5. wp-config.php, .env, config/database.php e qualquer arquivo com DB_PASSWORD, se você marcou Sync MySQL e a aplicação usa o usuário homônimo.
  6. Backup remoto puxado por FTP/SFTP com o usuário da conta: rotinas em Jetpack, UpdraftPlus apontando para o próprio servidor, rsync em cron de outra máquina, agregador da agência.
  7. Deploy por Git ou CI que autentica por SSH com senha, ou que usa credencial FTP salva no runner.
  8. Integrações que autenticam como usuário da conta: monitoramento que faz login no cPanel, plugin de migração com credencial FTP salva, cliente FTP do próprio cliente (FileZilla com senha gravada), gerenciador de sites da agência.
  9. API cPanel com token: a documentação de Password Modification não trata do assunto, e não testamos esse comportamento. Se alguma automação sua depende disso, teste um token logo após a troca. Vale também conferir se alguém montou automação com login e senha em vez de token, porque essa para na hora.

O item que mais pega gente desprevenida é o backup remoto puxado por FTP/SFTP. O backup quebra em silêncio e ninguém percebe até precisar restaurar.

Inventário de 10 minutos antes de clicar em trocar

Faça isto com acesso ao cPanel da conta ou por SSH como root. O objetivo não é auditoria completa, é não quebrar nada que você conseguiria descobrir em dez minutos.

Descobrir qual usuário de banco a aplicação usa

# no diretório do site
grep -i "DB_USER\|DB_PASSWORD\|DB_NAME" wp-config.php

Se DB_USER for igual ao nome da conta cPanel, marcar Sync MySQL derruba o site. Se tiver sufixo (conta_wp), não derruba.

Varrer os outros arquivos de configuração atrás de senha

grep -rl "DB_PASSWORD\|DB_PASS\|mysqli_connect" \
  /home/USUARIO/public_html --include="*.php" --include=".env" | head -20

Troque USUARIO pelo nome da conta. Rode também em subpastas de staging e em subdomínios: é lá que mora a instalação esquecida que ninguém lembra de atualizar.

Listar as contas FTP adicionais, que sobrevivem à troca

No cPanel, FTP Accounts. Anote quais existem. As adicionais sobrevivem à troca, e isso é útil: se o cliente precisa continuar subindo arquivo enquanto você resolve o resto, dê uma conta FTP dedicada em vez de devolver a senha principal.

Conferir o cron da conta atrás de credencial na linha

crontab -u USUARIO -l

Procure por mysqldump, rsync, curl com credencial na linha. Cada ocorrência é uma coisa que vai parar.

Três perguntas ao cliente antes de gerar a senha nova

Esses dez minutos não são burocracia. Eles decidem se a troca é um clique ou uma noite de suporte.

Checklist de execução, em ordem

  1. Rodar o inventário acima e anotar o que vai quebrar.
  2. Avisar o cliente com a frase pronta da próxima seção.
  3. Gerar a senha nova em gerenciador de senhas, não no teclado.
  4. No WHM, Account Functions > Password Modification, selecionar a conta, colar a senha, decidir o Sync MySQL conforme a tabela.
  5. Se marcou Sync, atualizar imediatamente DB_PASSWORD em wp-config.php e nos demais arquivos que o grep do inventário listou.
  6. Abrir o site em aba anônima e confirmar que carrega, incluindo uma página dinâmica e o /wp-admin.
  7. Refazer login no cPanel com a senha nova.
  8. Reconfigurar FTP salvo, deploy e backup remoto com a credencial nova.
  9. Entregar a senha ao cliente por canal que não seja e-mail em texto puro.
  10. Agendar uma conferência do backup em 24 horas. É o item que falha calado.

Em resposta a incidente, acrescente dois passos depois de decidir o Sync MySQL e antes de atualizar o wp-config.php: revisar os endereços de encaminhamento de e-mail da conta e revisar contas FTP e usuários de banco adicionais. Quem entrou costuma deixar uma porta secundária, e trocar só a senha principal dá sensação de resolvido sem resolver.

Ordem de execução da troca de senhaInventárioBanco, FTP, cron, integraçõesAvisoFrase pronta e janela combinadaTrocaPassword Modification no WHMAtualizaçãowp-config, FTP, deploy, backupConferênciaBackup revisto no dia seguinte

A frase pronta para avisar o cliente antes da troca

Use antes, não depois. Adapte o nome e a janela:

Se você vai marcar Sync MySQL e o site usa o usuário homônimo, troque a última frase por: "o site pode ficar alguns minutos fora do ar durante a atualização, e eu aviso assim que voltar". Dizer antes que vai cair custa uma mensagem. Dizer depois custa a confiança.

Erros que aparecem depois da troca e o que cada um significa

Sintoma Causa provável O que fazer
"Error establishing a database connection" no WordPress Sync MySQL marcado e wp-config.php com a senha antiga Atualizar DB_PASSWORD no arquivo
Cliente FTP dá erro de autenticação Senha salva na conta FTP principal Atualizar no cliente, ou criar conta FTP adicional
Webmail recusa login Acesso era pelo login da conta cPanel Entrar com o endereço de e-mail completo e a senha da caixa
Backup externo para de rodar sem erro visível Credencial FTP/SFTP antiga no serviço remoto Reconfigurar e forçar uma execução de teste
Deploy por Git falha na autenticação Senha no runner de CI Trocar para chave SSH, que não depende de senha
Script interno de banco falha Usava o usuário MySQL homônimo Criar usuário de banco dedicado para o script

A correção preventiva para metade dessa tabela é a mesma: não use a credencial principal da conta para nada automatizado. Usuário de banco dedicado por aplicação, conta FTP adicional por fornecedor, chave SSH para deploy. Feito assim, trocar a senha do cPanel volta a ser o que deveria: um clique que não derruba nada além das sessões abertas.

Padronizando a troca de senha em carteira de vários sites

Se você mantém dezenas de contas, transforme o inventário em padrão e não em memória:

O WHM entrega o poder de trocar a senha de qualquer conta sem conhecer a anterior. O que ele não entrega é a lista do que depende daquela senha. Essa lista é sua, e vale mais mantida do que reconstruída às pressas.

Referências

  1. Documentação oficial (cpanel) — Password Modification (WHM). Consultado em 2026-10-22.
Leia também