Pular para o conteúdo
Português - Brasil
  • Não há sugestões porque o campo de pesquisa está em branco.

Mecanismos SPF: include, a, mx, ip4, ip6, redirect

include, a, mx, ip4 e ip6 são mecanismos do SPF: cada um descreve um conjunto de endereços IP e, se o IP do servidor que está se conectando estiver nesse conjunto, o mecanismo corresponde e decide o resultado do SPF. O redirect é diferente. Ele é um modificador que entrega a avaliação inteira ao registro de outro domínio quando nada mais correspondeu. Os outros mecanismos são all, que corresponde a tudo e fica no fim, exists, uma ferramenta para especialistas, e ptr, que você não deve usar. Seis termos (include, a, mx, exists, ptr e redirect) custam uma consulta DNS cada, e isso importa porque uma verificação pode usar no máximo 10.

Para ver como os termos se encaixam em um registro completo (a sintaxe do registro SPF como um todo), consulte Como escrever um registro SPF.

Como os termos são lidos

Um registro SPF é v=spf1 seguido de termos separados por espaços. Os destinatários os avaliam da esquerda para a direita, e o primeiro mecanismo que corresponde vence. O qualificador dele define o resultado:

Qualificador Resultado quando corresponde
+ (ou nada) pass
- fail
~ softfail
? neutral

Portanto, ip4:192.0.2.10 e +ip4:192.0.2.10 significam a mesma coisa. Os nomes de mecanismos e modificadores não diferenciam maiúsculas de minúsculas. Modificadores desconhecidos são ignorados.

Tabela de referência

Termo Tipo O que faz Custa uma consulta DNS?
ip4:<address>[/prefix] mecanismo Corresponde se o endereço IPv4 estiver nessa rede. O padrão é /32, um único endereço. Escreva as faixas na forma CIDR: 192.0.2.0/24, não 192.0.2. Não
ip6:<address>[/prefix] mecanismo O mesmo para IPv6. O padrão é /128. Não
a[:domain][/prefix] mecanismo Corresponde se o IP for um dos endereços A ou AAAA do domínio. Sem domínio, usa o domínio atual. Sim
mx[:domain][/prefix] mecanismo Consulta os hosts MX do domínio e, depois, os endereços deles. Um termo mx que precise de mais de 10 consultas de endereço retorna permerror. Sim
include:<domain> mecanismo Executa uma verificação SPF completa com o registro de outro domínio e só corresponde se essa verificação retornar pass. Um destino sem registro SPF gera permerror. Sim, mais todas as consultas dentro do registro incluído
exists:<domain> mecanismo Corresponde se o nome (normalmente montado com macros) tiver um registro A. Para especialistas. Sim
ptr[:domain] mecanismo Teste de DNS reverso. Não o publique. Sim
all mecanismo Sempre corresponde. Coloque-o por último; tudo o que vier depois é ignorado. Não
redirect=<domain> modificador Usado apenas se nenhum mecanismo correspondeu. O resultado do registro de destino passa a ser o resultado deste registro. Ignorado se o registro contiver all. Sim
exp=<domain> modificador Aponta para um texto explicativo que um destinatário pode mostrar em caso de fail. Não

As regras de consultas, incluindo as aninhadas, estão em O limite de 10 consultas e o permerror do SPF.

include: “permita também quem aquele domínio permite”

O include é a forma de autorizar um serviço operado por outra empresa, como o seu provedor de caixa postal ou uma plataforma de marketing:

v=spf1 include:_spf.google.com include:spf.protection.outlook.com ~all

O nome engana: ele não copia o outro registro para dentro do seu. Ele avalia aquele registro separadamente e usa apenas o resultado:

  • Se o registro incluído retornar pass, o seu include corresponde e o seu resultado é pass (ou o qualificador que você colocou no include).
  • Se ele retornar fail, softfail ou neutral, o seu include simplesmente não corresponde, e a avaliação segue para o seu próximo termo.
  • Se ele retornar temperror ou permerror, esse erro volta para a sua verificação.

É por isso que um -all de um fornecedor dentro do registro dele não torna o seu registro rígido e não encerra a sua avaliação. O seu próprio all final continua decidindo tudo o que não correspondeu.

Duas consequências práticas:

  • Um include: que aponta para um domínio sem registro SPF gera permerror. Erros de digitação e fornecedores desativados são a causa habitual.
  • Um include pode autorizar muito mais do que você imagina, porque você está confiando em tudo o que o outro domínio lista. O SPF autoriza infraestrutura, não clientes individuais, então qualquer pessoa que envie pela mesma plataforma compartilhada pode passar para o seu domínio. Adicione apenas includes que o fornecedor documenta e remova-os quando deixar de usar o fornecedor.

Como escolher entre o include: de um fornecedor e o DKIM alinhado (alignment) desse fornecedor está em Include SPF ou DKIM do fornecedor; como adicionar um fornecedor de ponta a ponta está em Como adicionar um remetente terceirizado sem quebrar o DMARC.

