blog
Domínios e DNS

Como criar registro CAA no DNS sem quebrar o SSL

Como publicar o CAA no Zone Editor do cPanel, qual string corresponde a cada Autoridade Certificadora e como aplicar a mesma linha em dezenas de domínios sem quebrar a renovação do SSL.

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

Resposta curta: um registro CAA tem três campos: flags (use 0), tag (issue, issuewild ou iodef) e valor, que é o identificador da CA, como letsencrypt.org ou sectigo.com. Publique-o no Zone Editor do cPanel e confira com dig CAA antes de pedir qualquer reemissão.

Neste artigo
  1. O que o CAA bloqueia e o que ele libera
  2. Flags, tag e valor: o que preencher em cada campo
  3. O identificador exato de cada CA, letra por letra
  4. Publicando o CAA no Zone Editor do cPanel
  5. Confira com dig antes de pedir reemissão
  6. Como manter 40 domínios com o CAA certo
  7. O que dizer ao cliente quando o certificado não renova
  8. Fontes

O que o CAA bloqueia e o que ele libera

O CAA é um registro de DNS que lista quais Autoridades Certificadoras podem emitir certificado para aquele domínio. A consulta ao CAA antes da emissão é exigida dos emissores públicos pelos Baseline Requirements do CA/Browser Forum, que adotam o processamento descrito na RFC 8659. Se a zona tem CAA e a CA que pediu não está na lista, a emissão é recusada, mesmo com o domínio validado e o DNS apontando certo.

Se não existe nenhum CAA na zona, qualquer CA pode emitir. É o estado padrão da maioria dos domínios e não é inseguro por si: é apenas permissivo. Publicar CAA é fechar essa porta de propósito, e por isso ele só deve ser criado quando você sabe qual CA a hospedagem do cliente usa.

O contrato básico: CAA ausente = tudo liberado. CAA presente = só o que estiver escrito.

Flags, tag e valor: o que preencher em cada campo

No Zone Editor do cPanel, criar um CAA pede três campos além do nome e do TTL (documentação cPanel, Zone Editor).

Campo Valores usuais O que significa na prática
Flags 0 Bit crítico desligado. A CA pode ignorar tags que não entende.
Flags 128 Bit crítico ligado. CA que não entender a tag deve recusar a emissão.
Tag issue Autoriza certificado para o nome e subdomínios, inclusive wildcard, enquanto não houver issuewild na zona.
Tag issuewild Autoriza certificado wildcard (*.dominio.com.br).
Tag iodef Endereço para a CA relatar pedido não autorizado (mailto: ou https:).
Valor domínio da CA ou ; Identificador da CA, ou ponto e vírgula para proibir qualquer emissão.

Use 0 em flags salvo instrução contrária da CA. O valor 128 com uma tag que a CA não implementa faz a emissão falhar em silêncio do seu lado e vira caça ao fantasma depois.

Por que publicar issuewild desliga a regra do issue

issue sozinho já cobre certificado wildcard. Mas, no momento em que você publica qualquer issuewild na zona, ele passa a ser a única regra válida para wildcard, e o issue deixa de valer para esse caso. Essa precedência está na RFC 8659, seção 4.3. Consequência prática: se você vai publicar issuewild, publique-o para todas as CAs que precisam emitir wildcard, não só para uma.

Se o cliente não usa wildcard, não publique issuewild. Menos linha, menos coisa para quebrar.

O identificador exato de cada CA, letra por letra

O valor não é o site da empresa nem o nome comercial: é um identificador publicado pela própria CA, e errar uma letra é o mesmo que não autorizar.

CA Valor em `issue` / `issuewild` Onde aparece
Let's Encrypt letsencrypt.org AutoSSL de boa parte das hospedagens cPanel
Sectigo sectigo.com AutoSSL cPanel na configuração padrão e certificados pagos
DigiCert digicert.com Certificados pagos, EV/OV
Google Trust Services pki.goog Google Cloud, alguns CDNs

Antes de publicar, confirme o identificador na documentação da CA que emite para aquele cliente. CAs mudaram de nome e de identificador ao longo dos anos, e o valor antigo que você copiou de um chamado de 2019 pode não ser o aceito hoje.

