Ferramentas grátis

Verificador de registro SPF

Cole um domínio e veja o registro SPF dele analisado: cada mecanismo, a política para remetentes não listados, cada include e redirect percorridos e a contagem de consultas DNS contra o limite de 10. Cada achado traz uma gravidade, e uma consulta que não terminou é informada, nunca escondida.

Seus clientes também precisam publicar o seu include:

Você acabou de ver a política SPF de um domínio analisada, a cadeia de include: percorrida e as consultas DNS contadas contra o limite de dez.

Se o seu produto envia e-mail em nome dos seus clientes, cada um deles precisa adicionar o seu include: à própria zona. Uma sessão de conexão do DoDomain entrega a ele esse registro TXT junto com os de DKIM e DMARC, verifica cada registro contra o DNS autoritativo e continua conferindo depois da entrada em produção.

No card, $0 forever: the Free plan covers 50 verified connections a month.

Adicione grátis os registros de e-mail

Verificado em pela equipe DoDomain: verificamos google.com aqui e conferimos o registro SPF e o include _spf.google.com com nslookup.

O que é contado

Cada termo include:, a, mx, ptr, exists: e redirect= custa uma consulta, e o registro de cada domínio incluído é percorrido do mesmo jeito, então a contagem é o total que um receptor faria. ip4:, ip6: e all não custam nada. O verificador lê os registros TXT pelo resolver do sistema; ele não avalia um IP de remetente específico.

O que é um registro SPF e onde ele fica

SPF, Sender Policy Framework, especificado na RFC 7208, é um único registro DNS TXT que lista os hosts autorizados a enviar e-mail usando o seu domínio. Um servidor de e-mail receptor pega o domínio do remetente do envelope SMTP (o endereço MAIL FROM, para onde vão os bounces, não o cabeçalho From: que uma pessoa lê), busca o registro SPF desse domínio e o avalia contra o endereço IP que abriu a conexão. O resultado é um de sete: pass, fail, softfail, neutral, none, permerror, temperror; ele alimenta a filtragem do receptor e, quando o domínio publica DMARC, a decisão de alinhamento.

O registro fica no domínio verificado, como um registro TXT comum cujo valor começa com v=spf1. Duas consequências pegam as pessoas de surpresa. Não há herança: se mail.acme.com aparece num remetente de envelope, ele precisa de um registro próprio; o de acme.com não o cobre. E o tipo de registro SPF dedicado que os primeiros rascunhos definiram está obsoleto; o §3.1 exige a publicação como TXT, então um domínio que publicou só o registro do tipo SPF não publicou nada que os receptores vão ler.

Nomes como _spf.example.com não são uma exceção. São só os hostnames em que os fornecedores publicam os próprios registros para que você possa apontar um include: para eles; o seu registro continua no seu domínio.

Registros TXT também carregam provas de posse de domínio; o verbete do glossário sobre verificação por registro TXT explica como elas funcionam e por que um produto SaaS deveria exigir uma.

A sintaxe, termo a termo

Depois da tag de versão v=spf1, um registro é uma lista de termos separados por espaços. Cada termo é um mecanismo, que pode corresponder ao IP que conecta, ou um modificador, escrito name=value, que muda o andamento da avaliação. Os mecanismos são testados estritamente da esquerda para a direita, e o primeiro que corresponde encerra a avaliação; o qualificador dele vira o resultado. Nada depois desse ponto é lido, por isso um termo colocado depois de all é peso morto.

