# SPF e DKIM em lote no WHM: o que o reparo não resolve

Como usar a tela de reparo de autenticação do WHM como inventário de auditoria, separar o que o servidor conserta sozinho do que depende de DNS externo e fechar cada domínio com consulta pública.

> não existe botão que corrija todos de uma vez fora do servidor. A tela Email Deliverability do WHM lista todos os domínios e repara automaticamente só os que têm a zona DNS hospedada localmente; domínios em Cloudflare, Registro.br ou painel do cliente exigem copiar SPF e DKIM na mão.

João Rizzon · 2026-10-09 · Revenda

---

## O que a tela de Email Deliverability realmente faz

No WHM, em **Home » Email » Email Deliverability**, existe uma lista com todos os domínios que o servidor conhece e uma coluna de status de autenticação de e-mail. Segundo a [documentação do cPanel](https://docs.cpanel.net/whm/email/email-deliverability-in-whm/82/), a interface verifica os registros de DKIM, SPF e o DNS reverso (PTR) de cada domínio e aponta quais estão ausentes ou divergentes do que o servidor espera.

Para quem administra um servidor com dezenas de domínios, o valor principal dessa tela não é o botão de reparo. É o inventário. Em uma única página você vê, de uma vez, quais domínios têm autenticação consistente e quais não têm, sem abrir conta por conta.

O ponto que costuma gerar retrabalho: o botão **Repair** só escreve em zona DNS da qual o próprio servidor é autoritativo. Se o domínio usa Cloudflare, Registro.br, um DNS da hospedagem antiga ou o painel do próprio cliente, o reparo automático não tem onde gravar. O domínio volta a aparecer com problema na próxima verificação, indefinidamente, até que alguém copie SPF e DKIM na mão para o provedor de DNS correto.

## Por que metade da lista nunca fica verde sozinha

A autenticação de e-mail mora no DNS público do domínio, não no servidor que envia. O servidor só sabe qual valor *deveria* estar lá.

Três cenários aparecem na mesma lista e exigem tratamento diferente:

| Onde está o DNS autoritativo | O botão de reparo resolve | O que fazer |
|---|---|---||
| Zona hospedada no próprio servidor (nameservers da hospedagem) | Sim | Clicar em reparar e revalidar |
| Cloudflare, Registro.br, painel do cliente, outro provedor | Não | Copiar os valores sugeridos e colar no painel externo |
| PTR / DNS reverso do IP | Não (depende de quem controla o IP) | Pedir ao responsável pelo bloco de IP |

O PTR merece nota à parte. Ele é definido por quem controla o endereço IP, não pelo dono do domínio nem pelo painel. Em servidor dedicado ou VPS, isso é pedido ao provedor de infraestrutura. Em ambiente compartilhado, o reverso já aponta para o hostname do servidor e normalmente não é alterável por domínio.

## Três passagens para transformar a tela em inventário

O processo que funciona em lote tem três passagens. Não tente resolver domínio por domínio na primeira volta: você perde o fio.

### Classificar os domínios antes de corrigir qualquer um

Abra a tela, ordene pelos domínios com problema e copie a lista para uma planilha com quatro colunas: domínio, cliente, provedor de DNS, pendência (SPF, DKIM, PTR ou combinação). Não clique em nada ainda.

Para descobrir o provedor de DNS sem abrir painel nenhum, consulte os nameservers em lote a partir de um arquivo com um domínio por linha:

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

Isso separa, em segundos, os domínios que o servidor consegue consertar sozinho dos que vão exigir acesso externo. É a divisão que organiza todo o resto do trabalho.

### Reparar só o que tem zona DNS no próprio servidor

Só agora use o botão de reparo, e apenas nos domínios cujos nameservers são os do servidor. A documentação do cPanel descreve a ação de reparo como a instalação dos registros sugeridos na zona local. Se um domínio local continuar com problema depois do reparo, suspeite de zona duplicada, de registro SPF antigo deixado por migração ou de TTL alto ainda em cache.

### Montar os pedidos para quem controla o DNS externo

Para cada domínio com DNS fora, abra a visualização de detalhes daquele domínio na mesma tela. O cPanel mostra o valor esperado de cada registro, em formato copiável. Monte um bloco por cliente, com nome do registro, tipo e valor, e envie junto com o pedido de acesso. É mais rápido entregar o valor pronto do que explicar o conceito.

## O detalhe do DKIM que quebra o copia-e-cola

O registro DKIM é uma chave pública longa, publicada em um subdomínio no formato `seletor._domainkey.dominio.com.br`. Dois erros aparecem com frequência quando o valor é colado em painel externo:

- **Quebra de linha ou espaço no meio da chave.** Alguns painéis aceitam o texto, mas a chave publicada fica diferente da chave do servidor e a validação falha sem mensagem clara.
- **Duplicação do nome do domínio.** Em painéis que já completam o sufixo, colar `seletor._domainkey.dominio.com.br` cria `seletor._domainkey.dominio.com.br.dominio.com.br`. Nesses painéis, o nome correto é só `seletor._domainkey`.

O SPF tem um erro equivalente: publicar um segundo registro TXT começando com `v=spf1` em vez de editar o existente. Dois registros SPF no mesmo domínio invalidam a checagem. Se o cliente já tinha SPF por causa de outro serviço de envio, o caminho é mesclar os mecanismos em um único registro, não somar registros.

## Confirmar SPF, DKIM e PTR com dig em resolvedor público

O status na tela do WHM depende de quando o servidor consultou pela última vez e do cache. Confirme por fora antes de dar a tarefa por encerrada. Use um resolvedor público para não cair em cache local:

```bash
# SPF
dig +short TXT dominio.com.br @8.8.8.8

# DKIM (substitua o seletor pelo que a tela do WHM mostrou)
dig +short TXT seletor._domainkey.dominio.com.br @8.8.8.8

# PTR do IP de saída do servidor
dig +short -x 203.0.113.10 @8.8.8.8
```

O IP `203.0.113.10` acima é exemplo fictício, use o IP de envio do seu servidor.

O que verificar em cada resposta:

- **SPF**: existe exatamente um registro começando com `v=spf1` e ele inclui o mecanismo que o WHM sugeriu.
- **DKIM**: a resposta não está vazia e a chave bate com a exibida no WHM. Chave acima de 255 caracteres volta do `dig` quebrada em várias strings entre aspas, separadas por espaço: isso é o formato normal do TXT, não erro de publicação. Antes de comparar, junte as partes removendo as aspas e os espaços entre elas, por exemplo com `dig +short TXT seletor._domainkey.dominio.com.br @8.8.8.8 | tr -d '" '`. O resultado concatenado é que precisa ser idêntico ao valor do WHM.
- **PTR**: resolve para um hostname, e esse hostname resolve de volta para o mesmo IP.

Só depois de as três consultas baterem, volte ao WHM e revalide. Se o painel externo tinha TTL alto, a propagação pode levar horas: anote a data e revise, não fique recarregando a tela.

## Como pedir o acesso ao DNS sem travar o projeto

O gargalo real dessa auditoria raramente é técnico. É o cliente que não sabe onde está o DNS do próprio domínio. Uma frase pronta economiza duas semanas de e-mail:

> **** "Os e-mails do seu domínio precisam de dois registros de autenticação publicados no DNS, sem eles Gmail e Outlook tratam suas mensagens como suspeitas. Esses registros ficam no serviço que controla o endereço do site, não no site em si. Pelo que consultei, o seu está na [Cloudflare / Registro.br / painel X]. Pode me dar acesso de leitura e escrita de DNS, ou me colocar em contato com quem administra? Já tenho os dois valores prontos para publicar, a alteração leva poucos minutos e não derruba o site."

Duas coisas fazem essa mensagem funcionar: nomear o provedor específico (prova que você já pesquisou) e afirmar que o site não cai. O medo de indisponibilidade é o que faz o cliente adiar.

Quando o cliente não cede acesso, a alternativa é entregar os valores em um documento com nome, tipo e conteúdo de cada registro, e marcar o domínio na planilha como **pendente com terceiro**. Isso tira a tarefa do seu backlog e registra a responsabilidade.

## O que entra no onboarding para não refazer a auditoria

Auditar uma vez resolve o estoque. Para não refazer a cada seis meses:

- Inclua a verificação dos três registros no checklist de entrada de todo site novo, antes de apontar o domínio.
- Para clientes com DNS em Cloudflare, peça acesso de DNS no onboarding, junto com o acesso ao WordPress. Pedir depois, no meio de um problema de entrega, é mais caro.
- Guarde a planilha de inventário com a coluna de provedor de DNS preenchida. Na próxima migração de servidor, essa coluna é a diferença entre um dia e uma semana de trabalho.
- Reabra a tela de Email Deliverability depois de qualquer migração ou troca de IP: o PTR muda e o SPF pode precisar de ajuste.

Uma observação contra o interesse de quem vende hospedagem: se o problema de entrega do cliente for só autenticação ausente, trocar de plano ou de servidor não resolve nada. Publicar SPF e DKIM corretos no provedor de DNS certo resolve, e é de graça.

