Configurer les rapports DMARC

Ce guide explique comment commencer à collecter des rapports DMARC pour un domaine d’envoi. Vous activez les rapports, ajoutez l’adresse de rapport d’Emailit à votre enregistrement DMARC et attendez les premiers rapports. Vous pouvez aussi importer des rapports manuellement.

Avant de commencer

• Votre espace de travail est sur le forfait Pro, Business ou Custom.
• Le domaine est ajouté dans Email API›Domains.
• Vous pouvez modifier les enregistrements DNS du domaine.

Activer les rapports

curl https://api.emailit.com/v2/domains/acme.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dmarc_reports": true }'

L’adresse de rapport appartient à ce domaine et ne change pas. Si vous désactivez puis réactivez les rapports, vous obtenez la même adresse. Tant que les rapports sont désactivés, Emailit ignore les rapports qui y sont envoyés.

Publier l’enregistrement DMARC

DMARC tient dans un seul enregistrement TXT, sur _dmarc.<domain>. La marche à suivre dépend de l’existence de cet enregistrement. Vérifiez avec :

dig +short TXT _dmarc.acme.com @1.1.1.1

Si vous n’avez pas d’enregistrement DMARC

Créez un enregistrement TXT sur _dmarc avec la valeur Suggested _dmarc TXT :

_dmarc.acme.com.   TXT   "v=DMARC1; p=none; rua=mailto:k7f2m9qx4tz1@dmarc.emailitmail.com; ruf=mailto:k7f2m9qx4tz1@dmarc.emailitmail.com;"

p=none se contente de demander des rapports. Cela ne change pas la livraison de vos e-mails.

Si vous avez déjà un enregistrement DMARC

Ne créez pas de second enregistrement. Les serveurs destinataires ignorent DMARC quand un domaine en a deux. Ajoutez plutôt l’adresse d’Emailit aux balises rua et ruf existantes, séparée par des virgules, et conservez votre politique actuelle.

Omettez la partie ruf si vous ne voulez pas de rapports forensiques, qui peuvent contenir des données personnelles.

Si vous envoyez depuis un sous-domaine

Si votre domaine d’envoi est mail.acme.com mais que votre enregistrement DMARC se trouve sur acme.com, vous pouvez ajouter l’adresse à l’enregistrement _dmarc.acme.com. Emailit accepte les rapports concernant le domaine d’envoi, ses sous-domaines et son domaine parent. Les rapports concernant d’autres domaines sont rejetés.

Attendre les premiers rapports

Les fournisseurs de messagerie envoient des rapports agrégés environ une fois par jour, couvrant la veille. Les premiers arrivent généralement dans les 24 à 48 heures suivant la publication de l’enregistrement, si vous avez envoyé des e-mails à ces fournisseurs pendant cette période.

Les rapports apparaissent dans Email API›DMARC reports, dans l’onglet Reports du domaine, et l’onglet Overview se remplit à mesure qu’ils arrivent.

Importer un rapport manuellement

Si vous avez déjà des rapports, par exemple issus d’un autre outil DMARC ou d’une boîte aux lettres où ils arrivaient auparavant, importez-les.

curl https://api.emailit.com/v2/domains/acme.com/dmarc/reports \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"filename\": \"google.com!acme.com!1759190400!1759276799.xml.gz\",
    \"content_base64\": \"$(base64 < report.xml.gz | tr -d '\n')\"
  }"

L’import fonctionne même quand l’interrupteur Reports est désactivé. Emailit détecte les doublons : importer deux fois le même rapport ne double pas vos chiffres. Un rapport concernant un autre domaine échoue avec « Reported domain … does not match … ».

Dépannage

Voir aussi