blog
Domínios e DNS

SSL gratuito não renova? Olhe o registro CAA da zona

Como interpretar flag, tag e domínio da CA no registro já publicado, corrigir a linha sem apagar o controle do cliente e auditar a carteira inteira em um comando.

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

Resposta curta: um registro CAA já publicado na zona, com a tag issue autorizando só uma CA antiga ou com issuewild restritivo, faz a CA recusar a renovação antes de validar o domínio. A correção é acrescentar a linha issue da CA atual no Zone Editor, sem apagar as existentes.

Neste artigo
  1. O site não mudou, o DNS está certo e o AutoSSL para de renovar
  2. O que significa cada campo de flag, tag e valor no CAA
  3. Três configurações de CAA que recusam a renovação
  4. Consultando o nome exato e cada rótulo pai até o TLD
  5. Acrescentar a sua CA sem remover a lista que já existe
  6. Auditando CAA em uma carteira inteira com um loop de dig
  7. Como explicar a recusa ao cliente por escrito

O site não mudou, o DNS está certo e o AutoSSL para de renovar

O caso típico de carteira herdada é este: o site está no ar há meses, ninguém tocou em DNS nem em plugin, e um dia o AutoSSL começa a falhar com mensagem de que a autoridade certificadora não está autorizada a emitir para aquele domínio. O certificado anterior continua válido até expirar, então o problema só aparece no navegador semanas depois, quando o cliente liga.

Na maioria das vezes que isso acontece sem alteração recente, a causa está em um registro CAA já publicado na zona, criado em outra época por outra agência, autorizando uma CA que não é a que está tentando renovar agora. O registro está fazendo exatamente o que foi pedido: bloqueando quem não foi listado.

Antes de apagar qualquer coisa, leia o que está publicado. Apagar o CAA resolve a renovação e joga fora o controle que o cliente (ou o compliance dele) talvez queira manter.

O que significa cada campo de flag, tag e valor no CAA

O valor de um registro CAA tem três partes, nesta ordem: flag, tag e valor entre aspas.

example.com.  3600  IN  CAA  0 issue "letsencrypt.org"
example.com.  3600  IN  CAA  0 issuewild "letsencrypt.org"
example.com.  3600  IN  CAA  0 iodef "mailto:[email protected]"
Campo Valor no exemplo O que significa
Flag 0 Nenhum bit crítico ligado. Com 128, o bit "issuer critical" está ligado: uma CA que não entenda a tag deve recusar a emissão em vez de ignorar a linha
Tag issue Autoriza a CA indicada a emitir certificados para o nome
Tag issuewild Autoriza (ou nega) emissão de certificado wildcard para o nome
Tag iodef Endereço para a CA relatar pedido de emissão não autorizado. Não bloqueia nada
Valor "letsencrypt.org" Identificador que a CA publica como seu. Não é o nome comercial, é o domínio documentado pela CA

Três regras de leitura que resolvem quase toda auditoria:

O valor ";" (ponto e vírgula) é a negação explícita: nenhuma CA autorizada para aquela tag. É o que costuma aparecer em zona montada por quem quis "travar o SSL" e esqueceu que o AutoSSL renova sozinho a cada ciclo.

Três configurações de CAA que recusam a renovação

Uma linha issue com a CA do certificado pago que já venceu

A zona tem 0 issue "digicert.com" porque o cliente comprou um certificado pago em 2021. O certificado pago venceu, o site migrou para AutoSSL, e a linha ficou. A CA do AutoSSL consulta o CAA, não se encontra na lista e recusa antes mesmo de tentar validar o domínio. O erro não menciona DNS quebrado porque o DNS está perfeito.

O certificado simples emite e o wildcard falha por causa do issuewild

A emissão do certificado simples funciona, a do wildcard falha, e o log mostra falha só nos subdomínios. Procure por issuewild ";" ou por issuewild apontando para outra CA.

O CAA do domínio raiz vale para o subdomínio que não tem o seu

Se não existe CAA no nome exato, a CA sobe um rótulo por vez até achar um conjunto de registros. Um issue publicado em cliente.com.br vale para loja.cliente.com.br enquanto o subdomínio não tiver CAA próprio. Em carteira com subdomínio de staging e de loja, é comum a falha aparecer só em um nome e todo mundo procurar no lugar errado.

Consultando o nome exato e cada rótulo pai até o TLD

Consulte o nome exato que está falhando e depois cada rótulo pai, um a um, até o TLD:

dig +short CAA loja.cliente.com.br
dig +short CAA cliente.com.br
dig +short CAA com.br
dig +short CAA br

A primeira consulta que devolver registro encerra a busca: é esse conjunto que a CA vai aplicar. Resposta vazia só permite concluir que não há CAA depois de checar todos os rótulos pais, inclusive o TLD. E vazio não é sempre ausência: se a consulta retornar SERVFAIL (rode sem o +short para ver o status), a saída também vem em branco, e aí o que você tem é um problema de DNS, não um domínio sem CAA. Se vier algo, compare com o identificador que a sua CA publica.

