blog
Domínios e DNS

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.

JR · · 7 min de leitura · 2 tabelas · 5 blocos de código

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
  1. O que a CA consulta antes de emitir e por que ela para no primeiro CAA
  2. issue contra issuewild: onde o exemplo copiado quebra
  3. Os 5 erros de digitação que recusam a emissão
  4. Confirmar com dig CAA o valor que a autoridade realmente vê
  5. Valores corretos das CAs mais usadas
  6. Corrigindo o registro CAA no Zone Editor do cPanel
  7. 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:

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.

Subida na árvore até o primeiro CAAloja.cliente.com.brTem CAA? Busca encerra aquicliente.com.brConsultado só se o anterior vaziocom.brÚltimo nível antes do topoNenhum CAA encontradoQualquer CA pode emitir
A CA sobe na árvore e para no primeiro nome com CAA publicado. Não há soma de registros, há substituiçã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.

  1. URL em vez de nome da CA. https://letsencrypt.org ou letsencrypt.org/ não casa com nada. O valor é o nome de domínio da CA, sem esquema e sem barra final.
  2. 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.
  3. Flag errada. O campo flags aceita 0 ou 128. Com 128 (critical) numa tag que a CA não entende, ela é obrigada a recusar a emissão. Para issue e issuewild use 0.
  4. Espaço antes ou depois do valor. letsencrypt.org com espaço inicial vira um nome que não existe. Comparação é literal.
  5. 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 propriedade issue.

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

  1. Rode dig CAA no nome exato que falhou e anote o que está valendo.
  2. 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.
  3. Corrija ou remova. Não acumule registros "por garantia": cada issue a mais é uma CA a mais autorizada.
  4. Baixe o TTL do CAA para um valor curto antes de uma janela de mudança prevista, e volte depois.
  5. Reconsulte pelo autoritativo e depois por um resolvedor público.
  6. 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.

Ordem de execução do diagnóstico CAAdig CAA no nome que falhouAnote o valor que está valendoCorrija ou removaSem registros por garantiaConfirme no autoritativoSepara cache de erro realConfirme no resolvedor públicoÉ o que a CA enxergaPeça a reemissãoSó depois das duas consultas
Pedir reemissão antes do TTL expirar gera segunda falha e consome tentativa de rate limit em algumas CAs.

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

  1. Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.
Leia também