blog
Domínios e DNS

Configurar SPF e DKIM da hospedagem no Cloudflare sem duplicar

Como levar os registros gerados pelo cPanel para a zona do Cloudflare sem quebrar o SPF que já existe, e como provar que funcionou com consulta pública e cabeçalho do Gmail.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: no cPanel, copie SPF e DKIM em Email Deliverability; no Cloudflare, edite o TXT v=spf1 existente em vez de criar outro (só pode haver 1 por nome), crie o DKIM e, se for CNAME, deixe em DNS only. Prove com dig e com spf=pass e dkim=pass no Gmail.

Neste artigo
  1. Onde o cPanel mostra os valores de SPF e DKIM
  2. O que checar na zona do Cloudflare antes de criar qualquer registro
  3. Por que dois registros SPF no mesmo nome quebram a autenticação
  4. Como saber se o DKIM vem em TXT ou em CNAME
  5. Como provar que o SPF e o DKIM estão valendo
  6. O que cada resultado de SPF e DKIM indica sobre o erro
  7. Checklist para repetir a configuração em vários sites

Onde o cPanel mostra os valores de SPF e DKIM

No cPanel, os registros prontos ficam em Email > Email Deliverability. A documentação oficial do cPanel descreve a interface: ela lista cada domínio, mostra o estado de DKIM, SPF e PTR e, no botão Manage, exibe o registro sugerido para cada um.

O detalhe que importa quando a zona está no Cloudflare: o servidor da hospedagem não é o DNS autoritativo do domínio. A interface percebe isso e não consegue instalar os registros sozinha. A documentação orienta, nesse caso, a copiar os valores sugeridos e criá-los no provedor que de fato responde pelo DNS. É esse o trabalho deste guia.

Abra o Manage do domínio e anote duas coisas:

O cPanel entrega o DKIM em TXT. DKIM em CNAME aparece em serviços de envio de terceiros (newsletter, e-mail transacional), que apontam para uma chave mantida por eles. Esse é um cenário separado, tratado mais abaixo.

Copie o valor pelo botão de copiar da própria interface. Digitar uma chave DKIM à mão é a forma mais rápida de perder meia hora.

O que checar na zona do Cloudflare antes de criar qualquer registro

Em DNS > Records, filtre por tipo TXT e olhe o nome @ (a raiz do domínio). Três situações aparecem com frequência em sites de clientes:

  1. Nenhum TXT com v=spf1. Caminho livre: você cria um registro novo.
  2. Já existe um v=spf1. Quase sempre colocado por Google Workspace, Microsoft 365, ferramenta de newsletter ou pela hospedagem anterior. Você edita esse registro. Não cria outro.
  3. Existem TXT de verificação (google-site-verification=, MS=, chaves de outras ferramentas). Esses ficam como estão. Vários TXT no mesmo nome são normais; o problema é só ter dois que começam com v=spf1.

Verifique também se _domainkey já tem algo. Se o cliente usa outro serviço de envio, pode existir google._domainkey, selector1._domainkey ou similar. Seletores diferentes convivem sem conflito: cada remetente assina com o seu.

Antes de editar, tire um print ou exporte a zona (DNS > Records > Import and Export). Em zona de cliente, o registro de como estava antes é o que permite desfazer em um minuto.

Decisão antes de criar o SPFNenhum TXT com v=spf1Já existe um v=spf1Só TXT de verificação
Três situações comuns no registro TXT da raiz antes de criar qualquer SPF.

Por que dois registros SPF no mesmo nome quebram a autenticação

A regra do SPF: um nome pode ter um só registro v=spf1. Com dois, o receptor trata a consulta como erro permanente (permerror) e o SPF simplesmente não vale, para nenhum dos dois remetentes.

Por isso, juntar é obrigatório. Pegue os mecanismos do registro existente e acrescente os que a hospedagem sugeriu, mantendo um único v=spf1 no início e um único all no fim.

Exemplo (valores fictícios): o cliente já usa Google Workspace e passa a enviar também pelo servidor da hospedagem, cujo IP de exemplo é 203.0.113.10.

Antes (existente):
v=spf1 include:_spf.google.com ~all

Sugerido pelo cPanel (exemplo):
v=spf1 +a +mx +ip4:203.0.113.10 ~all

Depois (registro único, editado no lugar do antigo):
v=spf1 +a +mx +ip4:203.0.113.10 include:_spf.google.com ~all

Dois cuidados ao juntar:

No Cloudflare, o TXT não tem opção de proxy, então aqui não há nuvem laranja para se preocupar.

Como saber se o DKIM vem em TXT ou em CNAME

Como criar o DKIM em TXT quando o cPanel entrega a chave

Crie um registro TXT com o nome que o cPanel mostrou. No Cloudflare, digitar default._domainkey ou default._domainkey.exemplo.com.br na zona exemplo.com.br gera o mesmo registro. Depois de salvar, confira o nome exibido na lista DNS > Records. Cole o valor inteiro, que começa com v=DKIM1; k=rsa; p=.

Se o valor vier quebrado em vários trechos entre aspas, é a forma como alguns painéis exibem chaves longas. Junte os trechos em uma linha, sem as aspas internas, e confirme o resultado na consulta pública da próxima seção. A chave tem que chegar inteira: um caractere a menos e a assinatura falha.

Como criar o DKIM em CNAME sem o proxy do Cloudflare

