Pular para o conteúdo
DMARC Pulse
Guias

Mailgun

Como configurar DMARC no Mailgun: SPF, DKIM e registro DMARC

Configurar DMARC no Mailgun: SPF e DKIM do painel, verificação do domínio e coleta de relatórios preservando sua política existente.

Para configurar DMARC no Mailgun, você cuida de duas partes. O Mailgun fornece os registros SPF e DKIM do seu domínio de envio. O registro DMARC você mesmo publica no seu provedor de DNS. O SPF lista os servidores autorizados a enviar por um domínio. O DKIM adiciona uma assinatura criptográfica a cada mensagem. O DMARC diz aos servidores de destino o que fazer quando nenhum dos dois está alinhado com o domínio do seu From.

Antes de começar

O Mailgun recomenda que todos os clientes enviem por um subdomínio, como mg.exemplo.com.br. O subdomínio tem reputação própria, separada da reputação do domínio raiz. Ele também permite adicionar os MX do Mailgun, que direcionam os e-mails recebidos, sem mexer na caixa de entrada de exemplo.com.br.

Adicione o domínio no painel do Mailgun em Send → Sending → Domains, com o botão Add new domain. Escolha a Domain region (EUA ou UE) nessa etapa, porque os domínios na UE usam outros hosts. Depois abra o domínio e encontre os registros em Domain Verification & DNS. Copie os valores de lá, já que o registro DKIM é específico do seu domínio.

Passo 1: registro SPF do Mailgun

No domínio que você adicionou ao Mailgun (por exemplo, mg.exemplo.com.br), crie um registro TXT com este valor:

TXT
v=spf1 include:mailgun.org ~all

Se esse nome já tiver um registro SPF, acrescente include:mailgun.org a ele. Cada nome deve manter um único registro SPF, e o resultado fica parecido com v=spf1 include:_spf.exemplo.com.br include:mailgun.org ~all. Hoje o mailgun.org publica as faixas dos EUA e da UE, então o mesmo include serve para as duas regiões.

O SPF verifica o remetente do envelope (o endereço oculto MAIL FROM, também chamado de Return-Path), que o Mailgun baseia no seu domínio de envio. O DMARC só conta o SPF quando esse domínio está alinhado com o seu From. O alinhamento relaxado, padrão do DMARC, trata mg.exemplo.com.br e exemplo.com.br como a mesma organização. Por isso o SPF pode alinhar tanto ao enviar como @exemplo.com.br quanto como @mg.exemplo.com.br.

Passo 2: DKIM no Mailgun

O Mailgun publica o DKIM de uma de duas formas, e o painel mostra a que o seu domínio usa. As duas dependem de um seletor, o rótulo antes de ._domainkey no nome do registro, que indica ao destinatário qual chave buscar.

  • Chave TXT. O Mailgun entrega um registro TXT. Copie o nome e o valor exatamente como aparecem, porque o seletor muda de domínio para domínio. As chaves têm 1024 ou 2048 bits. O Mailgun descreve a de 2048 bits como mais segura e mais trabalhosa de configurar.
  • Automatic Sender Security. Você adiciona dois registros CNAME, pdk1._domainkey.mg.exemplo.com.br e pdk2._domainkey.mg.exemplo.com.br. Cada um aponta para um nome hospedado pelo Mailgun, que você copia do painel. O manual do Mailgun traz pdk1._domainkey.9d876.dkim1.mailgun.com como exemplo. O Mailgun então gera duas chaves de 2048 bits e faz a rotação a cada 120 dias por padrão. Você pode mudar esse intervalo, com mínimo de 5 dias.

O Mailgun assina com o seu domínio de envio em d=, o campo de domínio da assinatura. Um subdomínio também pode compartilhar a autoridade DKIM do domínio raiz quando os dois estão na mesma conta do Mailgun. Nesse caso o registro pode ficar no domínio raiz, então use o nome que o painel mostrar. O DKIM alinha no modo relaxado nos dois casos.

Passo 3: registros MX e de rastreamento

