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

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

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

---

## 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](https://docs.cpanel.net/whm/ssl-tls/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/userdomains` e `dig`.
- Classificar pela tabela acima; separar vencidos em site ativo para renovação.
- Copiar `/var/cpanel/ssl/apache_tls/` inteiro e validar uma amostra com `openssl x509`.
- Ajustar primário quando necessário.
- Desinstalar um IP por vez.
- Testar vizinhos com `openssl s_client` e 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.

