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.

Resposta curta: 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.
Neste artigo
- O que o CAA controla, e o que ele não controla
- O valor é o identificador da CA, não o nome da hospedagem
- issue, issuewild e o caso em que o wildcard some
- Publicar o CAA no Zone Editor do cPanel
- Conferir com dig antes de pedir qualquer reemissão
- Por que o AutoSSL para de renovar semanas depois
- Checklist de duas passagens, levantamento e publicação
- A frase pronta para o cliente e a evidência para o auditor
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 emissuewild. - Site com wildcard: publique
issueeissuewildpara 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 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:
0no uso normal. O valor128marca a propriedade como crítica, o que faz a CA abortar se não entender a tag. Paraissueeissuewildnão há ganho em usar 128. - Tag:
issue,issuewildouiodef. - 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:[email protected]"
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.brvale parawww, paralojae 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 CAAno domínio e nos subdomínios relevantes.
Publicação, por site:
- Copiar o identificador direto da documentação de cada CA levantada.
- Criar um
issuepor CA. TTL 300 durante a janela de mudança. - Criar
issuewildapenas se houver wildcard, e apenas com as CAs que emitem wildcard. - Criar
iodefcom um endereço monitorado pela agência, não com um e-mail do cliente que ninguém lê. - Conferir com
dig CAAem 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:
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.
Referências
- Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.