redirect: “use a resposta inteira daquele registro”

O redirect serve para compartilhar uma política entre domínios que você controla. Se você tem muitos domínios de marca, cada um pode apontar para um único registro mantido:

brand-a.example.  TXT  "v=spf1 redirect=_spf.example.com"
brand-b.example.  TXT  "v=spf1 redirect=_spf.example.com"

Quando nada no registro correspondeu, o destinatário avalia _spf.example.com e usa o resultado dele, incluindo o próprio all daquele registro. Algumas regras importam:

  • Ele é ignorado se all aparecer em qualquer lugar do registro. v=spf1 include:_spf.google.com redirect=_spf.example.com ~all nunca usa o redirect.
  • Um destino de redirect sem registro SPF gera permerror.
  • Use-o no máximo uma vez. Coloque-o por último, embora essa posição não seja obrigatória.
  • Use-o apenas para domínios sob o seu próprio controle administrativo. Não é possível redirecionar de forma confiável para um domínio que você não controla.

Para autorizar dois fornecedores, use dois includes e a sua própria terminação, v=spf1 include:vendor-a.example include:vendor-b.example ~all. Escrever include:vendor-a.example redirect=vendor-b.example é uma sintaxe válida, mas dá ao registro do fornecedor B o controle sobre o seu resultado final.

a e mx: use apenas quando for isso mesmo que você quer

a e mx são práticos, mas cada um custa uma consulta, e eles acompanham o seu DNS: se você mudar o seu site ou os seus hosts MX, o conjunto de IPs autorizados muda junto. Na maioria dos casos, a e mx já não são a melhor escolha. O a mx que alguns modelos colocam no início de todo registro muitas vezes autoriza servidores web que nunca enviam e-mails.

Use mx apenas se os seus servidores de e-mail de entrada realmente enviarem e-mails de saída. Para os seus próprios servidores fixos, ip4: e ip6: são mais baratos e exatos.

Uma correção ao que você verá em outros guias: se o seu registro não tiver o mecanismo mx, os destinatários não recorrem aos seus registros MX. Sem correspondência e sem redirect, o resultado é neutral.

exists, ptr e macros

  • exists verifica se um nome é resolvido. É usado principalmente com macros do SPF, como %{i} (o IP do remetente), para montar nomes por mensagem. Se o nome não existir, isso é apenas uma ausência de correspondência; a avaliação continua. É uma ferramenta avançada para grandes remetentes, e raramente você vai precisar dela.
  • ptr depende do DNS reverso. É lento, pouco confiável e sobrecarrega os servidores de DNS reverso. Não o publique, e remova-o se o encontrar.

all: a terminação

all corresponde a tudo o que sobrou, então o qualificador dele define o resultado para todos os servidores que você não listou. O nosso padrão para domínios que enviam e-mails é ~all; v=spf1 -all é o certo para domínios que não enviam e-mails. Nunca use +all ou um all sem qualificador, que autorizam a internet inteira. A comparação completa está em Softfail ou fail (~all ou -all).

Erros que vale a pena evitar

  • redirect= junto com ~all ou -all, de forma que o redirect é ignorado silenciosamente.
  • Um include: de um fornecedor que você não usa mais. Ele desperdiça consultas e continua autorizando esse fornecedor.
  • O a mx colocado por hábito no início do registro.
  • ip4:192.0.2 (truncado) em vez de ip4:192.0.2.0/24.
  • include=domain, ou um espaço depois dos dois-pontos.

Se você passou de 10 consultas, consulte O limite de 10 consultas e o permerror do SPF e Permerror do SPF: consultas DNS demais. Se você precisa listar uma fonte deliberadamente permissiva, mas não quer que ela gere um pass do SPF para o DMARC, pode dar a ela o qualificador ?. Esse é um caso avançado; configurações de envio compartilhadas são tratadas em Domínios compartilhados e configurações com vários serviços.

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

Criar uma conta DMARC gratuitaFalar com um especialista

Perguntas frequentes

Qual é a diferença entre include e redirect?

O include diz “permita também quem aquele outro domínio permite”, e o seu registro continua decidindo todo o resto. O redirect diz “use a resposta inteira daquele outro registro”, e serve para domínios que você controla.

O ip4 usa uma consulta DNS?

Não. ip4, ip6 e all não contam. include, a, mx, ptr, exists e redirect contam.

O mecanismo a do SPF é o mesmo que um registro DNS A?

Não. Um registro DNS A associa um nome a um endereço IP. O mecanismo a do SPF usa os registros A (e AAAA) de um domínio para decidir quais IPs correspondem, e custa uma consulta.

Devo usar ptr?

Não. Não o publique.

Por que o include de um fornecedor com -all não faz tudo falhar?

Porque o include só procura um pass no outro registro. Qualquer outra coisa significa apenas “nenhuma correspondência aqui”, e o seu registro segue em frente.