O ponto cego mais comum em carteira de agência: a hospedagem do cliente usa uma CA e o CAA autoriza outra. O registro está sintaticamente perfeito, o DNS responde, e o AutoSSL recusa. CAA correto para a CA errada é indistinguível de CAA quebrado, do ponto de vista do certificado.

Publicando o CAA no Zone Editor do cPanel

Descubra qual CA emite o certificado hoje

Antes de escrever qualquer coisa, abra o certificado atual no navegador e leia o emissor, ou peça ao provedor. Se o site ainda não tem certificado, pergunte ao suporte da hospedagem qual CA o AutoSSL usa. Essa checagem custa dois minutos e muda o prazo em que o erro aparece. Com AutoSSL sobre Let's Encrypt, o certificado dura 90 dias e a renovação tenta por volta dos 60: o CAA errado derruba o site do cliente em semanas. Com certificado pago anual de Sectigo ou DigiCert, nada quebra até a virada do ano, e aí ninguém mais lembra que alguém mexeu no DNS.

Monte a linha do registro, uma por CA

No cPanel, em Domains > Zone Editor, escolha Manage no domínio e depois Add Record, com o tipo CAA. Preencha nome (o domínio raiz), TTL, Flags 0, Tag issue e o valor da CA. Exemplo fictício, para um domínio atendido por Let's Encrypt:

exemplo.com.br.  3600  IN  CAA  0 issue "letsencrypt.org"

Se o cliente também compra certificado pago de outra CA, acrescente uma segunda linha em vez de trocar a primeira. CAA é lista, não valor único:

exemplo.com.br.  3600  IN  CAA  0 issue "letsencrypt.org"
exemplo.com.br.  3600  IN  CAA  0 issue "sectigo.com"

Acrescente o contato de incidente, se alguém for ler

exemplo.com.br.  3600  IN  CAA  0 iodef "mailto:[email protected]"

Use um e-mail que alguém lê. Caixa que ninguém abre é pior que nenhuma caixa.

Comece com TTL de 300 e suba depois da primeira renovação

Publique a primeira versão com TTL baixo (300 é um valor confortável) e suba para 3600 depois que a renovação passar limpa. Com TTL alto, um valor errado fica congelado em resolvers por horas, e a janela de reemissão do cliente passa.

Publicar CAA sem derrubar a renovaçãoIdentifique a CALeia o emissor do certificado atualMonte a linhaFlags 0, tag issue, valor da CAPublique com TTL baixo300 segundos na primeira versãoConfira com digResolver local e resolver públicoSuba o TTL3600 após renovação limpa
Ordem de publicação do CAA no Zone Editor do cPanel.

Confira com dig antes de pedir reemissão

Pedir reemissão com o CAA errado só gera uma segunda falha. Confira primeiro:

dig CAA exemplo.com.br +short

E contra um resolver público, para fugir de cache local:

dig @1.1.1.1 CAA exemplo.com.br +short

A saída esperada tem a forma 0 issue "letsencrypt.org". Três resultados possíveis:

Vale lembrar que a consulta de CAA sobe na árvore, conforme o algoritmo de relevant resource record set da RFC 8659, seção 3: se não há CAA em blog.exemplo.com.br, a CA consulta exemplo.com.br. Um CAA restritivo no domínio raiz governa todos os subdomínios que não tiverem o seu próprio.

Três leituras possíveis do dig CAASaída vaziaSem CAA na zona, problema é outroValor diferente do esperadoAguarde propagação ou corrija a linhaValor certoPeça reemissão ou dispare o AutoSSL
Como ler a saída de dig CAA antes de pedir reemissão.

Como manter 40 domínios com o CAA certo

O erro de agência não é publicar CAA errado em um domínio. É publicar certo em um e esquecer dos outros 40.

while read d; do printf '%s: ' "$d"; dig CAA "$d" +short; echo; done < dominios.txt

O que dizer ao cliente quando o certificado não renova

Quando o certificado para de renovar por causa de CAA, o cliente vê "site não seguro" e supõe invasão. Use uma frase que explique sem assustar:

E quando o cliente pergunta se vale a pena criar CAA onde não existe: vale, desde que alguém mantenha a lista. CAA é uma trava, e trava sem chave guardada no lugar certo tranca você junto. Em carteira pequena sem processo de documentação, deixar a zona sem CAA é uma decisão defensável. Em carteira grande com padrão escrito, publicar é o certo.

Fontes

Referências

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