# Erro de CAA: por que o SSL não emite com o DNS certo

Onde escrever issue e issuewild no Zone Editor, como a checagem sobe do subdomínio até o apex, e os quatro erros de escrita que fazem o registro recusar emissão.

> quando a emissão falha mesmo com DNS e redirecionamento corretos, quase sempre existe um registro CAA na zona autorizando outra autoridade certificadora. A CA é obrigada a consultar o CAA e recusar se não estiver listada. Confira com `dig CAA dominio.com.br +short` antes de pedir reemissão.

João Rizzon · 2026-10-31 · Domínios e DNS

---

## DNS certo, redirecionamento certo, certificado recusado: como reconhecer o sintoma

O caso é sempre parecido. O A do domínio aponta para o servidor, o `.well-known/acme-challenge` responde 200, o site abre em HTTP, e mesmo assim o AutoSSL marca o domínio como falha ou o `certbot` devolve algo como `CAA record for exemplo.com.br prevents issuance`.

Não é DNS quebrado. É DNS funcionando exatamente como foi escrito. O registro CAA (Certification Authority Authorization) diz quais autoridades certificadoras têm permissão para emitir certificado para aquele nome. A CA é obrigada a consultar esse registro antes de emitir e a recusar se não estiver autorizada. Se a zona tem CAA e a string da sua CA não está lá, a emissão para, sem gerar nenhum erro de resolução, de HTTP ou de redirect.

Por isso esse caso escapa do checklist comum: tudo que você costuma testar passa.

## Por que o subdomínio herda o CAA do apex e quando para de herdar

A CA não consulta só o nome exato que vai no certificado. Ela consulta o nome e, se não achar CAA, sobe um nível de cada vez até o topo do domínio registrado. O primeiro nível que tiver CAA é o que vale, e os níveis acima param de importar.

Para `loja.exemplo.com.br`:

- Consulta `loja.exemplo.com.br`. Se houver CAA, usa esse conjunto e para.
- Se não houver, consulta `exemplo.com.br`. Se houver CAA, usa esse.
- Se não houver em lugar nenhum, não há restrição e qualquer CA pode emitir.

Três consequências práticas para quem administra carteira de sites:

- **Subdomínio herda o CAA do apex.** Um CAA errado no apex derruba a renovação de todos os subdomínios que não têm CAA próprio.
- **CAA no subdomínio sobrescreve o apex inteiro.** Não soma, substitui. Se você põe `issue "letsencrypt.org"` em `loja`, o `issue "sectigo.com"` do apex deixa de valer para `loja`.
- **Zona sem CAA nenhum é permissiva.** Ausência de registro não bloqueia nada. Se você não precisa restringir, não crie o registro só por hábito.

## Onde criar issue, issuewild e iodef no Zone Editor do cPanel

