# Registro CAA: bloqueie a emissão de SSL por outra CA

Como padronizar o registro CAA na carteira de clientes sem derrubar a renovação automática do SSL semanas depois.

> publique um registro CAA com a tag `issue` apontando para o identificador oficial da autoridade certificadora que emite o certificado do site. Qualquer outra CA passa a ter a emissão recusada. Confira com `dig CAA` e force uma renovação no mesmo dia para não descobrir o erro só no vencimento.

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

---

## O que o CAA controla, e o que ele não controla

O registro CAA (Certification Authority Authorization) é uma linha no DNS que diz quais autoridades certificadoras podem emitir certificado para aquele domínio. Antes de emitir, a CA consulta o CAA do nome. Se existir um conjunto de registros e o identificador dela não estiver na lista, ela recusa a emissão.

Duas consequências práticas, e elas importam para quem administra carteira:

- O CAA não valida visitante nenhum. Não há navegador consultando CAA. Ele age uma vez, no momento da emissão, do lado da CA.
- O CAA não revoga certificado já emitido. Publicar CAA hoje não invalida o que foi emitido ontem por outra CA.

O que ele entrega é controle de superfície: reduz o risco de alguém que tenha obtido controle temporário de um subdomínio, ou de um painel antigo esquecido, conseguir um certificado válido em nome do cliente. É por isso que o item aparece em auditoria de segurança e em checklist de compliance, e é por isso que vale padronizar em vez de fazer caso a caso.

## O valor é o identificador da CA, não o nome da hospedagem

O erro mais comum é escrever o nome do provedor de hospedagem no CAA. O valor é sempre o domínio identificador da **autoridade certificadora**, publicado por ela própria na documentação dela. Se o site usa AutoSSL, a CA é a que o provedor configurou no AutoSSL, não o provedor.

| Emissor usado no site | O que conferir antes de escrever |
|---|---||
| Let's Encrypt (ACME, AutoSSL ou plugin) | identificador `letsencrypt.org`, conforme documentação da própria Let's Encrypt |
| AutoSSL do cPanel com provedor Sectigo | identificador publicado pela Sectigo na documentação dela |
| Certificado comercial comprado à parte | identificador publicado pela CA que vendeu o certificado |
| Certificado emitido pelo Cloudflare na borda | identificador da CA que o Cloudflare usa no modo contratado |

Regra que evita retrabalho: **nunca escreva um identificador de memória**. Abra a página de CAA da CA e copie a string. CAs mudam de marca, fundem-se e passam a aceitar mais de um identificador, e o CAA não perdoa string errada: ele simplesmente nega a emissão.

Outra regra: se o site tem mais de um caminho de emissão (AutoSSL no servidor, Cloudflare na frente, um certificado de e-mail separado), liste todos. CAA é cumulativo por tag. Vários registros `issue` coexistem e qualquer um deles autoriza.

## issue, issuewild e o caso em que o wildcard some

São três tags úteis:

- `issue`: autoriza a CA a emitir certificados comuns para o nome.
- `issuewild`: autoriza a CA a emitir certificados wildcard (`*.dominio`).
- `iodef`: endereço (`mailto:` ou URL) para a CA relatar tentativa de emissão negada.

A pegadinha está na interação entre as duas primeiras. Se existir qualquer registro `issuewild` no conjunto, ele passa a ser a única regra que vale para wildcard, e o `issue` deixa de autorizar wildcard. Em outras palavras: publicar `issuewild` para a CA A e `issue` para A e B faz os wildcards de B pararem de ser emitidos, mesmo que B continue autorizada para os nomes comuns.

Disso saem duas receitas limpas:

- Site sem wildcard (o caso normal de AutoSSL, que emite por nome): publique só `issue`. Não toque em `issuewild`.
- Site com wildcard: publique `issue` e `issuewild` para a mesma CA, explicitamente, em vez de confiar na herança.

Se a intenção é proibir wildcard de qualquer origem, existe o valor `;`, que significa "nenhuma CA autorizada" para aquela tag. Usar `;` em `issue` bloqueia toda emissão, inclusive a renovação do AutoSSL. É um ótimo jeito de derrubar o SSL do cliente sem perceber.

## Publicar o CAA no Zone Editor do cPanel

