blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 6 blocos de código

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
  1. Quando um certificado no WHM vira órfão
  2. Uninstall e Make Primary: o que cada ação muda no IP
  3. Como saber se um host SSL é órfão antes de remover
  4. Exporte os certificados dos vizinhos antes de remover
  5. Como remover o órfão sem derrubar os vizinhos
  6. Como validar os vizinhos e reinstalar se algo quebrar
  7. 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.

Ordem do processo de limpezaInventariarListar hosts SSL e primários por IPExportarCopiar certificados dos vizinhosRemoverUninstall um IP por vezValidarTestar vizinhos com openssl
Ordem fixa do processo: inventariar, exportar, remover, validar.

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:

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.

Decidir pela situação do hostCliente saiu, sem conta e sem DNSExportar e removerDomínio nunca apontou, conta existeConfirmar com cliente, depois removerVencido em site ativoNão remover, renovar primeiroHost primário do IPDefinir novo primário antes
Classificação de cada linha do Manage SSL Hosts antes de qualquer Uninstall.

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:

  1. Exportar a lista do Manage SSL Hosts e anotar o primário de cada IP.
  2. Cruzar cada domínio com /etc/userdomains e dig.
  3. Classificar pela tabela acima; separar vencidos em site ativo para renovação.
  4. Copiar /var/cpanel/ssl/apache_tls/ inteiro e validar uma amostra com openssl x509.
  5. Ajustar primário quando necessário.
  6. Desinstalar um IP por vez.
  7. Testar vizinhos com openssl s_client e registrar data e responsável.
  8. 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

  1. Documentação oficial (cpanel) — Manage SSL Hosts. Consultado em 2026-10-21.
Leia também