# Instalar certificado SSL comprado no cPanel sem quebrar a cadeia

Guia documental para gerar CSR, instalar o certificado, preencher o CABUNDLE corretamente e validar a cadeia antes de entregar o site ao cliente.

> são três campos no cPanel que decidem o resultado: CRT com o certificado do domínio, KEY com a chave do mesmo CSR e CABUNDLE com as intermediárias da CA. Deixar o CABUNDLE vazio mantém o cadeado no Chrome e quebra Android antigo, Java e gateways.

João Rizzon · 2026-09-19 · Painéis

---

Certificado comprado é outra rotina. O gratuito emitido pelo painel resolve emissão, instalação e renovação sozinho. O comprado exige que você gere a chave, gere o CSR com os dados exatos que a autoridade certificadora (CA) vai validar, receba de volta dois ou três arquivos e coloque cada um no campo certo do cPanel. O erro mais caro dessa sequência não derruba o site: ele deixa o cadeado verde no seu Chrome e quebra a conexão no Android velho do estoque, no Java do ERP e no gateway de pagamento.

Um aviso de transparência: este guia é documental. Não há medição de laboratório nossa por trás dele. O procedimento segue a [documentação do SSL/TLS Wizard do cPanel](https://docs.cpanel.net/cpanel/security/ssl-tls-wizard/) e o comportamento padrão do OpenSSL, e os nomes de menu podem variar entre versões e temas do painel.

## Quando o certificado pago se justifica e quando o gratuito resolve

Recomendação contra o nosso próprio interesse em vender complexidade: na maioria dos sites institucionais e lojas pequenas, o certificado gratuito emitido e renovado automaticamente pelo painel entrega exatamente a mesma criptografia e o mesmo cadeado. TLS não é "mais forte" porque a nota fiscal é maior.

Comprar faz sentido quando existe uma exigência externa concreta:

- **Política do cliente corporativo** que só aceita CA de uma lista aprovada, ou exige certificado com validação de organização (OV) mostrando a razão social.
- **Gateway de pagamento, banco ou integrador** que valida a cadeia com uma trust store própria e rejeita emissores fora dela.
- **Wildcard ou multidomínio** administrado fora do painel, quando o mesmo certificado precisa ser reaproveitado em um balanceador, em um CDN e no cPanel.
- **Garantia contratual** exigida em processo de compliance, que só a CA paga oferece por escrito.

Se nenhuma dessas quatro linhas se aplica, encerre a conversa com o cliente em cinco minutos e ative o gratuito. Se alguma se aplica, siga.

## Gerar chave e CSR com os dados que a CA vai validar

O CSR (Certificate Signing Request) carrega a chave pública e os dados de identificação. A CA assina esse conteúdo. Se o Common Name vier errado, o certificado volta errado, e refazer significa revalidar tudo.

### Os sete campos do CSR e o erro mais comum em cada um

| Campo | O que colocar | Erro comum |
|---|---|---||
| Common Name (CN) | O host exato que será servido: `www.exemplo.com.br` ou `exemplo.com.br` | Colocar `https://` ou uma barra no fim |
| SAN (domínios alternativos) | Todos os hosts que o certificado precisa cobrir, incluindo o CN | Esquecer o apex quando o CN é `www` |
| Organização | Razão social igual à da Receita, para certificados OV | Nome fantasia, que a CA não encontra na validação |
| Cidade / Estado | Por extenso, sem abreviação | `SP` em vez de `São Paulo` |
| País | `BR` | Nome do país por extenso |
| E-mail | Caixa que alguém lê no dia da emissão | E-mail do ex-funcionário do cliente |
| Tamanho da chave | RSA 2048 bits no mínimo, aceito por todas as CAs públicas | Chave de 1024 bits reaproveitada de um projeto antigo |

Para certificado de validação de domínio (DV), a CA ignora organização e endereço na prática, mas preencha do mesmo jeito: você não quer descobrir na renovação que aquele CSR não serve para o upgrade de OV que o cliente pediu.

### Gerar chave e CSR no próprio cPanel, com a chave guardada no painel

Em **SSL/TLS**, use *Private Keys* para gerar a chave e depois *Certificate Signing Requests* para gerar o CSR a partir dela. A vantagem prática é que a chave privada fica armazenada no painel, vinculada à conta, e no momento da instalação o cPanel já a oferece para você. Você não precisa guardar arquivo `.key` em pasta de projeto nem mandar por e-mail, que é onde chave privada costuma vazar em agência.

Copie o bloco do CSR inteiro, incluindo as linhas `-----BEGIN CERTIFICATE REQUEST-----` e `-----END CERTIFICATE REQUEST-----`, e cole no formulário da CA.

### Gerar por terminal quando o mesmo certificado vai para outro servidor

Se o mesmo certificado vai para o cPanel e para outro servidor, gere fora e distribua. Inclua a SAN já no CSR, com todos os hosts que o certificado precisa cobrir, o CN entre eles:

```bash
openssl req -new -newkey rsa:2048 -nodes \
  -keyout exemplo.com.br.key \
  -out exemplo.com.br.csr \
  -addext "subjectAltName=DNS:exemplo.com.br,DNS:www.exemplo.com.br"
```

O parâmetro `-addext` exige OpenSSL 1.1.1 ou superior. Em versão mais antiga, o caminho é um arquivo de configuração com a seção `[ v3_req ]` contendo `subjectAltName` e a chamada `-config arquivo.cnf -reqexts v3_req`.

Duas ressalvas que evitam surpresa na emissão: nem toda CA usa a SAN que veio no CSR. Muitas emitem com base na lista de hosts informada no pedido de compra, e algumas ignoram completamente o que está no arquivo. Preencha a SAN no CSR e, ainda assim, confirme a lista de hosts no formulário do pedido. Depois da emissão, confira a SAN do certificado recebido antes de instalar (o comando está na seção de validação).

Confira o que você acabou de gerar antes de enviar para a CA:

```bash
openssl req -noout -text -in exemplo.com.br.csr
```

Leia `Subject:` e confira CN, O, L, ST e C. A SAN aparece em `Requested Extensions`, como `X509v3 Subject Alternative Name`. Achou um erro de digitação, gere de novo agora: custa um comando, e depois da emissão custa uma revalidação.

## O que vai em cada uma das três caixas: CRT, KEY e CABUNDLE

A CA devolve, em geral, um arquivo do certificado do seu domínio e um ou mais arquivos de intermediária (às vezes chamados de `ca-bundle`, `chain` ou `intermediate`). Em cPanel, a tela **SSL/TLS > Install and Manage SSL for your site (HTTPS)** tem três caixas:

| Caixa | Conteúdo correto | Como reconhecer |
|---|---|---||
| **Certificate: (CRT)** | O certificado do seu domínio, só ele | Um único bloco `BEGIN CERTIFICATE`; o campo Subject tem o seu domínio |
| **Private Key (KEY)** | A chave gerada junto com o CSR | Bloco `BEGIN PRIVATE KEY` ou `BEGIN RSA PRIVATE KEY` |
| **Certificate Authority Bundle: (CABUNDLE)** | As intermediárias da CA, do mais próximo do seu certificado para o mais próximo da raiz | Um ou mais blocos `BEGIN CERTIFICATE` cujo Subject é o nome da CA |

Três regras que evitam quase todo o retrabalho:

- **Não empilhe tudo no CRT.** Colar certificado e intermediária juntos no primeiro campo funciona em alguns cenários e falha em outros. Separe.
- **Ordem importa no CABUNDLE.** Primeiro a intermediária que assinou o seu certificado, depois a que assinou aquela, e assim por diante.
- **Raiz não precisa ir.** A raiz já está na trust store do cliente. Incluir não quebra, mas engorda o handshake sem ganho.

Se você colou o CRT e o cPanel preencheu a chave sozinho, é porque a chave foi gerada no painel e o par confere. Se ele não preencheu, pare: ou a chave não está ali, ou o certificado não corresponde a nenhuma chave da conta.

O painel também oferece o **SSL/TLS Wizard**, que, segundo a [documentação do cPanel](https://docs.cpanel.net/cpanel/security/ssl-tls-wizard/), conduz compra e instalação de certificados através do cPanel Market. É um caminho válido quando o cliente aceita comprar pelo próprio painel. Para certificado adquirido fora, a instalação manual descrita acima é o caminho.

## Por que o Chrome mostra cadeado e o gateway de pagamento recusa

Este é o sintoma que chega na agência com a frase "funciona no meu celular e não no do financeiro".

O certificado do seu domínio não é confiável sozinho. Ele aponta para quem o assinou, a intermediária, que por sua vez aponta para a raiz, que está instalada no dispositivo. O servidor precisa entregar as intermediárias no handshake, porque o cliente só tem a raiz.

O que acontece quando o CABUNDLE fica vazio:

- **Navegadores de desktop atualizados** costumam completar a cadeia sozinhos. Eles guardam intermediárias já vistas em outros sites e muitos buscam o certificado faltante pela extensão AIA. Resultado: cadeado normal, e você jura que está tudo certo.
- **Android antigo, runtimes Java, bibliotecas de linguagem (`curl` em script, cliente HTTP de ERP), gateways de pagamento e appliances de rede** normalmente não fazem esse resgate. Eles validam o que recebem. Faltou intermediária, a conexão morre com "unable to get local issuer certificate" ou equivalente.

Por isso o bug atravessa o teste visual da agência e explode no financeiro do cliente, no leitor do estoque ou na integração de boleto. A validação não pode ser feita só no seu navegador.

## Quatro verificações que não dependem de navegador

Quatro verificações. Nenhuma depende de navegador.

### Conferir se a chave e o certificado são o mesmo par

Se os dois módulos baterem, o par confere. Se divergirem, o certificado pertence a outro CSR.

```bash
openssl x509 -noout -modulus -in exemplo.com.br.crt | openssl md5
openssl rsa  -noout -modulus -in exemplo.com.br.key | openssl md5
```

### Conferir se a SAN cobre o apex, o www e até quando vale

```bash
openssl x509 -noout -subject -dates -ext subjectAltName -in exemplo.com.br.crt
```

Confira se `www` e o apex estão ambos na SAN quando o site usa os dois, e anote a data de expiração para a agenda de renovação. É aqui que você descobre se a CA respeitou a SAN do CSR ou usou apenas a lista do pedido.

### Conferir se o servidor entrega a cadeia completa no handshake

Este é o teste que pega o CABUNDLE faltando. Rode de uma máquina que não visitou o site antes, ou de um servidor:

```bash
openssl s_client -connect exemplo.com.br:443 -servername exemplo.com.br </dev/null
```

Na saída, `Certificate chain` deve listar o seu certificado e ao menos uma intermediária. Se aparecer só o certificado do domínio, o CABUNDLE está vazio ou errado. Ao final, `Verify return code: 0 (ok)` indica cadeia validada com a trust store local.

### O teste com curl, que usa a própria trust store e não perdoa

```bash
curl -vI https://exemplo.com.br
```

O `curl` usa a própria trust store e não faz mágica de navegador. Se ele reclama de "local issuer certificate", o gateway do cliente vai reclamar também. Teste também o host alternativo (`https://www.exemplo.com.br`) e, se o site tem subdomínio de API ou painel, teste cada um.

## Checklist de 14 itens para o handoff do certificado

Cole isto no card do projeto e marque item por item. A ideia é que qualquer pessoa do time execute sem perguntar nada.

| # | Item | Como confirmar | Feito |
|---|---|---|---||
| 1 | CN e SAN combinados com o cliente | Lista de hosts aprovada por escrito |  |
| 2 | CSR gerado com organização, endereço e SAN corretos | `openssl req -noout -text -in .csr` |  |
| 3 | Chave privada armazenada no painel ou em cofre de senhas | Nunca em e-mail, anexo ou repositório |  |
| 4 | Validação da CA concluída (DNS, e-mail ou arquivo) | E-mail de emissão recebido |  |
| 5 | CRT no campo do certificado, sozinho | Um bloco só |  |
| 6 | Intermediárias no CABUNDLE, na ordem | Blocos com Subject da CA |  |
| 7 | Par chave/certificado confere | Dois `md5` iguais |  |
| 8 | SAN do certificado emitido cobre todos os hosts | `-ext subjectAltName` no `x509` |  |
| 9 | Cadeia completa no handshake | `Verify return code: 0` no `s_client` |  |
| 10 | `curl -vI` sem erro nos hosts principais | Todos os hosts testados |  |
| 11 | Redirecionamento para HTTPS ativo | Requisição em `http://` responde 301 |  |
| 12 | Conteúdo misto corrigido no WordPress | URLs do site em `https` e console sem aviso |  |
| 13 | Data de expiração na agenda, com lembrete 30 dias antes | Evento criado com o domínio no título |  |
| 14 | Documento de handoff entregue ao cliente | CA, tipo de certificado, hosts cobertos, data de expiração, política de reemissão |  |

Dois itens merecem atenção de quem cuida de WordPress. O passo 12 é o que gera chamado no dia seguinte: certificado instalado, cadeado ausente porque uma imagem ou um script ainda carrega em `http`. E o passo 13 é o que separa agência de improviso: certificado pago não renova sozinho, e o cliente descobre o vencimento pelo próprio cliente dele.

## O que cada mensagem de erro significa e qual é a ação

| Sintoma | Causa provável | Ação |
|---|---|---||
| cPanel recusa a instalação dizendo que a chave não corresponde | Certificado emitido a partir de outro CSR | Compare os módulos; se divergirem, peça reemissão à CA com o CSR correto |
| Cadeado no Chrome, erro em app Android antigo ou Java | CABUNDLE vazio ou fora de ordem | Cole as intermediárias da CA e revalide com `s_client` |
| `unable to get local issuer certificate` no `curl` | Mesma causa acima | Idem |
| Erro de nome (`NET::ERR_CERT_COMMON_NAME_INVALID`) | Acesso por host que não está no CN nem na SAN | Reemitir incluindo o host, ou redirecionar o host para o coberto |
| Certificado instalado, site continua em `http` | Falta redirecionamento ou URL do site ainda em `http` | Ajuste o redirecionamento e as URLs do WordPress |
| Cadeado com aviso de conteúdo misto | Recursos internos em `http` | Corrija as URLs no banco e nos temas, não só na configuração |
| Gateway específico recusa, navegadores aceitam | Trust store própria do parceiro, ou cadeia incompleta | Confirme a cadeia primeiro; se estiver completa, peça ao parceiro a lista de CAs aceitas |

Uma observação sobre reemissão: a política varia por CA e por revenda, e não há regra única. Antes de comprar, localize no contrato ou nos termos da CA se há reemissão dentro da validade, em quais condições e com que custo, e registre essa informação no documento de handoff. Assim ninguém promete reemissão gratuita ao cliente sem base. Mesmo quando a reemissão é prevista, ela custa o tempo de uma nova validação, e é justamente isso que o passo 2 do checklist existe para evitar.

## A frase pronta para explicar ao cliente

Quando o certificado está tecnicamente certo e o problema era a cadeia, o cliente precisa de uma explicação que não pareça desculpa. Use esta, adaptando o exemplo do dispositivo:

> **** "O certificado do site é o mesmo para todo mundo e está correto. O que faltava era um arquivo intermediário, a identificação de quem emitiu o certificado. Navegadores modernos conseguem buscar esse arquivo sozinhos, e por isso funcionava no seu celular. Sistemas mais antigos e integrações, como o computador do financeiro e o sistema de pagamento, não buscam: eles esperam que o servidor entregue. Instalamos esse arquivo no servidor. Agora todos os dispositivos recebem a cadeia completa, sem ninguém precisar mexer no próprio computador."

E quando o cliente pergunta por que comprar se existe gratuito, a resposta honesta também cabe em uma frase: a criptografia é a mesma, o que muda é a validação da empresa e a exigência de terceiros. Se o contrato dele com o banco ou com o cliente corporativo não pede validação de organização, o gratuito atende.

## Como padronizar certificados em uma carteira de sites

Quem cuida de vários sites não deve tratar cada certificado como projeto único. Três decisões cortam a maior parte do trabalho recorrente:

- **Separe a carteira em dois grupos.** Sites sem exigência externa ficam no certificado gratuito com renovação automática do painel, e saem da sua agenda. Só os que têm exigência contratual entram no fluxo pago descrito aqui.
- **Mantenha uma planilha única de vencimentos** com domínio, CA, tipo (DV, OV, wildcard), hosts cobertos, política de reemissão e data de expiração. Cada instalação nova alimenta a planilha no mesmo dia, não na semana seguinte.
- **Padronize o teste de aceite.** Os quatro comandos desta página (`modulus`, `x509 -ext subjectAltName`, `s_client`, `curl -vI`) sempre na mesma ordem, sempre antes de avisar o cliente. É o que impede que o erro de cadeia ou de host faltante chegue ao financeiro dele antes de chegar a você.

E, se o certificado for reaproveitado em mais de um servidor, decida desde o início onde a chave privada mora. Chave privada que circula em anexo de e-mail é um incidente esperando data.

