Configuration DNS

Après avoir ajouté un domaine, configurez les enregistrements DNS requis pour l'authentification des e-mails. MailLand requiert des enregistrements SPF, DKIM et DMARC ; les trois doivent être vérifiés avant de pouvoir envoyer. L'enregistrement Return-Path (rebond) personnalisé fait partie de la vérification du domaine et est activé par défaut pour les nouveaux domaines ; il ne bloque pas l'envoi, et tant qu'il n'est pas vérifié MailLand utilise son Return-Path par défaut. Un domaine de tracking est facultatif.

Obtenir les instructions DNS

Récupérez les enregistrements exacts pour votre domaine :

GET https://api.mail.land/v1/domains/{id}/dns-instructions

Authentifiez-vous avec Authorization: Bearer <token> ou X-API-Key: <api key>.

Get DNS instructions

curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/dns-instructions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

DNS instructions response

{
  "domain": "yourdomain.com",
  "spfRecord": {
    "recordType": "TXT",
    "hostName": "@",
    "value": "v=spf1 include:spf.mlnd.net ~all",
    "status": "pending",
    "instructions": "Add this TXT record to your domain's root. If you have an existing SPF record, add 'include:spf.mlnd.net' to it instead of creating a new record."
  },
  "dkimRecord": {
    "recordType": "TXT",
    "hostName": "mlnd._domainkey",
    "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "status": "pending",
    "instructions": "Add this TXT record with hostname 'mlnd._domainkey' to enable DKIM signing."
  },
  "dmarcRecord": {
    "recordType": "TXT",
    "hostName": "_dmarc",
    "value": "v=DMARC1; p=quarantine; pct=100; adkim=r; aspf=r; rua=mailto:[email protected]; sp=none",
    "status": "pending",
    "instructions": "Add this TXT record at the '_dmarc' subdomain to enable DMARC policy. The rua tag sends aggregate reports to a MailLand address. MailLand stores the reports for this domain for your plan's retention period and makes their DMARC pass rate, sending sources and dispositions available through the API (GET /v1/domains/{id}/dmarc/summary and /dmarc/sources). To also receive the reports yourself, add your own address to the rua tag."
  },
  "trackingRecord": {
    "recordType": "CNAME",
    "hostName": "track",
    "value": "track.mlnd.net",
    "status": "pending",
    "instructions": "Custom Tracking Links"
  },
  "bounceRecords": [
    {
      "recordType": "CNAME",
      "hostName": "bounce",
      "value": "bounce.mlnd.net",
      "status": "pending",
      "instructions": "Bounce Domain (Return-Path) DNS-only (not proxied): a proxied record hides the CNAME from mail servers."
    }
  ],
  "notes": [
    "DNS changes can take up to 48 hours to propagate globally.",
    "After adding records, click 'Verify Domain' to check the configuration.",
    "All three records (SPF, DKIM, DMARC) must be verified to start sending emails.",
    "Use your DNS provider's documentation for specific instructions on adding TXT records."
  ]
}

Chaque enregistrement inclut un champ status indiquant s'il a été détecté dans le DNS :

Statut	Description
`pending`	Pas encore vérifié
`valid`	Enregistrement trouvé et correct
`invalid`	Enregistrement absent ou incorrect

trackingRecord n'est renvoyé que si le domaine de suivi personnalisé est activé, et bounceRecords que si le domaine de rebond personnalisé l'est.

Les enregistrements de tracking et de rebond affichent pending jusqu'à leur vérification, même après un échec de contrôle.

Enregistrements requis

SPF (Sender Policy Framework)

SPF autorise les serveurs de MailLand à envoyer des e-mails au nom de votre domaine.

Champ	Valeur
Type	TXT
Nom	`yourdomain.com` (ou `@`)
Valeur	`v=spf1 include:spf.mlnd.net ~all`
TTL	3600

Si vous avez déjà un enregistrement SPF, ajoutez include:spf.mlnd.net avant le mécanisme ~all ou -all. SPF n'autorise qu'un seul enregistrement TXT par domaine : plusieurs enregistrements SPF provoquent des échecs d'authentification.

Exemple SPF existant :

# Before
v=spf1 include:_spf.google.com ~all

# After
v=spf1 include:_spf.google.com include:spf.mlnd.net ~all

DKIM (DomainKeys Identified Mail)

DKIM ajoute une signature cryptographique à chaque e-mail, permettant aux destinataires de vérifier que le message n'a pas été altéré en transit.

Champ	Valeur
Type	TXT
Nom	`mlnd._domainkey.yourdomain.com`
Valeur	`v=DKIM1; k=rsa; p=MIIBIjANBgkq...` (votre clé publique)
TTL	3600

MailLand génère une paire de clés RSA 2048 bits lors de l'ajout d'un domaine. Le sélecteur par défaut est mlnd. La valeur complète de la clé publique est fournie dans la réponse des instructions DNS.