O Zone Editor do cPanel permite adicionar, editar e remover registros da zona, incluindo CAA, direto no painel, sem acesso a shell ([documentação oficial do Zone Editor](https://docs.cpanel.net/cpanel/domains/zone-editor/122/)).

### Abrir a zona do domínio que realmente responde pelos NS

Em **Domains > Zone Editor**, localize o domínio e use **Manage** para ver os registros existentes. Filtre por tipo CAA antes de criar qualquer coisa: muita zona já tem um CAA antigo que ninguém lembra de ter criado.

### Os quatro campos do formulário e o que vai em cada um

Ao adicionar um registro CAA, o formulário pede quatro campos:

| Campo | O que colocar | Observação |
|---|---|---||
| Name | `exemplo.com.br.` ou `loja.exemplo.com.br.` | o nome que você quer restringir |
| Flags | `0` | `0` é o valor normal; `128` marca a propriedade como crítica |
| Tag | `issue`, `issuewild` ou `iodef` | um registro por tag/valor |
| Value | a string da CA, sem `http://` e sem barra | ex.: `letsencrypt.org` |

O `issue` autoriza certificados para o nome. O `issuewild` autoriza certificados curinga (`*.exemplo.com.br`). O `iodef` só informa um contato (mailto ou URL) para a CA relatar tentativas recusadas, e não autoriza nada.

### Por que issuewild manda no curinga e issue deixa de valer

Esta é a parte que mais derruba renovação:

- Se existe `issuewild`, só ele vale para o curinga. O `issue` é ignorado para wildcard.
- Se **não** existe `issuewild`, o `issue` também serve para o curinga.
- `issuewild ";"` proíbe qualquer curinga, mesmo com `issue` liberando a CA.

Ou seja: colocar `issue "letsencrypt.org"` e `issuewild "sectigo.com"` significa que o Let's Encrypt emite para `exemplo.com.br` e **não** emite para `*.exemplo.com.br`.

## Cada CA publica a string exata, e grafar diferente é não autorizar

O valor do CAA é uma string literal definida pela própria autoridade. Não é o domínio do site dela por dedução, é o identificador que ela publica. Grafar diferente equivale a não autorizar.

| CA | Onde confirmar a string |
|---|---||
| Let's Encrypt | página de CAA da própria CA; copie o identificador de lá (exemplo comum: `letsencrypt.org`, confirme antes de salvar) |
| Sectigo, DigiCert, GlobalSign, Google Trust Services, Amazon | cada CA publica o identificador em sua página de CAA; copie de lá. Algumas publicam mais de uma string, incluindo a marca antiga após fusão |

Não trate essa tabela como lista fechada. Antes de escrever, abra a página de CAA da CA que vai emitir e copie a string de lá. Em host compartilhado com AutoSSL, confirme no painel qual provedor está configurado: se o AutoSSL usa um provedor e o CAA autoriza outro, a emissão falha mesmo com tudo o mais correto.

## Como conferir com dig qual valor ficou valendo antes de reemitir

Editar a zona e clicar em "executar AutoSSL" na sequência é desperdício de tempo. Consulte primeiro, por resolvedor público, o que o mundo está enxergando.

```
dig CAA exemplo.com.br +short
dig CAA loja.exemplo.com.br +short
dig @1.1.1.1 CAA exemplo.com.br +short
```

Um retorno típico de zona restrita:

```
0 issue "letsencrypt.org"
0 issuewild "letsencrypt.org"
```

Saída vazia no subdomínio e preenchida no apex é o comportamento esperado: a CA vai subir e usar o do apex. Se precisar ver a árvore inteira de uma vez, consulte nome por nome, do mais específico para o apex, e pare no primeiro que responder.

Propagação importa. Se o TTL da zona é alto, o resolvedor público pode devolver o valor antigo por horas. Confira direto no servidor autoritativo com `dig CAA exemplo.com.br @ns1.seuprovedor.com +short` e só peça reemissão quando os dois concordarem. Se o domínio usa DNS de terceiro (Cloudflare, registrador, painel do cliente), o Zone Editor do cPanel está editando uma zona que ninguém consulta: o CAA tem que ser criado onde estão os NS ativos.

## Os quatro erros de escrita que travam a emissão

### Aspas duplicadas pelo painel geram um valor que não bate com nada

O valor é uma string entre aspas duplas no arquivo de zona. Alguns painéis pedem só `letsencrypt.org` no campo e adicionam as aspas; outros esperam o valor completo. Colar `"letsencrypt.org"` num campo que já coloca aspas gera `""letsencrypt.org""`, que não bate com nada. Depois de salvar, confira o resultado com `dig` e veja como a string aparece de fato.

### Grafia fora da string oficial não autoriza a CA

`lets-encrypt.org`, `letsencrypt.com`, `www.letsencrypt.org`, `https://letsencrypt.org` são quatro coisas que não autorizam o Let's Encrypt. A comparação é literal. O mesmo vale para CA que mudou de marca: a string antiga pode ter deixado de ser aceita, ou a nova ainda não ter sido adicionada.

### issuewild restritivo emite o domínio e recusa o curinga

Zona com `issue "letsencrypt.org"` e `issuewild ";"` emite o certificado do domínio e recusa o curinga: o `issuewild` presente e restritivo manda no wildcard, e o `issue` deixa de valer para ele. É a causa clássica de "o site funciona, mas o certificado não cobre os subdomínios". Se você usa curinga, ou remova o `issuewild` restritivo, ou liste nele a mesma CA.

### CAA do emissor anterior quebra a renovação 60 ou 90 dias depois

Migração de hospedagem ou troca de CA. O certificado antigo ainda está válido, ninguém mexe no CAA, e o problema só aparece 60 ou 90 dias depois, quando a primeira renovação automática falha. A zona autoriza a CA antiga; a nova é recusada. Sintoma típico: "parou de renovar sozinho" sem nenhuma mudança recente no site.

## Checklist para auditar o CAA de uma carteira de domínios

Rode isto uma vez por domínio e guarde o resultado numa planilha com colunas domínio, CA autorizada, tem issuewild, data da conferência.

- `dig CAA dominio.com.br +short` no apex. Anote o retorno, inclusive quando for vazio.
- Se vazio, decida: deixar sem CAA (permissivo, válido) ou criar restringindo à CA que você realmente usa.
- Se preenchido, compare a string com a página de CAA da CA que emite hoje.
- Se o site usa curinga, confirme que existe `issuewild` com a mesma CA, ou que não existe `issuewild` nenhum.
- Rode `dig CAA` nos subdomínios que têm certificado próprio (`loja`, `app`, `mail`). Qualquer CAA ali sobrescreve o apex.
- Confirme que os NS consultados são os mesmos onde você editou a zona.
- Só então peça o AutoSSL ou rode o `certbot`. E guarde o log da tentativa.

Dois alertas de operação. Primeiro: se você gerencia dezenas de domínios com a mesma CA, padronizar o CAA é bom, mas vira risco no dia em que precisar emitir por outra CA às pressas (certificado de validação estendida, CDN que emite o próprio, selo exigido por gateway de pagamento). Documente a decisão. Segundo: um CAA restritivo não melhora a segurança do site em si, ele reduz a superfície de emissão indevida. Se o cliente não tem essa exigência e você não controla a zona com disciplina, zona sem CAA dá menos manutenção.

## A explicação para o cliente, sem usar a palavra CAA na primeira frase

Quando o cliente perguntar por que o certificado "parou de renovar sozinho", evite a palavra CAA na primeira frase.

> **** O domínio tem uma trava de segurança no DNS que lista quais empresas podem emitir o certificado do site. Essa lista ficou com o nome da empresa anterior, então o novo certificado foi recusado automaticamente. Corrigimos a lista, e a renovação volta a acontecer sozinha a partir da próxima tentativa.

Se precisar justificar o prazo, acrescente que a alteração no DNS leva algumas horas para valer em toda a internet e que a emissão só é tentada depois disso. É verdade e evita a cobrança de meia em meia hora.

Se o navegador bloqueia o acesso com aviso de certificado inválido enquanto você corrige, explique que o servidor e o site seguem no ar e que o aviso vem do navegador, não de uma queda da hospedagem. Muda a conversa.