A tabela de verificação do Mailgun marca SPF, DKIM, um CNAME de rastreamento e MX como obrigatórios. O DMARC em si só lê SPF e DKIM.

  • MX: mxa.mailgun.org e mxb.mailgun.org, prioridade 10. Domínios na UE usam mxa.eu.mailgun.org e mxb.eu.mailgun.org. O Mailgun precisa deles para receber e-mails nesse nome e só rastreia bounces tardios quando eles apontam para o Mailgun. Se o mesmo nome já recebe e-mail em outro lugar, o FAQ do Mailgun orienta a não apontar os MX desse nome para o Mailgun.
  • CNAME de rastreamento: email.mg.exemplo.com.br → mailgun.org (domínios na UE: eu.mailgun.org). Ele alimenta o rastreamento de aberturas, cliques e descadastros. O prefixo email é o padrão e pode ser alterado.

Reserve de 24 a 48 horas para o DNS propagar. O Mailgun verifica sozinho, ou você pode clicar em Verify DNS settings em Domain Settings. Um domínio verificado exibe o selo verde Verified.

Passo 4: registro DMARC

Os registros de verificação do Mailgun não incluem o DMARC. Crie-o no seu provedor de DNS, como um registro TXT chamado _dmarc no domínio raiz:

Use este valor inicial somente se não existe política DMARC nesse nome. Caso contrário, edite o registro existente preservando p=, alinhamento e destinatários de relatórios; adicione ali seu destino rua monitorado. Não crie outro registro de política.

TXT
v=DMARC1; p=none; rua=mailto:dmarc@exemplo.com.br

A política p=none só monitora. Troque o endereço de rua, para onde os servidores de destino enviam os relatórios agregados, pelo endereço de relatórios que o DMARC Pulse fornece para esse domínio.

O destinatário procura o _dmarc primeiro no domínio do From. Se não encontrar, sobe na árvore de DNS, então _dmarc.exemplo.com.br também cobre mg.exemplo.com.br, a menos que o subdomínio tenha registro próprio. No alinhamento relaxado (r), o padrão, mg.exemplo.com.br pode alinhar com exemplo.com.br. Preserve os valores existentes de adkim e aspf; o modo estrito exige domínios idênticos, como explicado abaixo.

Passo 5: confira e depois endureça a política

Envie uma mensagem de teste pelo Mailgun e cole os cabeçalhos no Analisador de Cabeçalhos. Procure spf=pass, dkim=pass com o seu domínio em header.d= e dmarc=pass. O Mailgun informa que assina duas vezes as mensagens de muitos clientes, com um domínio da plataforma e com o seu subdomínio. Só a assinatura com o seu domínio pode alinhar, então confira essa. O verificador de DMARC confirma que o registro está publicado.

Preserve a política, o alinhamento e os destinatários dos relatórios ao acrescentar o Mailgun. Use p=none apenas na primeira política. Analise os relatórios de todos os remetentes legítimos antes de considerar quarentena. Rejeitar é uma decisão opcional e separada: listas e encaminhamentos podem quebrar a autenticação de mensagens legítimas, e cada receptor decide a entrega.

