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.

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
- O que o CAA bloqueia e o que ele libera
- Flags, tag e valor: o que preencher em cada campo
- O identificador exato de cada CA, letra por letra
- Publicando o CAA no Zone Editor do cPanel
- Confira com dig antes de pedir reemissão
- Como manter 40 domínios com o CAA certo
- O que dizer ao cliente quando o certificado não renova
- 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.
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:
- Vazio. Não há CAA na zona. Qualquer CA pode emitir. Se o certificado não sai, o problema é outro.
- Valor diferente do esperado. Ou o registro ainda não propagou, ou alguém publicou outra coisa. Confira o TTL e espere.
- Valor certo. Aí sim peça a reemissão ou dispare o AutoSSL.
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.
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.
- Agrupe por hospedagem, não por cliente. Domínios na mesma hospedagem usam a mesma CA, logo a mesma linha de CAA. Uma planilha com duas colunas (domínio, provedor) já resolve.
- Defina a linha padrão por grupo e escreva-a em um documento interno. Nada de recriar de cabeça a cada domínio novo.
- Inclua o CAA no checklist de onboarding, junto com SPF, DKIM e DMARC. Zona nova nasce completa.
- Audite em lote. Um laço de shell lendo uma lista de domínios resolve a varredura:
while read d; do printf '%s: ' "$d"; dig CAA "$d" +short; echo; done < dominios.txt
- Reaudite quando trocar de hospedagem. Migração de provedor costuma trocar a CA. O CAA antigo vira bloqueio no dia da primeira renovação, não no dia da migração, e é por isso que ninguém liga os dois eventos.
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
- cPanel, Zone Editor, consultado em 29/10/2026.
- IETF, RFC 8659, DNS Certification Authority Authorization (CAA) Resource Record, consultado em 29/10/2026.
- CA/Browser Forum, Baseline Requirements for the Issuance and Management of Publicly-Trusted TLS Server Certificates, consultado em 29/10/2026.
Referências
- Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.