Les clés publiques DKIM sont longues (environ 400 caractères). Certains fournisseurs DNS divisent les enregistrements TXT en morceaux de 255 caractères. La plupart des fournisseurs gèrent cela automatiquement : si le vôtre ne le fait pas, entourez la valeur de guillemets doubles et le fournisseur devrait la concaténer.

DMARC (obligatoire)

DMARC indique aux serveurs de messagerie destinataires ce qu'il faut faire lorsque les vérifications SPF ou DKIM échouent. DMARC est obligatoire : la vérification échoue sans un enregistrement _dmarc qui commence par v=DMARC1 et contient p=.

Champ	Valeur
Type	TXT
Nom	`_dmarc.yourdomain.com`
Valeur	Utilisez la valeur exacte de la réponse `dns-instructions` ci-dessus (elle inclut une adresse de rapport unique par domaine)
TTL	3600

Options de politique DMARC :

Politique	Comportement
`p=none`	Surveillance uniquement : aucune action en cas d'échec (idéal pour la configuration initiale)
`p=quarantine`	Envoyer les échecs dans le dossier spam (point de départ recommandé)
`p=reject`	Bloquer complètement les échecs (le plus strict, meilleure protection)

Mail.Land traite les rapports agrégés DMARC de votre domaine. Publiez la valeur de la réponse dns-instructions telle quelle. Son adresse rua (dmarc+<id>@rpt.mail.land) est le récepteur de rapports de Mail.Land. Les rapports de ce domaine ou de l’un de ses sous-domaines sont conservés pendant la durée de conservation de votre plan, et leur taux de réussite DMARC, leurs sources d’envoi et les dispositions appliquées sont disponibles via l’API : GET /v1/domains/{id}/dmarc/summary et GET /v1/domains/{id}/dmarc/sources. Il n’existe pas encore de page du tableau de bord pour eux. Pour recevoir aussi les rapports vous-même, ajoutez votre propre adresse à la même balise : rua=mailto:dmarc+<id>@rpt.mail.land,mailto:[email protected].

Enregistrements optionnels

Chemin de retour personnalisé (domaine de rebond)

