Como apagar certificados SSL antigos de clientes no WHM
Um processo em quatro etapas para revenda: inventariar por IP, exportar os certificados de quem continua no ar, remover e validar, com uma cópia própria como redundância.

Resposta curta: no WHM, use SSL/TLS > Manage SSL Hosts e clique em Uninstall no host órfão, mas só depois de cruzar domínio, IP e conta ativa, definir outro primário se for o caso e copiar os certificados dos sites vizinhos do mesmo IP.
Neste artigo
- Quando um certificado no WHM vira órfão
- Uninstall e Make Primary: o que cada ação muda no IP
- Como saber se um host SSL é órfão antes de remover
- Exporte os certificados dos vizinhos antes de remover
- Como remover o órfão sem derrubar os vizinhos
- Como validar os vizinhos e reinstalar se algo quebrar
- Checklist reutilizável e como explicar ao cliente
Quando um certificado no WHM vira órfão
Certificado órfão é o host SSL que continua instalado no servidor depois que o motivo dele deixou de existir. Na revenda isso aparece em duas situações recorrentes: cliente que saiu e cuja conta foi removida de um jeito que não limpou tudo, e domínio adicional que nunca apontou para o servidor. Certificado vencido num host ativo não entra aqui: no mesmo host, instalar um certificado novo substitui o anterior, porque o Manage SSL Hosts mantém um certificado por host. Clicar em Uninstall num host ativo derruba o HTTPS do site.
O risco de deixar isso parado é pequeno. O risco de limpar sem método é maior, e tem dois pontos concretos: o Uninstall atua só no host escolhido, então um vizinho só é afetado se o host removido for o primário do IP (muda o certificado entregue a quem não envia SNI) ou se você clicar na linha errada, por exemplo num host ativo. A exportação prévia é redundância para esse segundo caso. Por isso o processo aqui tem uma ordem fixa: inventariar, exportar, remover, validar.
Este guia se apoia na documentação oficial do cPanel para a interface Manage SSL Hosts (consultada em 21/10/2026). Não fizemos medição própria sobre esse procedimento. O que vem de fora dessa página está marcado como prática operacional. Os nomes de domínio e IPs nos exemplos são fictícios.
Uninstall e Make Primary: o que cada ação muda no IP
No WHM, o caminho é SSL/TLS > Manage SSL Hosts. Segundo a documentação, a tela lista os certificados instalados nos hosts do servidor, com informações como os domínios cobertos, o dono (a conta), o endereço IP, o emissor e a data de expiração. Os rótulos exatos podem variar entre versões, então confira na sua instalação.
As ações relevantes para esta tarefa são duas:
- Uninstall: remove o certificado daquele host SSL.
- Make Primary: define qual site responde por padrão naquele IP para clientes que não enviam SNI.
A segunda ação é a que costuma ser esquecida. Se o host que você vai desinstalar for o primário de um IP compartilhado, o comportamento padrão do IP muda depois da remoção. Na prática, clientes modernos usam SNI e não percebem, mas monitoramento antigo, integrações legadas e alguns robôs podem receber outro certificado. Anote quem é primário antes de mexer.
Como saber se um host SSL é órfão antes de remover
O objetivo é sair com uma planilha simples: cada host SSL listado, a qual IP pertence, se a conta ainda existe e se o domínio ainda aponta para o servidor. Comece pela tela do WHM e cruze com o terminal.
Para confirmar se o domínio ainda pertence a alguma conta do servidor (prática operacional: o arquivo /etc/userdomains mapeia domínio para conta, mas não é citado na documentação usada aqui):
grep -i 'clienteantigo.com.br' /etc/userdomains
Se não retornar nada, o domínio não está associado a nenhuma conta ativa. Para ver se o DNS ainda aponta para o servidor:
dig +short clienteantigo.com.br A
dig +short www.clienteantigo.com.br A
Compare a saída com o IP mostrado na linha do host SSL. Domínio sem conta e sem DNS apontando é candidato forte. Domínio com conta ativa e DNS em outro lugar exige conversa com o cliente antes, porque pode ser migração em andamento.
Use esta classificação para cada linha:
| Situação | Conta existe | DNS aponta para o servidor | Ação |
|---|---|---|---|
| Cliente saiu | Não | Não | Exportar e remover |
| Domínio nunca apontou | Sim | Não | Confirmar com o cliente, depois remover |
| Certificado vencido em site ativo | Sim | Sim | Não remover: resolver emissão primeiro (Uninstall derruba o HTTPS) |
| Host primário do IP | Qualquer | Qualquer | Definir novo primário antes de remover |
A terceira linha é a armadilha. Certificado vencido em site ativo não é órfão, é problema de renovação. Remover deixa o site sem HTTPS até alguém emitir outro.
Exporte os certificados dos vizinhos antes de remover
Este passo é redundância barata. Antes de qualquer Uninstall, faça cópia dos certificados de todos os sites que seguem no ar no mesmo IP, não só do que vai sair. Se você remover a linha errada, reinstala a partir da sua cópia sem depender de backup ou de nova emissão.
Prática operacional, não documentada na página do Manage SSL Hosts: em instalações atuais, os certificados que o Apache usa ficam por host em /var/cpanel/ssl/apache_tls/, cada um num diretório com o nome do domínio e um arquivo combined. Esse local e esse formato podem mudar entre versões, então confirme com ls antes de copiar. A variável DEST vale só na sessão atual do terminal:
ls /var/cpanel/ssl/apache_tls/
DEST=/root/ssl-export-$(date +%F)
mkdir -p "$DEST"
cp -a /var/cpanel/ssl/apache_tls/. "$DEST"/
Copiar o diretório inteiro é mais simples e mais seguro do que escolher domínio por domínio. Depois, confira que a cópia tem certificado legível e com a validade esperada para um vizinho:
openssl x509 -in "$DEST"/sitevizinho.com.br/combined -noout -subject -enddate
Se o comando mostrar o domínio e a data de expiração, a cópia está utilizável. Se der erro, pare e investigue antes de remover qualquer coisa. Guarde essa pasta com permissão restrita, porque ela contém chaves privadas:
chmod -R go-rwx "$DEST"
chmod 700 "$DEST"
find "$DEST" -type f -exec chmod 600 {} +
Para certificado comprado (não AutoSSL), vale também pedir ao cliente ou buscar no painel da autoridade certificadora a cópia original. AutoSSL reemite sozinho; certificado pago, não.
Como remover o órfão sem derrubar os vizinhos
Com inventário e exportação prontos, a remoção é rápida.
Resolva o primário do IP antes de remover
Se o host a remover estiver marcado como primário, escolha um site ativo do mesmo IP e use Make Primary nele primeiro. Assim o IP não fica com um padrão indefinido.
Desinstale o certificado órfão
Localize a linha pelo domínio e pelo IP (o mesmo domínio pode aparecer em mais de um IP em servidores antigos) e clique em Uninstall. Confirme quando o WHM pedir.
Repita por IP, não por lista solta
Trabalhe um IP de cada vez. Termine a validação de um antes de passar ao próximo. Se algo quebrar, você sabe exatamente onde.
Como validar os vizinhos e reinstalar se algo quebrar
Depois de cada IP, teste os vizinhos que continuam no ar:
openssl s_client -connect sitevizinho.com.br:443 -servername sitevizinho.com.br </dev/null 2>/dev/null | openssl x509 -noout -subject -enddate
O subject deve ser o domínio do vizinho e a data deve bater com a da exportação. Recarregue também a tela Manage SSL Hosts e confirme que o órfão sumiu e que o primário do IP é o que você escolheu.
Se um vizinho perdeu o certificado, o caminho que usamos (prática operacional, fora da página citada) é a interface SSL/TLS > Install an SSL Certificate on a Domain no WHM, colando certificado, chave e cadeia. Antes de recorrer à pasta exportada, veja se chave e certificado ainda estão no SSL Storage da conta (cPanel > SSL/TLS), onde costumam permanecer depois de um Uninstall. Não confirmamos esse comportamento na fonte, por isso a exportação fica como redundância. Para sites com AutoSSL, pedir nova verificação para a conta costuma resolver, mas a cópia garante o retorno imediato se a emissão falhar.
Checklist reutilizável e como explicar ao cliente
Para padronizar entre servidores da revenda:
- Exportar a lista do Manage SSL Hosts e anotar o primário de cada IP.
- Cruzar cada domínio com
/etc/userdomainsedig. - Classificar pela tabela acima; separar vencidos em site ativo para renovação.
- Copiar
/var/cpanel/ssl/apache_tls/inteiro e validar uma amostra comopenssl x509. - Ajustar primário quando necessário.
- Desinstalar um IP por vez.
- Testar vizinhos com
openssl s_cliente registrar data e responsável. - Manter a pasta exportada por um prazo combinado e depois apagar.
Quando o domínio for de um cliente ainda ativo, uma frase que funciona: "Encontramos no servidor um certificado de segurança para um domínio seu que não aponta para a hospedagem. Ele não protege nada hoje. Vamos removê-lo para manter o servidor limpo; se você pretende usar esse domínio aqui, nos avise e emitimos um novo."
Se o servidor tem poucos hosts órfãos e nenhum deles é primário de IP, talvez a limpeza nem seja urgente: certificado parado não consome recurso relevante. Faça quando houver janela, mas sempre com a exportação antes.
Referências
- Documentação oficial (cpanel) — Manage SSL Hosts. Consultado em 2026-10-21.