Retour au tableau de bord

Mailgun : vérifier votre domaine d'envoi

À quoi sert ce guide

Mailgun envoie vos courriels depuis ses serveurs pour un domaine (ou sous-domaine) que vous déclarez. Mailgun exige deux enregistrements TXT, SPF et DKIM, pour vérifier que le domaine vous appartient et signer vos messages.

Enregistrements attendus

Mailgun recommande souvent un sous-domaine dédié, par exemple mg.exemple.com. Les enregistrements se placent alors sur ce sous-domaine.

Type Nom (hôte) Valeur
TXT (SPF) mg (ou votre domaine d'envoi) v=spf1 include:mailgun.org ~all
TXT (DKIM) <sélecteur>._domainkey.mg clé publique fournie par Mailgun (k=rsa; p=...)
TXT (DMARC) _dmarc (domaine racine) v=DMARC1; p=none; rua=mailto:[email protected]
  • Le sélecteur DKIM est attribué par Mailgun (par exemple pic) : utilisez seulement la valeur affichée pour votre domaine.
  • S'il existe déjà un SPF sur ce nom, n'en créez pas un second : ajoutez include:mailgun.org à l'enregistrement existant. Un seul SPF par nom d'hôte, 10 requêtes DNS au plus.
  • Mailgun propose des clés de 1024 ou 2048 bits. Certains hébergeurs n'acceptent pas 2048 bits, ou exigent de découper la valeur en chaînes de 255 caractères.
  • Mailgun peut aussi afficher des enregistrements facultatifs (MX pour recevoir, CNAME de suivi des liens). Ajoutez-les seulement si vous utilisez ces fonctions.

Étapes dans Mailgun

  1. Dans le panneau de contrôle Mailgun, ajoutez votre domaine d'envoi dans la section Sending > Domains et choisissez la taille de clé DKIM.
  2. Ouvrez Sending > Domain settings > DNS records pour afficher les enregistrements à créer.
  3. Créez les enregistrements TXT chez votre hébergeur DNS.
  4. Revenez dans DNS records et cliquez sur Check status. La vérification prend souvent de 5 à 30 minutes, parfois plus.

Vérifier la configuration

  1. Contrôlez les enregistrements : dig -t TXT mg.exemple.com (SPF) et dig -t TXT pic._domainkey.mg.exemple.com (DKIM, avec votre sélecteur). Testez avec un résolveur public et avec votre résolveur local.
  2. Dans Mailgun, le domaine doit être vérifié.
  3. Envoyez un courriel de test vers Gmail et vérifiez DKIM: PASS avec votre domaine.
  4. Relancez une analyse dans cet outil.

DMARC

Publiez un seul enregistrement TXT sur _dmarc.<votre domaine racine>, en commençant par la surveillance :

v=DMARC1; p=none; rua=mailto:[email protected]

Un sous-domaine comme mg.exemple.com est couvert par le DMARC du domaine racine. Lisez les rapports pendant quelques semaines, puis passez progressivement à p=quarantine et p=reject.

Documentation officielle

Mailgun : guide de configuration - SEKOIA