# Registro CAA bloqueando o SSL: 5 erros e o diagnóstico

Como ler issue e issuewild do jeito que a autoridade certificadora lê, confirmar por consulta pública qual valor ficou valendo e corrigir antes de pedir reemissão.

> um registro CAA mal escrito recusa a emissão sem gerar erro na zona. Leia com `dig CAA` o nome exato que falhou, suba até o apex (o primeiro nome com CAA encerra a busca), corrija valor, flag e aspas, e só então peça a reemissão.

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

---

Um registro CAA publicado e escrito errado não dá erro em lugar nenhum. A zona carrega, o site abre, o DNS responde. O único sintoma é a autoridade certificadora recusando a emissão, e a recusa aparece como falha genérica de SSL no painel. Quem mantém dez, trinta, cem sites de clientes vê isso como "o AutoSSL não renovou" e abre um chamado na hospedagem. Quando a causa é CAA, a correção costuma estar no DNS do cliente, não no servidor.

Este guia é de diagnóstico: ler o que já está publicado, confirmar por consulta pública qual valor ficou valendo para o nome exato que falhou, corrigir, e só então pedir reemissão.

## O que a CA consulta antes de emitir e por que ela para no primeiro CAA

A regra que importa para o diagnóstico é a subida na árvore: antes de emitir para `loja.cliente.com.br`, a CA consulta CAA nesse nome exato. Se não houver nenhum registro CAA ali, ela sobe para `cliente.com.br`. E assim por diante até o topo.

Duas consequências práticas que explicam quase todo caso de recusa:

- **O primeiro nome que tiver CAA encerra a busca.** Se existe CAA em `loja.cliente.com.br` com uma CA que não é a sua, o CAA correto do apex é irrelevante. Não há soma, há substituição.
- **Ausência de CAA é permissão.** Zona sem CAA nenhum deixa qualquer CA emitir. Por isso a solução de emergência, quando o cliente não sabe de onde veio o registro, é remover o CAA, emitir, e republicar depois com o valor certo.

As propriedades que você vai ler são três: `issue` (emissão de certificado para o nome), `issuewild` (emissão de curinga, `*.dominio`) e `iodef` (endereço para onde a CA reporta violação). `iodef` nunca bloqueia emissão.

## issue contra issuewild: onde o exemplo copiado quebra

A relação entre as duas tags é assimétrica e é aqui que o leitor erra ao colar um exemplo pronto.

| Situação na zona | Certificado simples | Certificado curinga |
|---|---|---||
| Nenhum CAA | permitido | permitido |
| `issue "letsencrypt.org"` apenas | permitido para Let's Encrypt | permitido para Let's Encrypt (herda do issue) |
| `issue "letsencrypt.org"` + `issuewild ";"` | permitido | **proibido para todas** |
| `issuewild "letsencrypt.org"` apenas | **permitido para qualquer CA** | permitido para Let's Encrypt |
| `issue ";"` | **proibido para todas** | proibido para todas |

A linha que mais gera confusão: alguém copiou um exemplo de endurecimento com `issuewild ";"` para bloquear curinga, e meses depois o cliente contratou um plano com subdomínios curinga. O certificado simples renova, o curinga não. O painel mostra apenas falha.

A quarta linha é o inverso: publicar só `issuewild` não restringe nada no certificado comum. Quem queria travar a zona não travou.

## Os 5 erros de digitação que recusam a emissão

Todos aparecem como zona válida. Nenhum gera aviso no editor.

- **URL em vez de nome da CA.** `https://letsencrypt.org` ou `letsencrypt.org/` não casa com nada. O valor é o nome de domínio da CA, sem esquema e sem barra final.
- **Aspas no lugar errado.** O valor da propriedade é uma string entre aspas. Dependendo do painel, você digita o valor sem aspas num campo próprio e a interface as adiciona. Colar `"letsencrypt.org"` num campo que já faz isso produz aspas duplicadas gravadas no dado.
- **Flag errada.** O campo flags aceita `0` ou `128`. Com `128` (critical) numa tag que a CA não entende, ela é obrigada a recusar a emissão. Para `issue` e `issuewild` use `0`.
- **Espaço antes ou depois do valor.** ` letsencrypt.org` com espaço inicial vira um nome que não existe. Comparação é literal.
- **Ponto e vírgula solto.** `issue ";"` significa "nenhuma CA pode emitir". Alguém que quis separar duas CAs com `;` numa linha só (`letsencrypt.org;sectigo.com`) criou um valor inválido. Duas CAs permitidas são **dois registros CAA separados**, cada um com uma propriedade `issue`.

## Confirmar com dig CAA o valor que a autoridade realmente vê

Não confie no que o painel mostra. Confie no que o resolvedor público devolve, porque é o que a CA vê. Comece pelo nome exato que falhou, não pelo apex.

```bash
# nome exato que falhou
dig CAA loja.exemplo.com.br +short

# subindo a árvore
dig CAA exemplo.com.br +short
dig CAA com.br +short
```