A [documentação oficial do Zone Editor](https://docs.cpanel.net/cpanel/domains/zone-editor/122/) descreve a interface que cria e edita registros da zona, incluindo CAA, quando o servidor usa o DNS do próprio cPanel. Se o domínio aponta para nameservers de terceiros (Cloudflare, registrador, DNS gerenciado), edite lá, não no cPanel: a zona que vale é a dos nameservers autoritativos do domínio.

### Confirmar onde fica a zona autoritativa antes de editar

`dig NS dominiodocliente.com.br +short`. O que aparecer ali é onde o CAA tem de ser escrito. Zona editada no lugar errado é a causa número um de "publiquei e não apareceu".

### Preencher flag, tag e value sem deixar lixo na string

No Zone Editor, use a opção de adicionar registro e escolha o tipo CAA. Os campos são três, além do nome e do TTL:

- **Flag**: `0` no uso normal. O valor `128` marca a propriedade como crítica, o que faz a CA abortar se não entender a tag. Para `issue` e `issuewild` não há ganho em usar 128.
- **Tag**: `issue`, `issuewild` ou `iodef`.
- **Value**: o identificador da CA, ou o contato no caso de `iodef`.

Exemplo fictício, para um domínio de exemplo que usa apenas uma CA e não emite wildcard:

```
exemplo.com.br.  3600  IN  CAA  0 issue "ca-de-exemplo.tld"
exemplo.com.br.  3600  IN  CAA  0 iodef "mailto:ssl@exemplo.com.br"
```

Os identificadores acima são placeholders de ilustração. Substitua pela string que a CA real publica.

### Por que usar TTL 300 durante a janela de mudança

Enquanto você estiver ajustando, use TTL baixo (300 segundos, por exemplo). Erro em CAA com TTL de 86400 significa esperar o cache expirar para a CA ver a correção. Depois que a emissão estiver estável, suba o TTL.

## Conferir com dig antes de pedir qualquer reemissão

Nunca clique em "executar AutoSSL" logo depois de salvar. Pergunte ao DNS primeiro.

```
dig CAA exemplo.com.br +short
dig CAA exemplo.com.br @8.8.8.8 +short
dig CAA www.exemplo.com.br +short
```

O que observar:

- A saída precisa mostrar as linhas que você escreveu, com a tag e a string entre aspas. Saída vazia no nome do domínio não é erro: significa ausência de CAA, e ausência autoriza qualquer CA.
- A segunda consulta, contra um resolver público, confirma que a propagação saiu do servidor local.
- A terceira existe porque a CA sobe na árvore: ela consulta o nome exato e, não achando, consulta o domínio pai. Um CAA restritivo publicado em `exemplo.com.br` vale para `www`, para `loja` e para o subdomínio que você esqueceu que existia.

Se a saída tiver aspas duplicadas, espaço sobrando ou ponto e vírgula solto no fim do valor, corrija antes de pedir emissão. Parser de CA é literal.

## Por que o AutoSSL para de renovar semanas depois

O padrão é sempre o mesmo e enganoso: a agência publica o CAA, o site continua com HTTPS perfeito por semanas, ninguém associa uma coisa à outra, e aí o certificado expira. O motivo é que o CAA só é consultado na **emissão**. O certificado em vigor não é afetado. A primeira tentativa de renovação é que bate no CAA e falha, e isso acontece dias antes do vencimento, muito depois da mudança de DNS.

As causas recorrentes, numa ordem de triagem sugerida pela lógica do mecanismo (não é estatística medida):

| Sintoma | Causa provável |
|---|---||
| Nenhuma renovação funciona | `issue` aponta para CA diferente da que o AutoSSL usa |
| Só o wildcard falha | existe `issuewild` apontando para outra CA, ou `issuewild ";"` |
| Falha só em um subdomínio | CAA específico no subdomínio sobrepõe o do domínio pai |
| Falhou depois que o provedor trocou de CA | CAA continua autorizando a CA antiga |
| Falha intermitente | dois nameservers servindo zonas diferentes |

Regra operacional que evita o incidente: ao publicar CAA, **force uma emissão de teste no mesmo dia**. Rodar o AutoSSL manualmente, ou pedir uma renovação, transforma um erro silencioso, que só apareceria na próxima tentativa de renovação semanas depois, num erro visível em 10 minutos. Se a CA não puder emitir, você descobre com o certificado antigo ainda válido.

## Checklist de duas passagens, levantamento e publicação

Para padronizar na carteira, trate como procedimento de duas passagens: uma de levantamento e uma de publicação.

Levantamento, por site:

- Quem emite o certificado hoje (AutoSSL do servidor, ACME próprio, CDN na frente, certificado comprado).
- Existe wildcard em uso. Se sim, quem emite o wildcard.
- Há emissão para subdomínio fora do servidor principal (webmail de terceiro, loja em outra plataforma, ferramenta de e-mail marketing com domínio de rastreio).
- Onde ficam os nameservers autoritativos.
- Existe CAA publicado hoje. `dig CAA` no domínio e nos subdomínios relevantes.

Publicação, por site:

- Copiar o identificador direto da documentação de cada CA levantada.
- Criar um `issue` por CA. TTL 300 durante a janela de mudança.
- Criar `issuewild` apenas se houver wildcard, e apenas com as CAs que emitem wildcard.
- Criar `iodef` com um endereço monitorado pela agência, não com um e-mail do cliente que ninguém lê.
- Conferir com `dig CAA` em resolver local e em resolver público.
- Forçar emissão ou renovação no mesmo dia e confirmar sucesso.
- Subir o TTL e registrar no inventário do cliente qual CA está autorizada.

Um oitavo item, e esse é o que mais salva: anote o CAA no mesmo lugar onde você anota migração. Quando o site for migrado, ou quando o provedor trocar a CA do AutoSSL, o CAA vira um impedimento invisível que ninguém lembra de ter criado. Se a dúvida for entre um CAA desatualizado e uma emissão travada, remover o CAA é diagnóstico válido: sem CAA, o comportamento volta ao padrão aberto e você isola a causa.

## A frase pronta para o cliente e a evidência para o auditor

Quando o cliente pergunta o que foi feito, ou quando o auditor pede evidência, use isto, sem jargão:

> **** "Publicamos no DNS do seu domínio uma autorização chamada CAA. Ela faz com que só a autoridade certificadora autorizada possa emitir certificado para o seu domínio. Se qualquer outra empresa tentar emitir um certificado em nome do seu site, o pedido é recusado automaticamente."

Se precisar de uma segunda frase para a parte que o CAA não cobre, use esta: "Isso protege contra emissão indevida daqui para frente, e não substitui a renovação do certificado atual, que continua automática."

Para relatório de auditoria, a evidência objetiva é a saída do `dig CAA` do domínio, datada, junto com a confirmação de que a renovação seguinte foi concluída depois da publicação. Esse par de provas responde à pergunta do auditor e à pergunta que importa ao cliente ao mesmo tempo: está restrito, e não quebrou nada.

