Enregistrement TXT : rôle, syntaxe et usages

À quoi sert un TXT

Le format est défini par la RFC 1035, qui le décrit comme du texte libre dont le sens dépend de celui qui le lit. En pratique, quatre usages reviennent sans cesse :

Usage	Où il se pose	Ce qu'il commence par
SPF : serveurs autorisés à envoyer vos courriels	le domaine lui-même	`v=spf1`
DKIM : clé publique de signature des courriels	un sous-domaine du type `selecteur._domainkey`	`v=DKIM1`
DMARC : règle appliquée aux courriels non authentifiés	`_dmarc`	`v=DMARC1`
Vérification de propriété	le domaine, ou un nom indiqué par le service	une valeur fournie par le service

Pour la Search Console, Google donne une valeur google-site-verification=… à publier, et demande de ne pas la supprimer une fois la vérification faite : elle est relue de temps en temps. Les trois enregistrements de messagerie ont chacun leur article : SPF, DKIM et DMARC.

La syntaxe

Dans l'interface d'un gestionnaire de zone, un TXT se résume à trois champs :

Nom (ou hôte, ou sous-domaine) : vide, ou @, pour le domaine lui-même ; _dmarc pour DMARC ; le nom donné par le service dans les autres cas.
Type : TXT.
Valeur : le texte, tel que le service vous l'a donné.

Un même nom peut porter plusieurs TXT : un SPF et une vérification Google cohabitent sans difficulté sur le domaine. La seule règle stricte concerne SPF : la RFC 7208 interdit d'en publier deux pour le même domaine. Si votre zone en contient déjà un, on ajoute le nouveau serveur à la ligne existante au lieu d'en créer une seconde.

La limite de 255 caractères

Une chaîne de texte DNS compte au plus 255 caractères. Une clé DKIM de 2 048 bits dépasse cette longueur. Le texte se découpe alors en plusieurs chaînes entre guillemets, sur le même enregistrement :

"v=DKIM1; k=rsa; p=MIIBIjANBgkqhki…" "…suite de la clé…"

D'après la RFC 7208, ces morceaux se recollent sans espace. Si une espace est nécessaire, elle doit figurer à la fin d'un morceau ou au début du suivant. La plupart des interfaces récentes font ce découpage seules quand vous collez une valeur longue : collez la valeur d'un seul tenant, puis vérifiez le résultat.

Ajouter un TXT, étape par étape

Repérez qui gère votre zone DNS. C'est le fournisseur dont les serveurs de noms sont déclarés pour le domaine : bureau d'enregistrement, Cloudflare ou autre. L'article Serveur DNS montre comment le savoir.
Ouvrez la zone dans son interface et choisissez d'ajouter un enregistrement.
Choisissez le type TXT, renseignez le nom et collez la valeur sans la retaper : un caractère oublié suffit à la rendre fausse.
Enregistrez, puis attendez la prise en compte, qui dépend de la durée de vie des enregistrements : voir Le TTL d'un enregistrement DNS.
Vérifiez que la valeur publiée est bien celle attendue, avec la commande ci-dessous.

Vérifier un TXT

Sous macOS ou Linux, la commande dig affiche les TXT publiés :

dig TXT exemple.fr +short
dig TXT _dmarc.exemple.fr +short

Sous Windows, nslookup fait la même chose : nslookup -type=TXT exemple.fr. Le type d'enregistrement demandé se règle comme l'explique la documentation de Microsoft. Si la réponse est vide, l'enregistrement n'est pas encore visible, ou il a été posé sous un autre nom : comparez le champ Nom avec ce que le service demandait.

Les erreurs courantes

Le nom du domaine répété. Certaines interfaces ajoutent le domaine d'elles-mêmes : saisir _dmarc.exemple.fr donne alors _dmarc.exemple.fr.exemple.fr. Saisissez seulement _dmarc.
Deux SPF. Ils mettent tout le SPF du domaine en erreur, d'après la RFC 7208 : fusionnez-les en une seule ligne.
Des guillemets en trop. Certaines interfaces ajoutent les guillemets elles-mêmes : des guillemets saisis à la main se retrouvent alors dans la valeur publiée.
Un TXT de vérification supprimé après coup, qui fait perdre l'accès au service quelques semaines plus tard.

Chez Hubspace

Nos serveurs d'hébergement ne servent aucune zone DNS publique. Pour un domaine enregistré chez nous, la zone est servie par défaut par les serveurs de notre bureau d'enregistrement partenaire, Netim : vous modifiez vos enregistrements vous-même, ou nous les posons pour vous sur simple demande, comme l'indique la page nom de domaine. Pour un domaine géré ailleurs, le TXT s'ajoute chez ce gestionnaire. Les valeurs à publier pour notre messagerie sont dans Enregistrement SPF et DKIM.

Questions fréquentes

Combien d'enregistrements TXT peut-on avoir sur un domaine ?

Plusieurs, sans limite pratique pour un usage normal. Seul SPF n'en admet qu'un par nom : les autres TXT, vérifications ou DMARC, s'ajoutent à côté sans gêne.

Un enregistrement TXT a-t-il un effet sur mon site ?

Non. Un TXT ne change pas l'adresse vers laquelle pointe le domaine. Le site dépend des enregistrements A, AAAA ou CNAME, décrits dans Les enregistrements DNS.

Faut-il des guillemets autour de la valeur ?

Cela dépend de l'interface. La plupart les ajoutent seules et les affichent dans la valeur publiée. Si la vérification avec dig montre des guillemets doublés, retirez ceux que vous avez saisis.