Para auditar uma carteira inteira de uma vez, coloque um domínio por linha em dominios.txt:

while read -r d; do
  printf '%-35s %s\n' "$d" "$(dig +short CAA "$d" | tr '\n' ' ')"
done < dominios.txt

A saída cabe em uma tela: domínio à esquerda, CAA à direita, linha vazia onde não há registro. Guarde esse arquivo como estado anterior antes de qualquer alteração.

Se desconfiar de cache, consulte o servidor autoritativo do domínio em vez do resolvedor local, com dig CAA cliente.com.br @ns1.exemplo-do-provedor.com. O que a CA vê é o autoritativo, não o seu resolvedor.

Ordem de consulta do CAA até o TLDConsulte o nome exatodig +short CAA loja.cliente.com.brVazio? Suba um rótulocliente.com.br, depois com.br, depois brPrimeira resposta encerra a buscaÉ esse conjunto que a CA aplicaSem +short, confira o statusSERVFAIL também devolve saída vaziaCompare com o ID da sua CAIdentificador publicado pela própria CA
A CA sobe um rótulo por vez até achar registro CAA. Vazio só conclui ausência depois de checar o TLD.

Acrescentar a sua CA sem remover a lista que já existe

O conserto é acrescentar a CA que vai emitir, não remover a lista. No cPanel, o caminho é Zone Editor, em Domains, que permite adicionar e editar registros CAA da zona pela interface, conforme a documentação oficial do cPanel.

Onde achar o identificador que a CA publica para a tag issue

CA Identificador usado na tag issue
Let's Encrypt letsencrypt.org
Sectigo (uma das CAs que o AutoSSL do cPanel pode usar) sectigo.com
Qual CA o seu servidor usa Depende da configuração do AutoSSL naquele servidor, verificável no painel antes de escrever a linha
Outras Verifique na documentação da própria CA: o identificador é publicado por ela e não se deduz do nome comercial

Criando o registro issue no Zone Editor do cPanel

No Zone Editor, crie um registro CAA para o nome que está falhando com flag 0, tag issue e o identificador da CA. Mantenha as linhas antigas se o cliente ainda usa aquela CA em outro serviço.

Quando adicionar issuewild e quando deixar ausente

Se o site usa *.dominio e existe um issuewild na zona, adicione também 0 issuewild "<sua-ca>". Se não existe nenhum issuewild, não crie: a ausência já herda o issue.

Esperar o TTL antes de pedir a reemissão

Rode de novo o dig +short CAA e confira que a linha nova aparece. Respeite o TTL do registro anterior: pedir reemissão enquanto o valor antigo ainda está em cache do resolvedor da CA gera uma segunda falha e confunde o diagnóstico. Se o TTL estiver alto, baixe antes, espere, altere.

O que anotar no checklist para a próxima pessoa não apagar tudo

Salve no checklist do cliente qual linha existia, qual foi acrescentada e por quê. É o que evita que a próxima pessoa apague o CAA inteiro no próximo incidente.

Conserto do CAA sem apagar a lista existenteSalvar estado anteriorGuarde as linhas que já existemAcrescentar issue da sua CAZone Editor, flag 0, tag issueAvaliar issuewildSó adicione se já existir umEsperar o TTLCache antigo gera segunda falhaPedir reemissão e anotarRegistre o que mudou e por quê
Acrescentar, nunca apagar a lista existente. O cliente pode depender da CA antiga em outro serviço.

Auditando CAA em uma carteira inteira com um loop de dig

  1. Monte dominios.txt com todos os domínios e subdomínios que têm certificado emitido, não só os domínios raiz.
  2. Rode o loop de dig e salve a saída datada.
  3. Marque todo domínio com linha issue que não contenha o identificador da CA que você usa.
  4. Marque todo domínio com issuewild ";" que sirva subdomínio por wildcard.
  5. Para cada marcado, confirme com o cliente se a CA antiga ainda é usada em algum serviço (balanceador, CDN, e-mail com certificado próprio).
  6. Acrescente a linha issue da sua CA, preservando as demais.
  7. Confira o TTL antes de disparar a reemissão.
  8. Reexecute o loop uma semana depois e compare com a saída datada.

Dois atalhos que valem o tempo: padronize o TTL do CAA em um valor baixo nos domínios que você administra, para que correção futura propague rápido, e inclua a checagem de CAA no seu processo de onboarding de site herdado, junto com a conferência de nameserver e de registro MX.

Como explicar a recusa ao cliente por escrito

Use isto, por escrito, antes que alguém diga que o site "caiu do nada":

Se o cliente perguntar por que isso não apareceu antes: o certificado vigente continua válido até a data de expiração, e a recusa só se torna visível no navegador quando a renovação falha até o vencimento. É por isso que vale auditar o CAA no momento em que você assume a carteira, e não quando o cadeado some.

Referências

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