MecanismoCorresponde quandoConsultas DNS
allSempre. É o coringa, então é sempre o último termo que pode ser alcançado: tudo depois dele está morto.nenhuma
include:<domain>O próprio registro SPF do domínio incluído retorna pass para este IP. Só pass conta: um fail dentro de um include não faz o registro externo falhar, ele só não corresponde. Um destino de include sem registro SPF é um permerror.1, mais tudo o que o próprio registro incluído custar
a / a:<domain> / a:<domain>/<cidr>Os endereços A ou AAAA do domínio (o domínio atual quando não há argumento) contêm o IP que conecta, opcionalmente ampliados por um prefixo CIDR.1
mx / mx:<domain>O IP é um endereço de um dos hosts MX do domínio: assume-se que as máquinas que recebem o seu e-mail também o enviam.1 (o §4.6.4 limita à parte a 10 os nomes MX que ele vai resolver)
ip4:<addr>/<cidr>O IP está dentro do endereço ou da faixa IPv4 literal. Não há DNS envolvido.nenhuma
ip6:<addr>/<cidr>O IP está dentro do endereço ou da faixa IPv6 literal.nenhuma
exists:<domain>O domínio, em geral montado com macros como %{i} para que o nome codifique o IP que envia, tem algum registro A. A resposta é ignorada; só a existência importa. É assim que se publicam listas de permissão por IP.1
ptr / ptr:<domain>A consulta reversa do IP que conecta produz um nome sob o domínio, confirmado no sentido direto. A RFC 7208 §5.5 diz que ele NÃO DEVERIA ser publicado nem usado; alguns receptores o ignoram de vez.1, mais uma consulta de endereço por nome retornado

Os dois modificadores não dependem da posição, não aceitam qualificador e podem aparecer no máximo uma vez cada:

ModificadorEfeitoConsultas DNS
redirect=<domain>Quando nenhum mecanismo correspondeu, a avaliação inteira é substituída pelo registro desse domínio e o resultado dele vira o seu. §6.1: ele é totalmente ignorado se o registro também tem um mecanismo all, o motivo habitual de um redirect não fazer nada sem avisar.1
exp=<domain>Indica um registro TXT com o texto de explicação que um receptor pode incluir na mensagem de rejeição em caso de fail. Cosmético; não muda nenhum resultado.nenhuma (o §4.6.4 isenta exp do limite)

Um qualificador é o caractere na frente de um mecanismo que decide o que uma correspondência significa (§4.6.2). Omiti-lo equivale a +:

QualificadorResultadoO que diz a um receptor
+passO remetente está autorizado. É o padrão, então um mecanismo sem prefixo como include:_spf.example.com significa +include:_spf.example.com.
-failO remetente explicitamente não está autorizado. Os receptores têm o direito de rejeitar a mensagem na hora.
~softfailNão autorizado, mas não rejeite só por isso; aceite e marque. Pensado como estado intermediário enquanto um domínio ainda descobre os próprios remetentes.
?neutralNenhuma afirmação para um lado ou outro, tratado exatamente como se o domínio não tivesse publicado nenhuma política para aquele remetente.

Assim, v=spf1 include:_spf.example.net ip4:203.0.113.0/24 ~all se lê: e-mail de um host que o registro em _spf.example.net autoriza passa; e-mail de qualquer endereço em 203.0.113.0/24 passa; todo o resto dá softfail.

O limite de dez, e como cadeias de include: o estouram

O §4.6.4 limita a 10 na avaliação inteira os termos que exigem uma consulta DNS: include, a, mx, ptr, exists e o modificador redirect. A contagem é recursiva, e é isso que surpreende: um include: cujo registro de destino contém ele mesmo três includes custa quatro, não um. Como o registro de cada fornecedor é mantido por esse fornecedor, o seu total pode passar do limite num dia em que você não mudou nada. Nós medimos quanto custa o include de cada fornecedor comum: de uma consulta a sete.

Os receptores retornam permerror para qualquer remetente cuja verificação passe da 10ª consulta; quais remetentes isso atinge depende da ordem deles no registro. A mesma seção limita a duas as consultas "vazias", as que respondem sem dados.

