blog
Domínios e DNS

Erro de CAA: por que o SSL não emite com o DNS certo

Onde escrever issue e issuewild no Zone Editor, como a checagem sobe do subdomínio até o apex, e os quatro erros de escrita que fazem o registro recusar emissão.

JR · · 8 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: quando a emissão falha mesmo com DNS e redirecionamento corretos, quase sempre existe um registro CAA na zona autorizando outra autoridade certificadora. A CA é obrigada a consultar o CAA e recusar se não estiver listada. Confira com `dig CAA dominio.com.br +short` antes de pedir reemissão.

Neste artigo
  1. DNS certo, redirecionamento certo, certificado recusado: como reconhecer o sintoma
  2. Por que o subdomínio herda o CAA do apex e quando para de herdar
  3. Onde criar issue, issuewild e iodef no Zone Editor do cPanel
  4. Cada CA publica a string exata, e grafar diferente é não autorizar
  5. Como conferir com dig qual valor ficou valendo antes de reemitir
  6. Os quatro erros de escrita que travam a emissão
  7. Checklist para auditar o CAA de uma carteira de domínios
  8. A explicação para o cliente, sem usar a palavra CAA na primeira frase

DNS certo, redirecionamento certo, certificado recusado: como reconhecer o sintoma

O caso é sempre parecido. O A do domínio aponta para o servidor, o .well-known/acme-challenge responde 200, o site abre em HTTP, e mesmo assim o AutoSSL marca o domínio como falha ou o certbot devolve algo como CAA record for exemplo.com.br prevents issuance.

Não é DNS quebrado. É DNS funcionando exatamente como foi escrito. O registro CAA (Certification Authority Authorization) diz quais autoridades certificadoras têm permissão para emitir certificado para aquele nome. A CA é obrigada a consultar esse registro antes de emitir e a recusar se não estiver autorizada. Se a zona tem CAA e a string da sua CA não está lá, a emissão para, sem gerar nenhum erro de resolução, de HTTP ou de redirect.

Por isso esse caso escapa do checklist comum: tudo que você costuma testar passa.

Por que o subdomínio herda o CAA do apex e quando para de herdar

A CA não consulta só o nome exato que vai no certificado. Ela consulta o nome e, se não achar CAA, sobe um nível de cada vez até o topo do domínio registrado. O primeiro nível que tiver CAA é o que vale, e os níveis acima param de importar.

Para loja.exemplo.com.br:

  1. Consulta loja.exemplo.com.br. Se houver CAA, usa esse conjunto e para.
  2. Se não houver, consulta exemplo.com.br. Se houver CAA, usa esse.
  3. Se não houver em lugar nenhum, não há restrição e qualquer CA pode emitir.

Três consequências práticas para quem administra carteira de sites:

Onde criar issue, issuewild e iodef no Zone Editor do cPanel

O Zone Editor do cPanel permite adicionar, editar e remover registros da zona, incluindo CAA, direto no painel, sem acesso a shell (documentação oficial do Zone Editor).

Abrir a zona do domínio que realmente responde pelos NS

Em Domains > Zone Editor, localize o domínio e use Manage para ver os registros existentes. Filtre por tipo CAA antes de criar qualquer coisa: muita zona já tem um CAA antigo que ninguém lembra de ter criado.

Os quatro campos do formulário e o que vai em cada um

Ao adicionar um registro CAA, o formulário pede quatro campos:

Campo O que colocar Observação
Name exemplo.com.br. ou loja.exemplo.com.br. o nome que você quer restringir
Flags 0 0 é o valor normal; 128 marca a propriedade como crítica
Tag issue, issuewild ou iodef um registro por tag/valor
Value a string da CA, sem http:// e sem barra ex.: letsencrypt.org

O issue autoriza certificados para o nome. O issuewild autoriza certificados curinga (*.exemplo.com.br). O iodef só informa um contato (mailto ou URL) para a CA relatar tentativas recusadas, e não autoriza nada.

Por que issuewild manda no curinga e issue deixa de valer

Esta é a parte que mais derruba renovação:

Ou seja: colocar issue "letsencrypt.org" e issuewild "sectigo.com" significa que o Let's Encrypt emite para exemplo.com.br e não emite para *.exemplo.com.br.

Cada CA publica a string exata, e grafar diferente é não autorizar

O valor do CAA é uma string literal definida pela própria autoridade. Não é o domínio do site dela por dedução, é o identificador que ela publica. Grafar diferente equivale a não autorizar.

CA Onde confirmar a string
Let's Encrypt página de CAA da própria CA; copie o identificador de lá (exemplo comum: letsencrypt.org, confirme antes de salvar)
Sectigo, DigiCert, GlobalSign, Google Trust Services, Amazon cada CA publica o identificador em sua página de CAA; copie de lá. Algumas publicam mais de uma string, incluindo a marca antiga após fusão

Não trate essa tabela como lista fechada. Antes de escrever, abra a página de CAA da CA que vai emitir e copie a string de lá. Em host compartilhado com AutoSSL, confirme no painel qual provedor está configurado: se o AutoSSL usa um provedor e o CAA autoriza outro, a emissão falha mesmo com tudo o mais correto.

