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

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

João Rizzon · 2026-11-08 · Revenda

---

## 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](https://docs.cpanel.net/whm/account-functions/password-modification/) 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:

- A troca vale para o **usuário do sistema**. É a mesma credencial que entra no cPanel, no webmail pelo login de cPanel, no FTP da conta principal e no SSH, quando habilitado.
- Existe a caixa **Sync MySQL password** (sincronizar a senha do MySQL). A documentação do cPanel descreve esse controle como a opção para que a senha do MySQL do usuário seja alterada junto com a senha da conta. Marcar ou não muda o alcance do estrago.

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.

## O que para de funcionar no mesmo minuto da troca

Lista nominal, para você conferir item a item:

- **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.
- **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.
- **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.
- **Acesso SSH/SFTP por senha**, se o plano permitir. Chave pública continua funcionando.
- **`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.
- **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.
- **Deploy por Git ou CI** que autentica por SSH com senha, ou que usa credencial FTP salva no runner.
- **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.
- **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

```bash
# 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

```bash
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

```bash
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

- Quem mais tem a senha do cPanel hoje.
- Se existe algum backup ou sincronização configurado fora do servidor.
- Se alguma agência ou freelancer anterior ainda tem acesso.

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

- Rodar o inventário acima e anotar o que vai quebrar.
- Avisar o cliente com a frase pronta da próxima seção.
- Gerar a senha nova em gerenciador de senhas, não no teclado.
- No WHM, **Account Functions > Password Modification**, selecionar a conta, colar a senha, decidir o Sync MySQL conforme a tabela.
- Se marcou Sync, atualizar imediatamente `DB_PASSWORD` em `wp-config.php` e nos demais arquivos que o `grep` do inventário listou.
- Abrir o site em aba anônima e confirmar que carrega, incluindo uma página dinâmica e o `/wp-admin`.
- Refazer login no cPanel com a senha nova.
- Reconfigurar FTP salvo, deploy e backup remoto com a credencial nova.
- Entregar a senha ao cliente por canal que não seja e-mail em texto puro.
- 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.

## A frase pronta para avisar o cliente antes da troca

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

> **** Vamos trocar a senha de acesso ao painel do seu site hoje às 20h, por segurança. A troca é imediata. Durante alguns minutos, quem estiver logado no painel ou no webmail pelo login principal será desconectado, e programas de FTP com a senha salva vão parar de conectar até serem atualizados. Se houver qualquer integração ou backup configurado por terceiros com essa senha, me avise antes das 20h para eu reconfigurar junto. O site em si continua no ar, e eu confirmo por mensagem assim que terminar.

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:

- **Uma planilha por cliente** com: nome da conta cPanel, usuário de banco usado por cada site, contas FTP adicionais e para quem foram, onde o backup é enviado, se o deploy usa chave ou senha.
- **Convenção de nome de usuário de banco** que deixe óbvio que não é o homônimo da conta. Ao bater o olho em `conta_lojav2`, você já sabe que o Sync MySQL não vai derrubar aquele site.
- **Chave SSH no lugar de senha** em todo deploy, sem exceção. É o item que mais reduz retrabalho em troca de credencial.
- **Uma data fixa de rotação**, por exemplo na renovação anual do contrato, com a mesma frase de aviso. Troca prevista não gera chamado.
- **Procedimento separado para incidente**, com Sync MySQL marcado por padrão e a revisão de encaminhamentos de e-mail e usuários adicionais incluída. Em incidente, a pressa é inimiga do checklist, então o checklist tem que estar escrito antes.

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.

