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.

Resposta curta: 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.
Neste artigo
- Quando o certificado pago se justifica e quando o gratuito resolve
- Gerar chave e CSR com os dados que a CA vai validar
- O que vai em cada uma das três caixas: CRT, KEY e CABUNDLE
- Por que o Chrome mostra cadeado e o gateway de pagamento recusa
- Quatro verificações que não dependem de navegador
- Checklist de 14 itens para o handoff do certificado
- O que cada mensagem de erro significa e qual é a ação
- A frase pronta para explicar ao cliente
- Como padronizar certificados em uma carteira de sites
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 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 |
| 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:
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:
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, 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 (
curlem 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.
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
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:
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
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:
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.
Referências
- Documentação oficial (cpanel) — SSL/TLS Wizard (cPanel). Consultado em 2026-09-16.