blog
Domínios e DNS

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.

JR · · 8 min de leitura · 2 tabelas · 2 blocos de código

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
  1. O que o CAA controla, e o que ele não controla
  2. O valor é o identificador da CA, não o nome da hospedagem
  3. issue, issuewild e o caso em que o wildcard some
  4. Publicar o CAA no Zone Editor do cPanel
  5. Conferir com dig antes de pedir qualquer reemissão
  6. Por que o AutoSSL para de renovar semanas depois
  7. Checklist de duas passagens, levantamento e publicação
  8. 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 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:

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:

  1. Site sem wildcard (o caso normal de AutoSSL, que emite por nome): publique só issue. Não toque em issuewild.
  2. 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 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:

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:

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.

Triagem quando o AutoSSL para de renovarNenhuma renovação funcionaissue aponta para CA erradaSó o wildcard falhaissuewild de outra CAFalha em um subdomínioCAA próprio sobrepõe o paiFalhou após troca de CACAA autoriza a CA antigaFalha intermitentenameservers com zonas diferentes
Ordem de triagem sugerida pela lógica do mecanismo, não por estatística medida.

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:

  1. Quem emite o certificado hoje (AutoSSL do servidor, ACME próprio, CDN na frente, certificado comprado).
  2. Existe wildcard em uso. Se sim, quem emite o wildcard.
  3. 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).
  4. Onde ficam os nameservers autoritativos.
  5. Existe CAA publicado hoje. dig CAA no domínio e nos subdomínios relevantes.

Publicação, por site:

  1. Copiar o identificador direto da documentação de cada CA levantada.
  2. Criar um issue por CA. TTL 300 durante a janela de mudança.
  3. Criar issuewild apenas se houver wildcard, e apenas com as CAs que emitem wildcard.
  4. Criar iodef com um endereço monitorado pela agência, não com um e-mail do cliente que ninguém lê.
  5. Conferir com dig CAA em resolver local e em resolver público.
  6. Forçar emissão ou renovação no mesmo dia e confirmar sucesso.
  7. 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.

Duas passagens para publicar CAA sem incidenteLevantarquem emite, wildcard, nameserversPublicarissue por CA, TTL baixoConferirdig CAA local e públicoForçar emissãoerro visível no mesmo diaRegistrarsubir TTL, anotar no inventário
Procedimento reutilizável por site da carteira.

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

  1. Documentação oficial (cpanel) — Zone Editor. Consultado em 2026-10-29.
Leia também