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.

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
- DNS certo, redirecionamento certo, certificado recusado: como reconhecer o sintoma
- Por que o subdomínio herda o CAA do apex e quando para de herdar
- Onde criar issue, issuewild e iodef no Zone Editor do cPanel
- Cada CA publica a string exata, e grafar diferente é não autorizar
- Como conferir com dig qual valor ficou valendo antes de reemitir
- Os quatro erros de escrita que travam a emissão
- Checklist para auditar o CAA de uma carteira de domínios
- 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:
- Consulta
loja.exemplo.com.br. Se houver CAA, usa esse conjunto e para. - Se não houver, consulta
exemplo.com.br. Se houver CAA, usa esse. - 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:
- Subdomínio herda o CAA do apex. Um CAA errado no apex derruba a renovação de todos os subdomínios que não têm CAA próprio.
- CAA no subdomínio sobrescreve o apex inteiro. Não soma, substitui. Se você põe
issue "letsencrypt.org"emloja, oissue "sectigo.com"do apex deixa de valer paraloja. - Zona sem CAA nenhum é permissiva. Ausência de registro não bloqueia nada. Se você não precisa restringir, não crie o registro só por hábito.
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:
- Se existe
issuewild, só ele vale para o curinga. Oissueé ignorado para wildcard. - Se não existe
issuewild, oissuetambém serve para o curinga. issuewild ";"proíbe qualquer curinga, mesmo comissueliberando a CA.
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.
dig CAA dominio.com.br +shortno apex. Anote o retorno, inclusive quando for vazio.- Se vazio, decida: deixar sem CAA (permissivo, válido) ou criar restringindo à CA que você realmente usa.
- Se preenchido, compare a string com a página de CAA da CA que emite hoje.
- Se o site usa curinga, confirme que existe
issuewildcom a mesma CA, ou que não existeissuewildnenhum. - Rode
dig CAAnos subdomínios que têm certificado próprio (loja,app,mail). Qualquer CAA ali sobrescreve o apex. - Confirme que os NS consultados são os mesmos onde você editou a zona.
- 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
- Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.