Registro CAA bloqueando o SSL: 5 erros e o diagnóstico
Como ler issue e issuewild do jeito que a autoridade certificadora lê, confirmar por consulta pública qual valor ficou valendo e corrigir antes de pedir reemissão.

Resposta curta: um registro CAA mal escrito recusa a emissão sem gerar erro na zona. Leia com `dig CAA` o nome exato que falhou, suba até o apex (o primeiro nome com CAA encerra a busca), corrija valor, flag e aspas, e só então peça a reemissão.
Neste artigo
- O que a CA consulta antes de emitir e por que ela para no primeiro CAA
- issue contra issuewild: onde o exemplo copiado quebra
- Os 5 erros de digitação que recusam a emissão
- Confirmar com dig CAA o valor que a autoridade realmente vê
- Valores corretos das CAs mais usadas
- Corrigindo o registro CAA no Zone Editor do cPanel
- Como explicar ao cliente que o bloqueio está no DNS dele
Um registro CAA publicado e escrito errado não dá erro em lugar nenhum. A zona carrega, o site abre, o DNS responde. O único sintoma é a autoridade certificadora recusando a emissão, e a recusa aparece como falha genérica de SSL no painel. Quem mantém dez, trinta, cem sites de clientes vê isso como "o AutoSSL não renovou" e abre um chamado na hospedagem. Quando a causa é CAA, a correção costuma estar no DNS do cliente, não no servidor.
Este guia é de diagnóstico: ler o que já está publicado, confirmar por consulta pública qual valor ficou valendo para o nome exato que falhou, corrigir, e só então pedir reemissão.
O que a CA consulta antes de emitir e por que ela para no primeiro CAA
A regra que importa para o diagnóstico é a subida na árvore: antes de emitir para loja.cliente.com.br, a CA consulta CAA nesse nome exato. Se não houver nenhum registro CAA ali, ela sobe para cliente.com.br. E assim por diante até o topo.
Duas consequências práticas que explicam quase todo caso de recusa:
- O primeiro nome que tiver CAA encerra a busca. Se existe CAA em
loja.cliente.com.brcom uma CA que não é a sua, o CAA correto do apex é irrelevante. Não há soma, há substituição. - Ausência de CAA é permissão. Zona sem CAA nenhum deixa qualquer CA emitir. Por isso a solução de emergência, quando o cliente não sabe de onde veio o registro, é remover o CAA, emitir, e republicar depois com o valor certo.
As propriedades que você vai ler são três: issue (emissão de certificado para o nome), issuewild (emissão de curinga, *.dominio) e iodef (endereço para onde a CA reporta violação). iodef nunca bloqueia emissão.
issue contra issuewild: onde o exemplo copiado quebra
A relação entre as duas tags é assimétrica e é aqui que o leitor erra ao colar um exemplo pronto.
| Situação na zona | Certificado simples | Certificado curinga |
|---|---|---|
| Nenhum CAA | permitido | permitido |
issue "letsencrypt.org" apenas |
permitido para Let's Encrypt | permitido para Let's Encrypt (herda do issue) |
issue "letsencrypt.org" + issuewild ";" |
permitido | proibido para todas |
issuewild "letsencrypt.org" apenas |
permitido para qualquer CA | permitido para Let's Encrypt |
issue ";" |
proibido para todas | proibido para todas |
A linha que mais gera confusão: alguém copiou um exemplo de endurecimento com issuewild ";" para bloquear curinga, e meses depois o cliente contratou um plano com subdomínios curinga. O certificado simples renova, o curinga não. O painel mostra apenas falha.
A quarta linha é o inverso: publicar só issuewild não restringe nada no certificado comum. Quem queria travar a zona não travou.
Os 5 erros de digitação que recusam a emissão
Todos aparecem como zona válida. Nenhum gera aviso no editor.
- URL em vez de nome da CA.
https://letsencrypt.orgouletsencrypt.org/não casa com nada. O valor é o nome de domínio da CA, sem esquema e sem barra final. - Aspas no lugar errado. O valor da propriedade é uma string entre aspas. Dependendo do painel, você digita o valor sem aspas num campo próprio e a interface as adiciona. Colar
"letsencrypt.org"num campo que já faz isso produz aspas duplicadas gravadas no dado. - Flag errada. O campo flags aceita
0ou128. Com128(critical) numa tag que a CA não entende, ela é obrigada a recusar a emissão. Paraissueeissuewilduse0. - Espaço antes ou depois do valor.
letsencrypt.orgcom espaço inicial vira um nome que não existe. Comparação é literal. - Ponto e vírgula solto.
issue ";"significa "nenhuma CA pode emitir". Alguém que quis separar duas CAs com;numa linha só (letsencrypt.org;sectigo.com) criou um valor inválido. Duas CAs permitidas são dois registros CAA separados, cada um com uma propriedadeissue.
Confirmar com dig CAA o valor que a autoridade realmente vê
Não confie no que o painel mostra. Confie no que o resolvedor público devolve, porque é o que a CA vê. Comece pelo nome exato que falhou, não pelo apex.
# nome exato que falhou
dig CAA loja.exemplo.com.br +short
# subindo a árvore
dig CAA exemplo.com.br +short
dig CAA com.br +short
Saída típica de uma zona correta no apex (exemplo fictício):
0 issue "letsencrypt.org"
0 iodef "mailto:[email protected]"
Se a primeira consulta devolver qualquer linha, a busca para ali: é esse o conjunto que vale, e o apex não é consultado. Se devolver vazio, o valor efetivo é o da linha de cima que responder primeiro.
Para ver o registro cru, incluindo aspas duplicadas e espaço, use a forma longa:
dig CAA loja.exemplo.com.br
Um valor com aspas duplicadas ou com https:// fica visível na seção ANSWER. Compare caractere a caractere com a lista de erros acima.
Quando a resposta vem do cache e não da zona corrigida
Depois de corrigir, o TTL antigo continua valendo nos resolvedores. Consulte direto no servidor autoritativo para separar "não propagou" de "não corrigi":
dig NS exemplo.com.br +short
dig CAA exemplo.com.br @ns1.servidor-autoritativo.com +short
Se o autoritativo já mostra o valor certo e o resolvedor público ainda não, é só esperar o TTL. Pedir reemissão nesse intervalo gera uma segunda falha e, em algumas CAs, consome tentativa de rate limit.
Valores corretos das CAs mais usadas
O valor é sempre o nome de domínio identificador publicado pela própria CA. Confira na documentação da CA que o seu painel usa antes de publicar.
| Autoridade | Valor em `issue` / `issuewild` |
|---|---|
| Let's Encrypt | letsencrypt.org |
| Sectigo | sectigo.com |
| Comodo CA (legado Sectigo) | comodoca.com |
| DigiCert | digicert.com |
| GlobalSign | globalsign.com |
| Google Trust Services | pki.goog |
| Proibir tudo | ; |
O AutoSSL do cPanel pode estar configurado com o provedor Let's Encrypt ou com o provedor da própria cPanel, que emite por Sectigo. Se você usa os dois provedores entre seus clientes, o caminho seguro é publicar os dois registros issue que você usa de fato, e não um só. Dois registros, não um valor com vírgula.
Corrigindo o registro CAA no Zone Editor do cPanel
O Zone Editor do cPanel lista e edita CAA pela interface Domains > Zone Editor, conforme a documentação oficial do cPanel. Ao adicionar o registro, você preenche nome, TTL, flag, tag e valor em campos separados.
Ordem de execução que evita retrabalho
- Rode
dig CAAno nome exato que falhou e anote o que está valendo. - Se o bloqueio vier de um CAA em subdomínio que ninguém lembra de ter criado, decida: remover o registro do subdomínio (volta a herdar o apex) ou corrigi-lo no próprio subdomínio.
- Corrija ou remova. Não acumule registros "por garantia": cada
issuea mais é uma CA a mais autorizada. - Baixe o TTL do CAA para um valor curto antes de uma janela de mudança prevista, e volte depois.
- Reconsulte pelo autoritativo e depois por um resolvedor público.
- Só então peça a reemissão do SSL.
Se o DNS não está na hospedagem
É comum o domínio estar apontado para Cloudflare, Registro.br ou o painel de uma agência anterior. O Zone Editor do cPanel só edita a zona se o servidor for autoritativo para ela. Confirme com dig NS antes de perder tempo editando uma zona que ninguém consulta.
Como explicar ao cliente que o bloqueio está no DNS dele
A conversa difícil é que o site está sem cadeado e a hospedagem não é a culpada. Frase pronta, para colar no e-mail:
Para padronizar em vários sites, guarde um script simples que percorre a lista de nomes e imprime o CAA publicado em cada um:
while read -r d; do
printf '%s: ' "$d"
dig CAA "$d" +short | tr '\n' ' '
echo
done < dominios.txt
O arquivo dominios.txt tem um domínio por linha. Saída vazia significa nenhum CAA publicado, que é permissivo e não bloqueia emissão. O que você procura é a linha com valor inesperado: uma CA que você não usa, um ;, ou um nome com https:// grudado. O limite é esse: o script lê apenas o nome que está na lista. Como um CAA em subdomínio encerra a busca, inclua no dominios.txt também os hostnames que recebem certificado (loja.exemplo.com.br, webmail.exemplo.com.br), e não só o apex. Rodar isso uma vez por trimestre custa minutos e antecipa a falha antes de o cliente ver o aviso no navegador.
Referências
- Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.