Há quatro jeitos honestos de baixar, na ordem em que vale a pena tentar:

  • Apague o que não envia mais. Os registros acumulam ex-fornecedores; cada um é uma consulta que você recupera de graça.
  • Dê a um fornecedor o próprio subdomínio. Envie o e-mail dele como notifications.acme.com com um registro SPF próprio. Cada domínio tem o próprio orçamento de 10, e essa é a única solução que escala.
  • Troque um include pelas faixas para as quais ele resolve. Termos ip4:/ip6: não custam nada, mas agora você fixou à mão a infraestrutura de um fornecedor, e o e-mail quebra em silêncio quando ele renumerar. Faça isso só com um fornecedor que publica faixas estáveis, e marque uma nova verificação na agenda.
  • Tire ptr, e tire mx se o seu e-mail é só de entrada. Os dois costumam estar ali por hábito, não por necessidade.

Serviços automáticos de "SPF flattening" fazem a terceira opção por você num cronograma. Isso tira o trabalho de manutenção, mas adiciona uma dependência cujo modo de falha é o seu e-mail deixar de autenticar sem aviso, então trate isso como infraestrutura, não como algo que se arruma e se esquece.

~all ou -all, e por que só pode existir um registro

-all diz aos receptores que um host que você não listou não está autorizado, ponto; eles podem rejeitar a mensagem. ~all diz o mesmo, mas pede que aceitem e marquem. O conselho de sempre (publicar ~all enquanto você ainda descobre quais sistemas enviam como o seu domínio, e depois passar para -all) é sobre a sua confiança na lista, não sobre rigor por si só.

Se você publica DMARC, a escolha importa menos do que parece: o DMARC só conta um pass de SPF para o alinhamento, então softfail e fail são para ele o mesmo não-pass e a sua política DMARC decide o resultado. A diferença ainda pesa nos receptores que agem só com base no SPF. ?all e um registro sem nenhum all são ainda mais fracos: os dois deixam neutral os remetentes que não correspondem, que é a situação de um domínio sem registro SPF.

Seja qual for a escolha, publique uma vez só. O §3.2 proíbe dois registros v=spf1 no mesmo nome e o §4.5 faz a verificação dar permerror quando um receptor os encontra; eles não juntam os registros nem escolhem o mais rígido, eles abandonam a verificação. Isso costuma acontecer quando o assistente de configuração de um segundo provedor adiciona o próprio registro TXT em vez de editar o que já existia. Juntar é só colocar os dois termos include: num registro. Isso é diferente do tamanho: o DNS transmite um valor TXT longo em vários pedaços que são concatenados de volta, então um registro com mais de 255 caracteres é válido, e dois registros nunca são.

O que este verificador informa, e o que corrige cada achado

Cada achado que a ferramenta imprime é um dos códigos abaixo, com uma gravidade. Eles são o vocabulário completo do verificador: se um registro não gera nenhum achado além de info, não havia nada a informar.

