blog
Painéis

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.

JR · · 10 min de leitura · 4 tabelas · 6 blocos de código

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
  1. Quando o certificado pago se justifica e quando o gratuito resolve
  2. Gerar chave e CSR com os dados que a CA vai validar
  3. O que vai em cada uma das três caixas: CRT, KEY e CABUNDLE
  4. Por que o Chrome mostra cadeado e o gateway de pagamento recusa
  5. Quatro verificações que não dependem de navegador
  6. Checklist de 14 itens para o handoff do certificado
  7. O que cada mensagem de erro significa e qual é a ação
  8. A frase pronta para explicar ao cliente
  9. 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:

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.

Decidir entre certificado pago e gratuitoPolítica de CA aprovadaCliente corporativo exige emissor específicoGateway com trust store própriaBanco ou integrador recusa outrosWildcard fora do painelMesmo certificado em CDN ou balanceadorGarantia contratual em complianceExigida por escrito no processoNenhuma das quatroAtive o gratuito e encerre
Se nenhuma das quatro primeiras linhas se aplica, o certificado gratuito do painel entrega a mesma criptografia.

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:

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:

  1. 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.
  2. Ordem importa no CABUNDLE. Primeiro a intermediária que assinou o seu certificado, depois a que assinou aquela, e assim por diante.
  3. 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:

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.

Quatro verificações fora do navegadorPar chave e certificadoDois md5 de modulus iguaisSAN e validadeApex, www e data de expiraçãoCadeia no handshakes_client com Verify return code 0Trust store do curlcurl -vI em cada host
Ordem fixa do teste de aceite, sempre antes de avisar o cliente. Nenhuma etapa depende de navegador.

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:

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

  1. Documentação oficial (cpanel) — SSL/TLS Wizard (cPanel). Consultado em 2026-09-16.
Leia também