# SSL gratuito não renova? Olhe o registro CAA da zona

Como interpretar flag, tag e domínio da CA no registro já publicado, corrigir a linha sem apagar o controle do cliente e auditar a carteira inteira em um comando.

> um registro CAA já publicado na zona, com a tag issue autorizando só uma CA antiga ou com issuewild restritivo, faz a CA recusar a renovação antes de validar o domínio. A correção é acrescentar a linha issue da CA atual no Zone Editor, sem apagar as existentes.

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

---

## O site não mudou, o DNS está certo e o AutoSSL para de renovar

O caso típico de carteira herdada é este: o site está no ar há meses, ninguém tocou em DNS nem em plugin, e um dia o AutoSSL começa a falhar com mensagem de que a autoridade certificadora não está autorizada a emitir para aquele domínio. O certificado anterior continua válido até expirar, então o problema só aparece no navegador semanas depois, quando o cliente liga.

Na maioria das vezes que isso acontece sem alteração recente, a causa está em um registro CAA já publicado na zona, criado em outra época por outra agência, autorizando uma CA que não é a que está tentando renovar agora. O registro está fazendo exatamente o que foi pedido: bloqueando quem não foi listado.

Antes de apagar qualquer coisa, leia o que está publicado. Apagar o CAA resolve a renovação e joga fora o controle que o cliente (ou o compliance dele) talvez queira manter.

## O que significa cada campo de flag, tag e valor no CAA

O valor de um registro CAA tem três partes, nesta ordem: **flag**, **tag** e **valor entre aspas**.

```
example.com.  3600  IN  CAA  0 issue "letsencrypt.org"
example.com.  3600  IN  CAA  0 issuewild "letsencrypt.org"
example.com.  3600  IN  CAA  0 iodef "mailto:ssl@example.com"
```

| Campo | Valor no exemplo | O que significa |
|---|---|---||
| Flag | `0` | Nenhum bit crítico ligado. Com `128`, o bit "issuer critical" está ligado: uma CA que não entenda a tag deve recusar a emissão em vez de ignorar a linha |
| Tag | `issue` | Autoriza a CA indicada a emitir certificados para o nome |
| Tag | `issuewild` | Autoriza (ou nega) emissão de certificado **wildcard** para o nome |
| Tag | `iodef` | Endereço para a CA relatar pedido de emissão não autorizado. Não bloqueia nada |
| Valor | `"letsencrypt.org"` | Identificador que a CA publica como seu. Não é o nome comercial, é o domínio documentado pela CA |

Três regras de leitura que resolvem quase toda auditoria:

- **Se existe pelo menos um `issue`, só as CAs listadas podem emitir.** Não existe "autoriza além das outras": a presença do conjunto já fecha a porta para quem ficou de fora.
- **`issuewild` presente substitui o `issue` para wildcards.** Se há `issue "letsencrypt.org"` e `issuewild ";"`, certificado comum passa e `*.dominio` é negado.
- **`issuewild` ausente não bloqueia wildcard.** Nesse caso o `issue` vale também para o wildcard. Ausência não é restrição, ausência é herança.

O valor `";"` (ponto e vírgula) é a negação explícita: nenhuma CA autorizada para aquela tag. É o que costuma aparecer em zona montada por quem quis "travar o SSL" e esqueceu que o AutoSSL renova sozinho a cada ciclo.

## Três configurações de CAA que recusam a renovação

### Uma linha issue com a CA do certificado pago que já venceu

A zona tem `0 issue "digicert.com"` porque o cliente comprou um certificado pago em 2021. O certificado pago venceu, o site migrou para AutoSSL, e a linha ficou. A CA do AutoSSL consulta o CAA, não se encontra na lista e recusa antes mesmo de tentar validar o domínio. O erro não menciona DNS quebrado porque o DNS está perfeito.

### O certificado simples emite e o wildcard falha por causa do issuewild

A emissão do certificado simples funciona, a do wildcard falha, e o log mostra falha só nos subdomínios. Procure por `issuewild ";"` ou por `issuewild` apontando para outra CA.

### O CAA do domínio raiz vale para o subdomínio que não tem o seu

Se não existe CAA no nome exato, a CA sobe um rótulo por vez até achar um conjunto de registros. Um `issue` publicado em `cliente.com.br` vale para `loja.cliente.com.br` enquanto o subdomínio não tiver CAA próprio. Em carteira com subdomínio de staging e de loja, é comum a falha aparecer só em um nome e todo mundo procurar no lugar errado.

## Consultando o nome exato e cada rótulo pai até o TLD

Consulte o nome exato que está falhando e depois cada rótulo pai, um a um, até o TLD:

```bash
dig +short CAA loja.cliente.com.br
dig +short CAA cliente.com.br
dig +short CAA com.br
dig +short CAA br
```