AchadoO que significaComo corrigir
no_recordNenhum registro TXT v=spf1 no nome, então os receptores não têm política para avaliar e o resultado é none.Publique um registro TXT no próprio domínio, listando os seus remetentes e terminando em ~all ou -all.
multiple_recordsDois ou mais registros v=spf1 no mesmo nome. O §3.2 proíbe isso e o §4.5 faz a verificação dar permerror: os receptores não escolhem um, eles desistem do registro inteiro.Junte-os num único registro combinando os termos e apague os excedentes. Isso costuma acontecer quando o assistente de configuração de um fornecedor adiciona o próprio registro em vez de editar o seu.
unknown_termUm termo que não é nem um mecanismo definido nem um modificador reconhecido. Um mecanismo que não pode ser analisado é um erro de sintaxe, e o §4.6.1 faz de um erro de sintaxe um permerror. (Já um modificador não reconhecido, diz o §6, os receptores devem ignorar, então este achado trata do termo que de fato vai quebrar a verificação.)Corrija o erro de digitação ou apague o termo. Atenção a uma vírgula solta, um ponto e vírgula ou um mecanismo escrito com = em vez de :.
terms_after_allHá termos depois de all. A avaliação para na primeira correspondência e all sempre corresponde, então esses termos nunca são alcançados.Mova para antes de all os remetentes que você queria autorizar, ou apague-os se forem sobras de um registro antigo.
all_pass+all, ou um all sem prefixo, autoriza qualquer host da internet a enviar como o seu domínio.Troque por ~all ou -all. Não existe motivo legítimo para publicar +all.
all_neutral?all não afirma nada sobre remetentes não listados, a mesma situação de não ter registro para eles.Passe para ~all quando tiver razoável confiança de que listou os seus remetentes, e depois para -all.
no_allNenhum mecanismo all e nenhum redirect, então os remetentes que não correspondem caem no neutral implícito do §4.7.Termine o registro com ~all ou -all para que a política seja explícita.
ptr_mechanismptr está obsoleto pelo §5.5: é lento, sobrecarrega os operadores de DNS reverso de cada rede que envia, e os receptores podem ignorá-lo.Apague-o e autorize esses remetentes com ip4:, ip6: ou um include: no lugar.
lookup_limit_exceededMais de 10 termos que consultam o DNS na avaliação recursiva inteira. Os receptores retornam permerror para qualquer remetente cuja verificação passe da 10ª consulta; quais remetentes isso atinge depende da ordem deles no registro.Tire os includes de serviços que não enviam mais, troque um include pelas faixas ip4:/ip6: para as quais ele resolve hoje ou mova um fornecedor para um subdomínio próprio com registro próprio.
redirect_ignoredUm modificador redirect= ao lado de um mecanismo all. O §6.1 diz que o redirect é ignorado, então o registro não faz o que parece fazer.Apague o mecanismo all se você queria que o redirect valesse, ou apague o redirect se você queria o all.
include_target_missingUm destino de include: ou redirect= não publica nenhum registro SPF. O §5.2 faz de um destino de include ausente um permerror.Remova o include ou pergunte ao fornecedor em qual hostname ele realmente publica o registro; o texto dos assistentes muitas vezes indica o errado.
record_too_longO registro é longo o bastante para que resolvers e receptores reais comecem a truncá-lo ou recusá-lo.Encurte do mesmo jeito que se reduz uma contagem de consultas: menos includes, faixas IP agrupadas, remetentes divididos em subdomínios.
uncheckedUma leitura DNS de que a análise precisava não terminou, então a contagem de consultas acima é um mínimo e o registro não está sendo chamado de válido.Rode a verificação de novo. Se continuar acontecendo, os servidores de nomes do domínio incluído são o ponto a olhar: os receptores sofrem o mesmo timeout, e um timeout num include é um temperror para o seu e-mail.

Como SPF, DKIM e DMARC se encaixam

O SPF responde a uma pergunta estreita (este IP pode enviar por este domínio de envelope?) e tem um ponto cego conhecido: o encaminhamento. Um encaminhador reenvia a sua mensagem a partir do próprio endereço, que o seu registro não lista, então a verificação falha sem culpa da configuração.

O DKIM cobre essa lacuna pelo outro lado. O sistema que envia assina a mensagem com uma chave privada e publica a metade pública em <selector>._domainkey.example.com; a assinatura viaja com o e-mail e continua verificável depois de um salto. O DMARC, publicado em _dmarc.example.com, é a camada que faz qualquer um dos dois sinais significar algo para o destinatário: ele exige que o domínio visível do From: se alinhe com o domínio que passou no SPF ou no DKIM, diz o que os receptores devem fazer quando nenhum se alinha e pede relatórios agregados para você ver quem envia em seu nome antes de aplicar a política. Três registros, três nomes, um propósito.

Registros SPF no domínio de um cliente

Se o seu produto envia e-mail em nome de clientes, cada cliente precisa adicionar o seu include: a um registro TXT no próprio DNS, o mesmo tipo de mudança, e o mesmo problema de onboarding travado, que apontar um hostname para a sua plataforma. O DoDomain gera e verifica esses registros como parte de uma sessão de conexão; o guia de múltiplos registros e e-mail explica o que cada caminho de conexão consegue fazer com um registro SPF, DKIM ou DMARC, incluindo o limite de um include por sessão do template do Domain Connect. Para a parte do hostname, o guia de domínios apex é o que se deve ler antes de prometer a um cliente que o domínio raiz dele vai funcionar.