Como conferir com dig qual valor ficou valendo antes de reemitir

Editar a zona e clicar em "executar AutoSSL" na sequência é desperdício de tempo. Consulte primeiro, por resolvedor público, o que o mundo está enxergando.

dig CAA exemplo.com.br +short
dig CAA loja.exemplo.com.br +short
dig @1.1.1.1 CAA exemplo.com.br +short

Um retorno típico de zona restrita:

0 issue "letsencrypt.org"
0 issuewild "letsencrypt.org"

Saída vazia no subdomínio e preenchida no apex é o comportamento esperado: a CA vai subir e usar o do apex. Se precisar ver a árvore inteira de uma vez, consulte nome por nome, do mais específico para o apex, e pare no primeiro que responder.

Propagação importa. Se o TTL da zona é alto, o resolvedor público pode devolver o valor antigo por horas. Confira direto no servidor autoritativo com dig CAA exemplo.com.br @ns1.seuprovedor.com +short e só peça reemissão quando os dois concordarem. Se o domínio usa DNS de terceiro (Cloudflare, registrador, painel do cliente), o Zone Editor do cPanel está editando uma zona que ninguém consulta: o CAA tem que ser criado onde estão os NS ativos.

Os quatro erros de escrita que travam a emissão

Aspas duplicadas pelo painel geram um valor que não bate com nada

O valor é uma string entre aspas duplas no arquivo de zona. Alguns painéis pedem só letsencrypt.org no campo e adicionam as aspas; outros esperam o valor completo. Colar "letsencrypt.org" num campo que já coloca aspas gera ""letsencrypt.org"", que não bate com nada. Depois de salvar, confira o resultado com dig e veja como a string aparece de fato.

Grafia fora da string oficial não autoriza a CA

lets-encrypt.org, letsencrypt.com, www.letsencrypt.org, https://letsencrypt.org são quatro coisas que não autorizam o Let's Encrypt. A comparação é literal. O mesmo vale para CA que mudou de marca: a string antiga pode ter deixado de ser aceita, ou a nova ainda não ter sido adicionada.

issuewild restritivo emite o domínio e recusa o curinga

Zona com issue "letsencrypt.org" e issuewild ";" emite o certificado do domínio e recusa o curinga: o issuewild presente e restritivo manda no wildcard, e o issue deixa de valer para ele. É a causa clássica de "o site funciona, mas o certificado não cobre os subdomínios". Se você usa curinga, ou remova o issuewild restritivo, ou liste nele a mesma CA.

CAA do emissor anterior quebra a renovação 60 ou 90 dias depois

Migração de hospedagem ou troca de CA. O certificado antigo ainda está válido, ninguém mexe no CAA, e o problema só aparece 60 ou 90 dias depois, quando a primeira renovação automática falha. A zona autoriza a CA antiga; a nova é recusada. Sintoma típico: "parou de renovar sozinho" sem nenhuma mudança recente no site.

Checklist para auditar o CAA de uma carteira de domínios

Rode isto uma vez por domínio e guarde o resultado numa planilha com colunas domínio, CA autorizada, tem issuewild, data da conferência.

  1. dig CAA dominio.com.br +short no apex. Anote o retorno, inclusive quando for vazio.
  2. Se vazio, decida: deixar sem CAA (permissivo, válido) ou criar restringindo à CA que você realmente usa.
  3. Se preenchido, compare a string com a página de CAA da CA que emite hoje.
  4. Se o site usa curinga, confirme que existe issuewild com a mesma CA, ou que não existe issuewild nenhum.
  5. Rode dig CAA nos subdomínios que têm certificado próprio (loja, app, mail). Qualquer CAA ali sobrescreve o apex.
  6. Confirme que os NS consultados são os mesmos onde você editou a zona.
  7. Só então peça o AutoSSL ou rode o certbot. E guarde o log da tentativa.

Dois alertas de operação. Primeiro: se você gerencia dezenas de domínios com a mesma CA, padronizar o CAA é bom, mas vira risco no dia em que precisar emitir por outra CA às pressas (certificado de validação estendida, CDN que emite o próprio, selo exigido por gateway de pagamento). Documente a decisão. Segundo: um CAA restritivo não melhora a segurança do site em si, ele reduz a superfície de emissão indevida. Se o cliente não tem essa exigência e você não controla a zona com disciplina, zona sem CAA dá menos manutenção.

A explicação para o cliente, sem usar a palavra CAA na primeira frase

Quando o cliente perguntar por que o certificado "parou de renovar sozinho", evite a palavra CAA na primeira frase.

Se precisar justificar o prazo, acrescente que a alteração no DNS leva algumas horas para valer em toda a internet e que a emissão só é tentada depois disso. É verdade e evita a cobrança de meia em meia hora.

Se o navegador bloqueia o acesso com aviso de certificado inválido enquanto você corrige, explique que o servidor e o site seguem no ar e que o aviso vem do navegador, não de uma queda da hospedagem. Muda a conversa.

Referências

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