Aprender
Registro SPF: sintaxe, mecanismos e exemplos
Sintaxe do registro SPF: v=spf1, mecanismos, qualificadores, o limite de 10 consultas DNS e exemplos de registro TXT para copiar e adaptar.
Referência
O registro SPF é uma linha de texto em um registro TXT do DNS: v=spf1, depois mecanismos separados por espaços, em geral terminando em all. O SPF (Sender Policy Framework) lista os servidores autorizados a enviar e-mail por um domínio. Um mecanismo é um teste feito sobre o servidor que envia. Os servidores de destino aplicam os testes da esquerda para a direita e param no primeiro que corresponder.
v=spf1 ip4:192.0.2.10 include:_spf.google.com ~all
Aqui, ip4:192.0.2.10 autoriza um servidor, include:_spf.google.com autoriza o Google Workspace e ~all dá o resultado softfail a todos os outros servidores.
Formato do registro SPF
Um registro SPF é uma versão seguida de termos separados por espaços. Um termo é um mecanismo ou um modificador.
- O registro precisa começar exatamente com
v=spf1. - Um mecanismo pode começar com um qualificador:
+,-,~ou?. Sem nenhum, vale+. - Nomes de mecanismos e modificadores não diferenciam maiúsculas de minúsculas.
- Um erro de sintaxe em qualquer parte retorna
permerror, o resultado de um registro que não pôde ser interpretado. - Sem correspondência e sem
redirect, o resultado éneutral.
Onde o registro SPF fica no DNS
Publique como registro TXT (tipo 16 do DNS) no nome exato que ele cobre. A RFC 7208 descontinuou o tipo de registro SPF separado. Cada nome tem um único registro v=spf1, e todo subdomínio que envia e-mail precisa do seu.
Os servidores verificam o domínio do endereço MAIL FROM, o remetente de envelope usado na entrega. Ele pode ser diferente do endereço From que as pessoas veem. Eles também podem verificar o nome HELO anunciado pelo servidor que envia.
Mecanismos
| Mecanismo | Corresponde a | Consulta DNS |
|---|---|---|
all |
Qualquer servidor. Fica por último. | Não |
ip4:192.0.2.0/24 |
Um endereço ou faixa IPv4. | Não |
ip6: |
Um endereço ou faixa IPv6. | Não |
a, a:mail.exemplo.com.br |
Endereços nos registros A ou AAAA do nome. | Sim |
mx, mx:exemplo.com.br |
Endereços dos hosts MX do domínio. | Sim |
include:_spf.google.com |
A verificação SPF de outro domínio, quando retorna pass. |
Sim, mais os termos internos |
exists: |
Um nome montado com macros (marcadores da mensagem), quando existe registro A para ele. | Sim |
ptr |
DNS reverso do remetente. A RFC 7208 diz para não publicar. | Sim |
a ou mx sem valor usam o domínio verificado. Sem / e prefixo, ip4: e ip6: valem um único endereço.
Registro SPF e registro A: o mecanismo a
O registro SPF é sempre um registro TXT. O mecanismo a autoriza os endereços dos registros A (IPv4) ou AAAA (IPv6) de um nome. O a sem valor autoriza qualquer endereço para o qual seu domínio aponte, então evite se o seu site estiver em hospedagem compartilhada ou em uma rede de distribuição de conteúdo (CDN).
Qualificadores e -all
| Qualificador | Resultado | Significado |
|---|---|---|
+ |
pass |
Autorizado. |
? |
neutral |
Sem afirmação. Tratado exatamente como none, o resultado quando não há registro. |
~ |
softfail |
Provavelmente não autorizado. O destino não deve rejeitar só por isso. |
- |
fail |
Não autorizado. A política local decide o que acontece. |
O Google recomenda ~all. A Microsoft recomenda -all para domínios do Microsoft 365 que também usam DKIM (assinatura de mensagens) e DMARC (a política construída sobre SPF e DKIM). Ela sugere começar um registro novo com ~all até conhecer todas as origens. Veja como fail e softfail do SPF mudam a entrega.
Cuidado: com -all, os servidores de destino podem rejeitar e-mail de qualquer servidor que você esqueceu de listar. Só adote depois que os relatórios agregados DMARC mostrarem todos os remetentes reais passando no SPF.
Modificadores
redirect=_spf.exemplo.com.br passa a verificação para outro registro, em domínios sob a mesma administração. Ele conta como consulta, e os servidores o ignoram se o registro tiver all. exp= aponta para um registro TXT que explica a falha. Usar qualquer um duas vezes retorna permerror.
Limites
- 10 consultas DNS por verificação. Contam
include,a,mx,ptr,existseredirect, além dos termos dentro de registros incluídos. Acima de 10, o resultado épermerror. - 2 consultas vazias (void lookups). A RFC 7208 diz que os servidores devem limitar a duas as consultas que não retornam dados. Acima disso, o resultado é
permerror. - 255 octetos (bytes) por string. Um registro TXT pode ter várias strings, unidas sem adicionar espaços.
Exemplos
Informe o registro como valor TXT no seu provedor de DNS, com os seus próprios IPs. Se o nome já tiver um registro v=spf1, edite esse registro em vez de criar outro. Liste todos os remetentes antes de publicar e leia o alerta sobre -all. O gerador de SPF monta um registro com os seus remetentes.
Exemplo de registro TXT SPF para um provedor
Só Google Workspace:
v=spf1 include:_spf.google.com ~all
Só Microsoft 365 (a Microsoft documenta outros valores para GCC High, DoD e 21Vianet):
v=spf1 include:spf.protection.outlook.com -all
Vários remetentes em um registro
O Google documenta esta forma para Google Workspace com Microsoft 365:
v=spf1 include:_spf.google.com include:spf.protection.outlook.com ~all
Um servidor próprio entra pelo IP público:
v=spf1 ip4:203.0.113.25 include:spf.protection.outlook.com -all
Domínio que não envia e-mail
v=spf1 -all
A Microsoft documenta esse registro para domínios estacionados. Cuidado: em um domínio que envia e-mail, ele reprova todas as mensagens.
Como dividir um registro longo
Mantenha o espaço dentro da primeira string, porque os servidores juntam as strings sem adicionar espaços:
exemplo.com.br. TXT "v=spf1 ip4:192.0.2.10 include:_spf.google.com " "include:spf.protection.outlook.com ~all"
Esta é a forma de arquivo de zona. Em um painel de DNS, o nome e o tipo vão em campos próprios. Alguns pedem strings entre aspas, outros um valor único, dividido automaticamente: confira a ajuda do provedor.
Erros comuns
- Dois registros
v=spf1no mesmo nome. A verificação retornapermerror. Una tudo em um só sem perder nenhum remetente. - Mecanismos depois de
all. Nunca são testados, entãov=spf1 ~all include:_spf.google.comdeixa o Google de fora. - Espaço ou sinal de igual no lugar errado. O espaço em
include: spf.protection.outlook.comé erro de sintaxe.include=spf.protection.outlook.comé lido como modificador desconhecido, então os servidores o ignoram e o serviço perde a autorização. - Um
include:sem registro por trás. A verificação retornapermerror. Copie cada valor da documentação do provedor. - Consultas demais. Includes aninhados contam, então menos de 10 termos
include:não garante que você está dentro do limite. - Publicar
+all. Qualquer endereço IP passa.