Le domaine de rebond personnalisé fait partie de la vérification du domaine et est activé par défaut pour chaque nouveau domaine : MailLand envoie vos e-mails avec un Return-Path (l'adresse « mailed-by ») sur votre propre sous-domaine, afin que SPF soit aligné avec votre domaine. Ajoutez un enregistrement CNAME :

Champ	Valeur
Type	CNAME
Nom	`bounce.yourdomain.com`
Valeur	`bounce.mlnd.net`
TTL	3600

Les serveurs de messagerie suivent ce CNAME jusqu'au serveur de messagerie et à l'enregistrement SPF de MailLand : n'ajoutez donc pas d'enregistrement MX ou TXT sur ce nom.

L'enregistrement doit être en mode DNS uniquement (sans proxy). Un enregistrement proxifié, comme le nuage orange de Cloudflare, masque le CNAME aux serveurs de messagerie et la vérification échoue. N'utilisez pas d'enregistrement MX pointant vers bounce.mlnd.net : cet hôte n'accepte pas de courrier.

MailLand revérifie régulièrement cet enregistrement. S'il est supprimé ou modifié, le domaine de rebond personnalisé n'est plus vérifié, vous recevez une notification et vos e-mails utilisent le Return-Path par défaut de MailLand jusqu'à ce que vous vérifiiez à nouveau l'enregistrement. Désactiver puis réactiver le paramètre exige aussi une nouvelle vérification.

Vous pouvez désactiver le domaine de rebond personnalisé dans les paramètres du domaine, mais seulement après avoir confirmé un avertissement : le domaine envoie alors sous l'enveloppe de rebond partagée de MailLand, SPF n'est pas aligné avec votre domaine et la réputation de l'enveloppe est partagée avec d'autres expéditeurs. Les domaines pour lesquels il est désactivé sont signalés aux opérateurs de MailLand. Les domaines créés avant que cette option devienne active par défaut conservent leur réglage ; activez-la dans les paramètres du domaine pour obtenir l'enregistrement.

CNAME de tracking

Si vous utilisez un sous-domaine de tracking personnalisé, ajoutez un CNAME :

Champ	Valeur
Type	CNAME
Nom	`track.yourdomain.com`
Valeur	`track.mlnd.net`
TTL	3600

L'enregistrement doit être en mode DNS uniquement (sans proxy). Un enregistrement proxifié, comme le nuage orange de Cloudflare, répond avec un autre certificat, et les liens suivis ainsi que le lien de désinscription ne fonctionnent plus. Une fois le CNAME vérifié, MailLand demande le certificat et vérifie le HTTPS sur cet hôte. Les liens continuent d'utiliser l'hôte de suivi par défaut de MailLand tant que cette vérification n'a pas réussi. Si elle échoue durablement, vous êtes averti. Le CNAME est revérifié toutes les heures. Via l'API, envoyez useCustomBounce: false avec acknowledgeSharedBounceRisk: true ; sans cela, la requête est refusée avec BOUNCE_OPT_OUT_NOT_ACKNOWLEDGED.

MX entrant

Si vous utilisez le traitement des e-mails entrants :

Champ	Valeur
Type	MX
Nom	la racine (`@`) par défaut, ou votre `inboundSubdomain` (par exemple `in`) si vous en avez défini un dans les paramètres du domaine. Un sous-domaine conserve votre fournisseur de messagerie actuel sur la racine ; le courrier est accepté à la fois sur le sous-domaine et sur la racine.
Valeur	`mx.mlnd.net`
Priorité	10
TTL	3600

Guides par fournisseur DNS

Connectez-vous au tableau de bord Cloudflare
Sélectionnez votre domaine
Allez dans DNS → Records
Cliquez sur Add Record pour chaque enregistrement
Pour les enregistrements TXT, définissez le statut proxy sur DNS only (nuage gris)
Pour les enregistrements CNAME, définissez le statut proxy sur DNS only : les CNAME proxifiés peuvent interférer avec l'authentification des e-mails

Vérifier les enregistrements DNS

Après avoir ajouté les enregistrements, vérifiez qu'ils ont été propagés :

GET https://api.mail.land/v1/domains/{id}/dns-records

Check DNS records

curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/dns-records \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

DNS records response

{
  "domain": "yourdomain.com",
  "spfRecord": {
    "recordType": "TXT",
    "hostName": "@",
    "value": "v=spf1 include:spf.mlnd.net ~all",
    "status": "valid",
    "instructions": "Add this TXT record to your domain's root. If you have an existing SPF record, add 'include:spf.mlnd.net' to it instead of creating a new record."
  },
  "dkimRecord": {
    "recordType": "TXT",
    "hostName": "mlnd._domainkey",
    "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "status": "valid",
    "instructions": "Add this TXT record with hostname 'mlnd._domainkey' to enable DKIM signing."
  },
  "dmarcRecord": {
    "recordType": "TXT",
    "hostName": "_dmarc",
    "value": "v=DMARC1; p=quarantine; pct=100; adkim=r; aspf=r; rua=mailto:[email protected]; sp=none",
    "status": "valid",
    "instructions": "Add this TXT record at the '_dmarc' subdomain to enable DMARC policy. The rua tag sends aggregate reports to a MailLand address. MailLand stores the reports for this domain for your plan's retention period and makes their DMARC pass rate, sending sources and dispositions available through the API (GET /v1/domains/{id}/dmarc/summary and /dmarc/sources). To also receive the reports yourself, add your own address to the rua tag."
  },
  "trackingRecord": {
    "recordType": "CNAME",
    "hostName": "track",
    "value": "track.mlnd.net",
    "status": "valid",
    "instructions": "Custom Tracking Links"
  },
  "bounceRecords": [
    {
      "recordType": "CNAME",
      "hostName": "bounce",
      "value": "bounce.mlnd.net",
      "status": "valid",
      "instructions": "Bounce Domain (Return-Path) DNS-only (not proxied): a proxied record hides the CNAME from mail servers."
    }
  ],
  "notes": [
    "DNS changes can take up to 48 hours to propagate globally.",
    "After adding records, click 'Verify Domain' to check the configuration.",
    "All three records (SPF, DKIM, DMARC) must be verified to start sending emails.",
    "Use your DNS provider's documentation for specific instructions on adding TXT records."
  ]
}

La propagation DNS peut prendre de quelques minutes à 48 heures, selon votre fournisseur DNS et le TTL des enregistrements existants. La plupart des fournisseurs propagent en 5 à 15 minutes.

Étapes suivantes

Vérification : vérifier la propriété du domaine après la configuration DNS
Rotation des clés DKIM : gérer et faire pivoter les clés DKIM
Clés API : limiter les identifiants à des domaines spécifiques

Configuration DNS

Obtenir les instructions DNSCopier le lien de la section

Enregistrements requisCopier le lien de la section

SPF (Sender Policy Framework)Copier le lien de la section

DKIM (DomainKeys Identified Mail)Copier le lien de la section

DMARC (obligatoire)Copier le lien de la section

Enregistrements optionnelsCopier le lien de la section

Chemin de retour personnalisé (domaine de rebond)Copier le lien de la section

CNAME de trackingCopier le lien de la section

MX entrantCopier le lien de la section

Guides par fournisseur DNSCopier le lien de la section

Vérifier les enregistrements DNSCopier le lien de la section

Étapes suivantesCopier le lien de la section

Sur cette page