Como escrever um registro SPF
Um registro SPF é um único registro DNS TXT, publicado no domínio que seus e-mails usam como remetente do envelope, que começa com v=spf1, lista os servidores e serviços autorizados a enviar e termina com um único termo all. Escreva-o uma vez, com cuidado, e edite esse mesmo registro sempre que adicionar um remetente. As causas típicas de um registro quebrado são um segundo registro, um erro de digitação, um fornecedor esquecido ou includes aninhados demais, e qualquer uma delas pode transformar um registro que funciona em um erro para todos os seus e-mails.
Sintaxe do registro SPF
O formato do registro SPF é curto:
v=spf1 <term> <term> <term> ... <all>
v=spf1vem primeiro, exatamente assim. Um registro que comece com qualquer outra coisa, mesmov=spf10, é descartado. Ele não é tratado como registro SPF.- Os termos são separados por espaços simples. Eles são mecanismos (
ip4,ip6,a,mx,include,exists,ptr,all) ou modificadores (redirect=,exp=). O que cada um faz está em Mecanismos SPF: include, a, mx, ip4, ip6, redirect. - Um mecanismo pode ter um qualificador:
+pass (o padrão quando você não escreve nada),-fail,~softfail,?neutral. - Os destinatários leem da esquerda para a direita, e a primeira correspondência vence. Nada depois de
allé avaliado. - Termine com um
allexplícito (ou umredirect). Sem ele, os e-mails sem correspondência recebem um resultado neutral implícito. - Um único erro de sintaxe em qualquer lugar quebra o registro inteiro. O resultado passa a ser
permerror, e não “tudo, exceto o termo errado”.
Um registro típico para uma empresa que envia a partir do próprio servidor e do Google Workspace:
v=spf1 ip4:192.0.2.10 include:_spf.google.com ~all
Leia assim: “192.0.2.10 pode enviar, o que o registro do Google autoriza pode enviar, e qualquer outra coisa provavelmente não está autorizada”.
Onde publicá-lo
Publique o registro no domínio que aparece no MAIL FROM (o Return-Path) e em todos os nomes de host que seus servidores usam no HELO. Muitas vezes, esse é o seu domínio principal. Mas, se uma plataforma pedir que você configure um subdomínio de devolução como bounce.example.com, é esse subdomínio que será verificado, e ele precisa do seu próprio registro. Subdomínios não herdam o SPF do domínio pai.
Para o DMARC, esse domínio do MAIL FROM também precisa estar alinhado (alignment) com o seu domínio From visível. Se a diferença entre os dois endereços é novidade para você, leia primeiro Envelope From ou Header From.
Domínios que não enviam nenhum e-mail recebem um registro de uma linha:
v=spf1 -all
Essa é a forma que usamos. Você verá alguns guias sugerindo ~all para domínios que não enviam; nós usamos -all em domínios que não enviam e-mails.
Como criar um registro SPF, passo a passo
- Liste todos os sistemas que enviam com o seu domínio no
MAIL FROM. Provedor de caixa postal, plataforma de marketing, CRM, help desk, cobrança, formulários web, servidores locais. Seus relatórios agregados do DMARC são a melhor forma de encontrar aqueles de que ninguém se lembrava (Como fazer o inventário das fontes de envio, Um relatório agregado DMARC explicado campo a campo). - Verifique se já existe um registro
v=spf1nesse nome. Se existir, edite-o. Não adicione um segundo; dois registros fazem o SPF retornar um erro permanente (Vários registros SPF (por que isso é inválido)). - Adicione o
include:documentado de cada fornecedor, ou as faixas de IP documentadas por ele. Useip4:eip6:para os seus próprios servidores fixos. Se um fornecedor lhe entregar uma linhav=spf1 ...completa, copie apenas a parteinclude:para o seu registro. - Prefira os termos baratos. Para os seus próprios servidores fixos,
ip4eip6são mais baratos e exatos.mxé mais caro porque precisa de consultas DNS extras. Não useptr. - Conte as consultas DNS.
include,a,mx,ptr,existseredirectcustam uma cada, e o mesmo vale para cada um desses dentro de um registro incluído. Fique em 10 ou menos (O limite de 10 consultas e o permerror do SPF). - Escolha a terminação. Para domínios que enviam e-mails, recomendamos
~all.-alltambém é válido; os prós e contras, incluindo o risco de rejeição antecipada antes de o DMARC ser executado, estão em Softfail ou fail (~all ou -all). Nunca termine com+allou com umallsem qualificador: os dois autorizam todos os servidores da internet. - Publique-o como um registro DNS TXT. Use o formulário TXT do seu provedor de DNS. Alguns provedores querem o valor entre aspas, e a maioria usa
@para o próprio domínio (o apex da zona). Não crie um registro do antigo tipo “SPF”; esse tipo foi descontinuado. - Dê tempo ao tempo. Mudanças de DNS podem levar até 48 horas para aparecer em todos os lugares; o tempo real depende dos seus TTLs. Um TTL de pelo menos 3600 segundos é um padrão sensato para registros SPF. Mantenha a política antiga válida por um tempo depois de uma mudança, já que e-mails que já estão em trânsito podem ser verificados com a nova.
- Verifique. Envie uma mensagem de teste e procure
spf=passno cabeçalhoAuthentication-Results, comsmtp.mailfrom=mostrando o domínio que você esperava. Depois, acompanhe os resultados do SPF por fonte nos seus relatórios agregados do DMARC.
Registros longos
Uma única string dentro de um registro TXT pode ter no máximo 255 caracteres, mas um registro pode conter várias strings. Os destinatários as juntam sem adicionar espaços, então coloque o espaço dentro de uma string:
"v=spf1 ip4:192.0.2.1 ip4:192.0.2.129 " "include:_spf.google.com ~all"
Continua sendo um único registro. Mantenha também a resposta DNS inteira pequena, de preferência abaixo de 512 octetos.
Exemplos de registro SPF
Todos estes exemplos usam faixas de IP de documentação. As linhas do Microsoft 365 terminam em -all, que é a terminação que o Microsoft 365 normalmente usa; as demais terminam em ~all, o nosso padrão para domínios que enviam e-mails.
| Situação | Registro |
|---|---|
Seus próprios dois servidores (um registro compacto usando apenas ip4) |
v=spf1 ip4:192.0.2.1 ip4:192.0.2.129 ~all |
| Registro SPF apenas para o Google Workspace | v=spf1 include:_spf.google.com ~all |
| Registro SPF apenas para o Microsoft 365 | v=spf1 include:spf.protection.outlook.com -all |
| Google Workspace e Microsoft 365 | v=spf1 include:_spf.google.com include:spf.protection.outlook.com ~all |
| Um servidor local mais o Microsoft 365 | v=spf1 ip4:203.0.113.10 include:spf.protection.outlook.com -all |
| Um domínio que não envia e-mails | v=spf1 -all |
Para domínios do Microsoft 365, a Microsoft recomenda -all porque também recomenda DKIM e DMARC. Essa é uma orientação da plataforma para o Microsoft 365; os nossos motivos para usar ~all em domínios que enviam e-mails estão em Softfail ou fail (~all ou -all). Os detalhes de cada plataforma estão em DMARC para Microsoft 365 e DMARC para Google Workspace, e como adicionar uma plataforma de marketing ou de CRM é explicado em Como adicionar um remetente terceirizado sem quebrar o DMARC.
Erros de sintaxe que quebram o registro
Estes erros de sintaxe são comuns:
| Errado | Problema | Certo |
|---|---|---|
include:spf.protection.outlook.com. |
Ponto final no fim | include:spf.protection.outlook.com |
include=spf.protection.outlook.com |
Sinal de igual em vez de dois-pontos | include:spf.protection.outlook.com |
include: spf.protection.outlook.com |
Espaço depois dos dois-pontos | include:spf.protection.outlook.com |
Outros a observar:
allno meio do registro, de forma que tudo o que vem depois é ignorado.- Strings divididas que se juntam sem espaço (
...129""include...). - Registros
v=spf2.0(Sender ID) que sobraram ou registros antigos do tipo SPF. Exclua-os. - Faixas muito amplas, como um /16, ou faixas amplas de nuvem compartilhada. Evite-as.
Erros de digitação, espaços extras ou o uso incorreto de aspas podem tornar o registro SPF inválido. Mais em Erros comuns de SPF.
Quem deve editá-lo
Trate o registro como um ativo compartilhado com um único responsável. Quando várias equipes “adicionam o SPF” cada uma para a sua ferramenta, você acaba com dois registros ou com um registro que ninguém consegue explicar. Quem costuma ser responsável por SPF, DKIM e DMARC explica como dividir esse trabalho.
Conta DMARC gratuita
Transforme relatórios DMARC brutos em um painel fácil de ler
Aponte seu endereço rua para a nossa plataforma e leia os resultados por remetente e por fonte, em vez de abrir arquivos XML.
- Resultados agrupados por fonte de envio
- Resultados de SPF, DKIM e alinhamento por remetente
- Os relatórios XML originais continuam disponíveis para download
Perguntas frequentes
Onde exatamente coloco o registro SPF?
No domínio do MAIL FROM do envelope (Return-Path), como um registro TXT. Para o seu domínio principal, a maioria dos provedores de DNS usa @.
Meu fornecedor me deu uma linha v=spf1 ... completa. Devo colá-la como um novo registro?
Não. Copie apenas o include: dela (ou os IPs) para o seu registro existente, antes do seu all.
Subdomínios precisam do próprio registro SPF?
Sim, se forem usados no MAIL FROM ou no HELO.
Com aspas ou sem aspas?
Depende do formulário do seu provedor de DNS. O que importa é que o resultado seja um único registro TXT com um único valor v=spf1.
Devo terminar com ~all ou -all?
Recomendamos ~all para domínios que enviam e-mails e v=spf1 -all para domínios que não enviam. Nunca +all. A comparação completa está em Softfail ou fail (~all ou -all).