# 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.

> 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.

João Rizzon · 2026-11-09 · Domínios e DNS

---

## 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](https://cabforum.org/working-groups/server/baseline-requirements/documents/), que adotam o processamento descrito na [RFC 8659](https://www.rfc-editor.org/rfc/rfc8659.html). 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](https://docs.cpanel.net/cpanel/domains/zone-editor/122/)).

| 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](https://www.rfc-editor.org/rfc/rfc8659.html#section-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:ssl@exemplo.com.br"
```

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](https://www.rfc-editor.org/rfc/rfc8659.html#section-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:

> **** O domínio tem uma regra de segurança no DNS que lista quais empresas podem emitir o certificado do site. A empresa que emite o nosso certificado hoje não estava nessa lista, então a renovação foi recusada. Já corrigimos a lista e vamos reemitir o certificado. Nenhum dado foi exposto e o site não foi invadido.

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](https://docs.cpanel.net/cpanel/domains/zone-editor/122/), consultado em 29/10/2026.
- IETF, [RFC 8659, DNS Certification Authority Authorization (CAA) Resource Record](https://www.rfc-editor.org/rfc/rfc8659.html), consultado em 29/10/2026.
- CA/Browser Forum, [Baseline Requirements for the Issuance and Management of Publicly-Trusted TLS Server Certificates](https://cabforum.org/working-groups/server/baseline-requirements/documents/), consultado em 29/10/2026.