Problemas comuns

  • O domínio continua Unverified. O DNS pode levar de 24 a 48 horas. Confira o nome que o painel de DNS salvou. Se ele acrescenta o domínio automaticamente, digite só a parte anterior, como mg.
  • Chaves DKIM extras aparecem como Unverified. O Mailgun pode listar várias chaves, por exemplo depois de uma rotação ou quando chaves adicionadas manualmente continuam listadas depois de ativar o Automatic Sender Security. Só a chave exigida pela configuração do seu domínio precisa estar correta no DNS. Com o Automatic Sender Security, mantenha os dois registros CNAME do passo 2.
  • A chave DKIM de 2048 bits não salva. Alguns provedores de DNS exigem dividir o valor em duas partes. Use o verificador de DKIM com o seu seletor para confirmar a chave publicada.
  • Dois registros SPF no mesmo nome. Junte os dois em um só. Com dois registros, o SPF retorna permerror.
  • Excesso de consultas de SPF. O SPF permite 10 consultas DNS. Hoje o include:mailgun.org consome 5: mailgun.org, _spf.mailgun.org, _spf.eu.mailgun.org, _spf1.mailgun.org e _spf2.mailgun.org. Um subdomínio dedicado tira o Mailgun da contagem do SPF do domínio raiz.
  • MX do Mailgun em um nome que já recebe e-mail. Vários servidores MX podem atender um nome, mas trocar seus MX pelos do Mailgun pode redirecionar a entrega das caixas. Preserve os MX atuais ou use um subdomínio exclusivo livre.
  • O DMARC falha mesmo com SPF e DKIM aprovados. O domínio do From precisa compartilhar o domínio organizacional (o nome registrado, como exemplo.com.br) com o domínio que o Mailgun assina. Enviar de outro domínio por mg.exemplo.com.br não alinha, então adicione esse domínio ao Mailgun também. No alinhamento estrito (adkim=s e aspf=s), os domínios precisam ser idênticos. Uma mensagem enviada como @exemplo.com.br por mg.exemplo.com.br falha nas duas verificações, a menos que a assinatura DKIM use o domínio raiz.
  • As mensagens mostram “sent via Mailgun.org”. O domínio não está verificado. O Mailgun também limita domínios não verificados a 300 e-mails por dia.
  • O Outlook devolve uma mensagem cujo DKIM é aprovado em outros lugares. segundo o Mailgun, o DKIM pode passar no Gmail ou nos relatórios DMARC e ainda assim aparecer como reprovado na Microsoft. O erro diz 550 5.7.515 Access denied, sending domain DOMAIN.TLD doesn't meet the required authentication level. Em um post de junho de 2025, o Mailgun disse que a Microsoft pode aplicar um alinhamento mais rigoroso do que o DMARC exige e tratou isso como hipótese não confirmada. Se as devoluções continuarem, o Mailgun sugere perguntar ao suporte dele sobre assinar com o domínio raiz.
  • Domínio na UE com hosts dos EUA. Copie os valores de MX e de rastreamento que o painel mostra para a região escolhida.

Perguntas frequentes

O Mailgun configura o DMARC para mim?
Não. Os registros de verificação do Mailgun cobrem SPF, DKIM, rastreamento e MX. Você mesmo publica o DMARC, como um registro TXT chamado _dmarc no seu provedor de DNS.
Qual é o registro SPF do Mailgun?
No domínio que você cadastrou no Mailgun, o valor é v=spf1 include:mailgun.org ~all. Se esse nome já tiver um registro SPF, acrescente include:mailgun.org a ele em vez de criar um segundo registro.
Qual é o seletor DKIM do Mailgun?
Com o Automatic Sender Security, os seletores são pdk1 e pdk2. Com uma chave TXT, o seletor depende do seu domínio. Copie o nome do registro em Domain Verification & DNS no painel do Mailgun.
Preciso dos registros MX e de rastreamento do Mailgun para o DMARC?
O DMARC só lê SPF e DKIM. O manual do Mailgun ainda marca os registros MX e de rastreamento como obrigatórios para a verificação. Eles permitem que o Mailgun receba e-mails, veja bounces tardios e rastreie aberturas, cliques e descadastros. Se o nome já recebe e-mail em outro servidor, o FAQ do Mailgun orienta a não apontar os MX para o Mailgun.
Posso usar o domínio raiz no Mailgun?
Vários servidores MX podem atender um nome, mas trocar seus MX pelos do Mailgun pode redirecionar a entrega das caixas. Preserve os MX atuais ou use um subdomínio exclusivo livre.
Devo usar os valores dos EUA ou da UE no Mailgun?
Use os registros que o painel mostra para a região escolhida ao adicionar o domínio. Domínios na UE usam mxa.eu.mailgun.org e mxb.eu.mailgun.org nos MX e eu.mailgun.org no rastreamento.

Fontes consultadas

Mailgun: Adding a custom domain
consultada em 2026-11-09
Mailgun: DKIM Security
consultada em 2026-11-09
Mailgun: FAQ sobre SPF e MX
consultada em 2026-11-09
Mailgun: API Create a domain
consultada em 2026-11-09
Mailgun: API Update DKIM authority
consultada em 2026-11-09

Mantenha tudo saudável

Saiba na hora quando algo quebrar

Aponte seus relatórios DMARC para o DMARC Pulse e veja quem envia e-mail em nome do seu domínio, o que falha e por quê — com um alerta tranquilo quando algo mudar.

Plano grátis: 1 domínio, sem cartão de crédito.