A primeira consulta que devolver registro encerra a busca: é esse conjunto que a CA vai aplicar. Resposta vazia só permite concluir que não há CAA depois de checar todos os rótulos pais, inclusive o TLD. E vazio não é sempre ausência: se a consulta retornar SERVFAIL (rode sem o `+short` para ver o status), a saída também vem em branco, e aí o que você tem é um problema de DNS, não um domínio sem CAA. Se vier algo, compare com o identificador que a sua CA publica.

Para auditar uma carteira inteira de uma vez, coloque um domínio por linha em `dominios.txt`:

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

A saída cabe em uma tela: domínio à esquerda, CAA à direita, linha vazia onde não há registro. Guarde esse arquivo como estado anterior antes de qualquer alteração.

Se desconfiar de cache, consulte o servidor autoritativo do domínio em vez do resolvedor local, com `dig CAA cliente.com.br @ns1.exemplo-do-provedor.com`. O que a CA vê é o autoritativo, não o seu resolvedor.

## Acrescentar a sua CA sem remover a lista que já existe

O conserto é **acrescentar** a CA que vai emitir, não remover a lista. No cPanel, o caminho é **Zone Editor**, em Domains, que permite adicionar e editar registros CAA da zona pela interface, conforme a [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/domains/zone-editor/122/).

### Onde achar o identificador que a CA publica para a tag issue

| CA | Identificador usado na tag issue |
|---|---||
| Let's Encrypt | `letsencrypt.org` |
| Sectigo (uma das CAs que o AutoSSL do cPanel pode usar) | `sectigo.com` |
| Qual CA o seu servidor usa | Depende da configuração do AutoSSL naquele servidor, verificável no painel antes de escrever a linha |
| Outras | Verifique na documentação da própria CA: o identificador é publicado por ela e não se deduz do nome comercial |

### Criando o registro issue no Zone Editor do cPanel

No Zone Editor, crie um registro CAA para o nome que está falhando com flag `0`, tag `issue` e o identificador da CA. Mantenha as linhas antigas se o cliente ainda usa aquela CA em outro serviço.

### Quando adicionar issuewild e quando deixar ausente

Se o site usa `*.dominio` e existe um `issuewild` na zona, adicione também `0 issuewild "<sua-ca>"`. Se não existe nenhum `issuewild`, não crie: a ausência já herda o `issue`.

### Esperar o TTL antes de pedir a reemissão

Rode de novo o `dig +short CAA` e confira que a linha nova aparece. Respeite o TTL do registro anterior: pedir reemissão enquanto o valor antigo ainda está em cache do resolvedor da CA gera uma segunda falha e confunde o diagnóstico. Se o TTL estiver alto, baixe antes, espere, altere.

### O que anotar no checklist para a próxima pessoa não apagar tudo

Salve no checklist do cliente qual linha existia, qual foi acrescentada e por quê. É o que evita que a próxima pessoa apague o CAA inteiro no próximo incidente.

## Auditando CAA em uma carteira inteira com um loop de dig

- Monte `dominios.txt` com todos os domínios e subdomínios que têm certificado emitido, não só os domínios raiz.
- Rode o loop de `dig` e salve a saída datada.
- Marque todo domínio com linha `issue` que não contenha o identificador da CA que você usa.
- Marque todo domínio com `issuewild ";"` que sirva subdomínio por wildcard.
- Para cada marcado, confirme com o cliente se a CA antiga ainda é usada em algum serviço (balanceador, CDN, e-mail com certificado próprio).
- Acrescente a linha `issue` da sua CA, preservando as demais.
- Confira o TTL antes de disparar a reemissão.
- Reexecute o loop uma semana depois e compare com a saída datada.

Dois atalhos que valem o tempo: padronize o TTL do CAA em um valor baixo nos domínios que você administra, para que correção futura propague rápido, e inclua a checagem de CAA no seu processo de onboarding de site herdado, junto com a conferência de nameserver e de registro MX.

## Como explicar a recusa ao cliente por escrito

Use isto, por escrito, antes que alguém diga que o site "caiu do nada":

> **** O site não mudou. Existe no DNS do seu domínio um registro chamado CAA, criado quando o certificado anterior foi contratado, que lista quais empresas têm permissão para emitir certificado de segurança para o seu endereço. A empresa que emite o certificado atual não estava nessa lista, então a renovação automática foi recusada por política, e não por falha no site. Acrescentamos a autorização à lista, mantendo as anteriores, e a renovação volta a ocorrer sozinha.

Se o cliente perguntar por que isso não apareceu antes: o certificado vigente continua válido até a data de expiração, e a recusa só se torna visível no navegador quando a renovação falha até o vencimento. É por isso que vale auditar o CAA no momento em que você assume a carteira, e não quando o cadeado some.