Saída típica de uma zona correta no apex (exemplo fictício):

```
0 issue "letsencrypt.org"
0 iodef "mailto:ssl@exemplo.com.br"
```

Se a primeira consulta devolver qualquer linha, a busca para ali: é esse o conjunto que vale, e o apex não é consultado. Se devolver vazio, o valor efetivo é o da linha de cima que responder primeiro.

Para ver o registro cru, incluindo aspas duplicadas e espaço, use a forma longa:

```bash
dig CAA loja.exemplo.com.br
```

Um valor com aspas duplicadas ou com `https://` fica visível na seção ANSWER. Compare caractere a caractere com a lista de erros acima.

### Quando a resposta vem do cache e não da zona corrigida

Depois de corrigir, o TTL antigo continua valendo nos resolvedores. Consulte direto no servidor autoritativo para separar "não propagou" de "não corrigi":

```bash
dig NS exemplo.com.br +short
dig CAA exemplo.com.br @ns1.servidor-autoritativo.com +short
```

Se o autoritativo já mostra o valor certo e o resolvedor público ainda não, é só esperar o TTL. Pedir reemissão nesse intervalo gera uma segunda falha e, em algumas CAs, consome tentativa de rate limit.

## Valores corretos das CAs mais usadas

O valor é sempre o nome de domínio identificador publicado pela própria CA. Confira na documentação da CA que o seu painel usa antes de publicar.

| Autoridade | Valor em `issue` / `issuewild` |
|---|---||
| Let's Encrypt | `letsencrypt.org` |
| Sectigo | `sectigo.com` |
| Comodo CA (legado Sectigo) | `comodoca.com` |
| DigiCert | `digicert.com` |
| GlobalSign | `globalsign.com` |
| Google Trust Services | `pki.goog` |
| Proibir tudo | `;` |

O AutoSSL do cPanel pode estar configurado com o provedor Let's Encrypt ou com o provedor da própria cPanel, que emite por Sectigo. Se você usa os dois provedores entre seus clientes, o caminho seguro é publicar os dois registros `issue` que você usa de fato, e não um só. Dois registros, não um valor com vírgula.

## Corrigindo o registro CAA no Zone Editor do cPanel

O Zone Editor do cPanel lista e edita CAA pela interface **Domains > Zone Editor**, conforme a [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/domains/zone-editor/122/). Ao adicionar o registro, você preenche nome, TTL, flag, tag e valor em campos separados.

### Ordem de execução que evita retrabalho

- Rode `dig CAA` no nome exato que falhou e anote o que está valendo.
- Se o bloqueio vier de um CAA em subdomínio que ninguém lembra de ter criado, decida: remover o registro do subdomínio (volta a herdar o apex) ou corrigi-lo no próprio subdomínio.
- Corrija ou remova. Não acumule registros "por garantia": cada `issue` a mais é uma CA a mais autorizada.
- Baixe o TTL do CAA para um valor curto antes de uma janela de mudança prevista, e volte depois.
- Reconsulte pelo autoritativo e depois por um resolvedor público.
- Só então peça a reemissão do SSL.

### Se o DNS não está na hospedagem

É comum o domínio estar apontado para Cloudflare, Registro.br ou o painel de uma agência anterior. O Zone Editor do cPanel só edita a zona se o servidor for autoritativo para ela. Confirme com `dig NS` antes de perder tempo editando uma zona que ninguém consulta.

## Como explicar ao cliente que o bloqueio está no DNS dele

A conversa difícil é que o site está sem cadeado e a hospedagem não é a culpada. Frase pronta, para colar no e-mail:

> **** O certificado não foi emitido porque existe um registro CAA no DNS do seu domínio autorizando apenas uma autoridade certificadora diferente da que emite o certificado do seu site. Esse registro está no painel onde o DNS do domínio é gerenciado, não no servidor de hospedagem. Qualquer provedor teria a emissão recusada enquanto ele estiver assim. Corrigimos o valor do registro e o certificado volta a ser emitido na próxima verificação.

Para padronizar em vários sites, guarde um script simples que percorre a lista de nomes e imprime o CAA publicado em cada um:

```bash
while read -r d; do
  printf '%s: ' "$d"
  dig CAA "$d" +short | tr '\n' ' '
  echo
done < dominios.txt
```

O arquivo `dominios.txt` tem um domínio por linha. Saída vazia significa nenhum CAA publicado, que é permissivo e não bloqueia emissão. O que você procura é a linha com valor inesperado: uma CA que você não usa, um `;`, ou um nome com `https://` grudado. O limite é esse: o script lê apenas o nome que está na lista. Como um CAA em subdomínio encerra a busca, inclua no `dominios.txt` também os hostnames que recebem certificado (`loja.exemplo.com.br`, `webmail.exemplo.com.br`), e não só o apex. Rodar isso uma vez por trimestre custa minutos e antecipa a falha antes de o cliente ver o aviso no navegador.