Crie o CNAME com o nome e o destino informados e deixe o Proxy status em DNS only (nuvem cinza). Isso não é opcional. Com o proxy ligado, o Cloudflare responde com os próprios endereços em vez de entregar o destino, e o receptor não encontra o TXT com a chave pública na ponta da cadeia. Resultado: dkim=fail ou dkim=temperror sem nenhum erro aparente no painel.

Aproveite para conferir os outros registros de e-mail: o hostname que o MX aponta (mail.exemplo.com.br, por exemplo) também precisa estar em DNS only. E-mail não passa pelo proxy HTTP do Cloudflare.

Registro Tipo Nome (exemplo) Valor (exemplo) Proxy
SPF TXT @ v=spf1 +a +mx +ip4:203.0.113.10 ~all não se aplica
DKIM em TXT TXT default._domainkey v=DKIM1; k=rsa; p=MIIB... não se aplica
DKIM em CNAME CNAME s1._domainkey s1.dkim.provedor-exemplo.net DNS only
Host do MX A mail 203.0.113.10 DNS only

Todos os valores da tabela são fictícios. Use os que o seu painel gerou.

Como provar que o SPF e o DKIM estão valendo

Registro criado não é registro funcionando. A prova tem duas partes, e as duas são necessárias: a primeira mostra que o mundo enxerga o registro, a segunda mostra que um receptor real aceitou a mensagem.

Como consultar cada registro em um resolvedor público

Consulte um resolvedor público, não o DNS da sua máquina. Troque exemplo.com.br e o seletor pelos reais.

dig TXT exemplo.com.br @1.1.1.1 +short
dig TXT default._domainkey.exemplo.com.br @1.1.1.1 +short
dig CNAME s1._domainkey.exemplo.com.br @1.1.1.1 +short

O que validar em cada saída:

Depois volte ao Email Deliverability do cPanel. Segundo a documentação, a interface verifica os registros publicados; com tudo certo, o domínio deixa de exibir problemas em DKIM e SPF. O aviso sobre o servidor não ser autoritativo pode continuar, e é esperado nesse cenário.

Como ler a linha Authentication-Results no Gmail

Envie uma mensagem de uma conta do domínio (pelo webmail ou cliente configurado no servidor da hospedagem) para uma conta Gmail. No Gmail, abra a mensagem, menu de três pontos, Mostrar original. O topo da página resume SPF, DKIM e DMARC. Mais abaixo, procure a linha do cabeçalho:

Authentication-Results: mx.google.com;
       dkim=pass [email protected] header.s=default ...
       spf=pass (google.com: domain of [email protected] designates 203.0.113.10 as permitted sender) ...

(Exemplo ilustrativo; o texto exato varia.) O que conferir: spf=pass, dkim=pass, e header.i com o domínio do cliente. Se o dkim=pass vier com outro domínio, a mensagem foi assinada por um serviço intermediário, não pela chave que você publicou.

Processo reutilizável em quatro etapasZona exportada antes de editarSPF unificado em um único TXTdig em resolvedor públicoAuthentication-Results com spf=pass e dki…
Ordem de execução para repetir a configuração em cada site.

O que cada resultado de SPF e DKIM indica sobre o erro

Sintoma Causa provável Correção
spf=permerror Dois TXT v=spf1 no mesmo nome, ou mais de 10 consultas Unificar em um registro; reduzir include
spf=softfail ou fail IP de envio fora do registro Incluir o IP ou o include do remetente real
dkim=fail com TXT Chave truncada ou com aspas sobrando Recolar o valor do cPanel e conferir no dig
dkim=temperror ou sem resultado com CNAME Proxy ligado no CNAME Trocar para DNS only
dig vazio logo após criar Nome digitado errado (seletor trocado, _domainkey sem o sublinhado) ou cache negativo de uma consulta feita antes de criar Conferir o nome em DNS > Records; consultar outro resolvedor público ou esperar o cache negativo expirar
dkim=pass com domínio de terceiro Envio por outro serviço Publicar o DKIM desse serviço também

O erro de nome é discreto: o registro existe, só que no lugar errado. A consulta pública pelo nome correto é o que denuncia.

Checklist para repetir a configuração em vários sites

Para repetir o processo em vários sites sem reinventar a cada vez:

  1. Exportar a zona do Cloudflare antes de mexer.
  2. Copiar SPF e DKIM do Email Deliverability do cPanel do cliente.
  3. Listar os TXT em @: editar o v=spf1 existente, nunca criar o segundo.
  4. Juntar mecanismos, manter o all original, contar as consultas.
  5. Criar o DKIM com o nome exato; se for CNAME, DNS only.
  6. Conferir que o host do MX está em DNS only.
  7. dig em resolvedor público para cada registro.
  8. Mensagem de teste para Gmail e print da linha Authentication-Results com spf=pass e dkim=pass.
  9. Guardar o print no registro do cliente, junto da exportação da zona.

Guardar o print parece burocracia até o dia em que outra ferramenta sobrescreve o SPF e você precisa mostrar como estava funcionando.

Para explicar ao cliente, uma frase que costuma bastar: "Publiquei no DNS a identificação oficial do servidor que envia os seus e-mails e uma assinatura digital que prova que as mensagens saíram de você; sem isso, Gmail e Outlook tendem a mandar para spam ou recusar."

Próximo passo natural, depois de SPF e DKIM passando: um registro DMARC em modo de monitoramento, que fica para outro guia.

Referências

  1. Documentação oficial (cpanel) — cPanel - Email Deliverability. Consultado em 2026-11-12.
Leia também