Duas verificações daqui combinam com esta: o verificador de propagação DNS lê um único registro nos servidores autoritativos da zona e em três resolvers públicos, que é como você distingue "o registro TXT está errado" de "o registro TXT está certo e ainda não está em cache", e o detector de provedor DNS diz qual host realmente atende a zona que você precisa editar.

Perguntas frequentes

O que é o limite de dez consultas do SPF?

A RFC 7208 §4.6.4 limita a 10 por avaliação os mecanismos que precisam de uma consulta DNS (include, a, mx, ptr, exists e o modificador redirect), contados recursivamente por cada include. Um registro acima do limite retorna permerror nos receptores, que a maioria trata como uma verificação falha, então um domínio pode quebrar o próprio e-mail adicionando mais um include de terceiros.

Qual a diferença entre -all, ~all e ?all?

-all (hard fail) pede aos receptores que rejeitem e-mail de remetentes que o registro não lista; ~all (soft fail) pede que aceitem mas marquem, que é o que configurações alinhadas ao DMARC costumam publicar; ?all (neutral) não afirma nada, então não dá ao DMARC nada com que se alinhar; +all autoriza qualquer remetente e derruba o propósito do registro.

Por que o verificador diz verificado parcialmente?

Uma leitura DNS da qual a análise dependia, o TXT do próprio domínio ou o de um domínio incluído, não terminou. A ferramenta então informa o que conseguiu ler, mostra a contagem de consultas como um mínimo e se recusa a chamar o registro de válido, porque um resultado limpo com dados parciais seria um palpite.

Isso corrige o meu registro SPF?

Não; ele diz o que está errado e onde. Correções comuns: publicar exatamente um registro v=spf1, tirar ptr, trocar um include que por sua vez inclui muitos domínios pelas faixas IP para as quais ele resolve, e terminar com ~all ou -all em vez de ?all ou nada.

Onde fica um registro SPF, e preciso de um subdomínio como _spf?

No próprio domínio, como um registro TXT comum cujo valor começa com v=spf1. Nomes como _spf.example.com são só os destinos de include que os fornecedores publicam; não é ali que fica o seu próprio registro. O SPF também não é herdado: mail.example.com não usa o registro de example.com, então um subdomínio que envia e-mail precisa do seu.

Posso publicar dois registros SPF se uso dois provedores de e-mail?

Não. A RFC 7208 §3.2 proíbe mais de um registro v=spf1 no mesmo nome e o §4.5 faz a verificação dar permerror quando isso ocorre, então os receptores não escolhem entre eles: a verificação inteira falha. Combine os dois provedores num registro colocando os dois termos include: nele. Um único registro TXT com mais de 255 caracteres não tem problema, porque o DNS o divide em pedaços que são juntados de volta; dois registros separados, sim.

O SPF protege o endereço From que os meus destinatários veem?

Não sozinho. O SPF autentica o remetente do envelope usado na conversa SMTP, que os destinatários nunca veem; uma mensagem pode passar no SPF mostrando qualquer cabeçalho From: que quiser. O DMARC é a peça que exige que o domínio visível do From: se alinhe com o domínio do SPF (ou do DKIM), e diz aos receptores o que fazer quando não se alinha.

Por que o meu e-mail começou a falhar no SPF depois de ser encaminhado?

Porque o encaminhamento reenvia a mensagem a partir do endereço IP do encaminhador, que o seu registro não lista. É um limite conhecido do SPF, não um erro de configuração, e é a razão de o DKIM existir: uma assinatura DKIM viaja com a mensagem e sobrevive ao salto, então uma política DMARC que aceita qualquer um dos dois sinais mantém entregável o e-mail encaminhado.

Mais ferramentas grátis

We use analytics cookies to understand how DoDomain is used. The sign-in cookie is essential and is set regardless; the privacy policy names every service involved. Privacy policy