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
- Dans le panneau de contrôle Mailgun, ajoutez votre domaine d'envoi dans la section Sending > Domains et choisissez la taille de clé DKIM.
- Ouvrez Sending > Domain settings > DNS records pour afficher les enregistrements à créer.
- Créez les enregistrements TXT chez votre hébergeur DNS.
- Revenez dans DNS records et cliquez sur Check status. La vérification prend souvent de 5 à 30 minutes, parfois plus.
Vérifier la configuration
- Contrôlez les enregistrements :
dig -t TXT mg.exemple.com(SPF) etdig -t TXT pic._domainkey.mg.exemple.com(DKIM, avec votre sélecteur). Testez avec un résolveur public et avec votre résolveur local. - Dans Mailgun, le domaine doit être vérifié.
- Envoyez un courriel de test vers Gmail et vérifiez
DKIM: PASSavec votre domaine. - 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.