Comment ajouter un enregistrement TXT au DNS

C'est une demande très courante

Un fournisseur externe vous a demandé d'ajouter un enregistrement TXT au DNS de votre domaine.

Il peut s'agir de Google, Microsoft, d'un outil d'envoi d'e-mails, d'un service de facturation, d'une plateforme marketing ou de toute application qui doit vérifier que vous contrôlez réellement le domaine.

La demande paraît souvent simple: copier un long texte et le coller dans le DNS.

Mais une petite erreur dans le nom, la valeur ou l'endroit où l'enregistrement est ajouté peut empêcher la vérification de fonctionner. Et si un enregistrement existant est modifié sans être compris, des services importants peuvent être affectés, en particulier l'e-mail.

Réponse rapide

Un enregistrement TXT permet de publier une donnée texte dans le DNS du domaine.

Avant de l'ajouter, vous devez connaître trois informations:

• le nom ou l'hôte de l'enregistrement;
• la valeur exacte à publier;
• s'il doit être ajouté au domaine principal ou à un sous-domaine.

La valeur doit être copiée sans modification. Si le service indique un long texte, un jeton ou une chaîne avec des caractères inhabituels, il ne faut ni la résumer ni la corriger.

Pourquoi les services demandent-ils des enregistrements TXT?

Un enregistrement TXT n'affiche pas de page web et ne crée pas de boîte e-mail.

Il sert à publier une information technique associée au domaine. D'autres services peuvent interroger le DNS et vérifier que cette information existe.

Les usages les plus courants sont:

• vérifier que vous contrôlez le domaine;
• configurer ou autoriser l'envoi d'e-mails;
• publier un enregistrement SPF;
• publier une politique DMARC;
• ajouter des vérifications pour des services externes;
• publier des clés ou des jetons de sécurité.

Tous les enregistrements TXT ne sont pas identiques. Un enregistrement de vérification Google, un SPF et un DMARC ont des fonctions différentes, même s'ils sont tous de type TXT.

Informations nécessaires

Avant de modifier le DNS, rassemblez ces informations:

• nom ou hôte de l'enregistrement;
• valeur complète du TXT;
• TTL recommandé, si le fournisseur l'indique;
• service qui demande l'enregistrement;
• domaine ou sous-domaine exact où il doit être ajouté;
• objectif de l'enregistrement, par exemple vérification, SPF ou DMARC.

Si le service vous donne seulement une valeur mais n'indique pas clairement le nom de l'enregistrement, il vaut mieux consulter la documentation avant d'ajouter quoi que ce soit.

Étapes générales

1. Ouvrez la gestion DNS du domaine.
2. Ouvrez la zone du bon domaine.
3. Vérifiez si un enregistrement lié existe déjà.
4. Ajoutez un enregistrement de type TXT.
5. Saisissez le nom exact indiqué par le service.
6. Collez la valeur sans la modifier.
7. Vérifiez qu'aucun espace n'a été ajouté au début ou à la fin.
8. Enregistrez les modifications.
9. Attendez que le DNS soit publié et vérifiez le résultat.

Les modifications DNS ne sont pas toujours visibles immédiatement partout. Le délai réel dépend du TTL et du cache des résolveurs.

Comment ajouter un enregistrement TXT dans PRIMARI.NET

Si vous gérez le DNS de votre domaine avec PRIMARI.NET, vous pouvez créer l'enregistrement TXT directement depuis le panneau de contrôle.

1. Ouvrez DNS primaire

Connectez-vous à votre compte PRIMARI.NET et sélectionnez DNS primaire dans le menu principal.

Sur cet écran, vous avez deux possibilités:

• Si le domaine ne dispose pas encore du service DNS primaire, saisissez le nom du domaine dans le champ correspondant et cliquez sur Souscrire DNS primaire.
• Si le domaine dispose déjà du service, vous le trouverez dans la section Gérez vos domaines. Cliquez sur Modifier à côté du domaine que vous souhaitez modifier.

2. Ouvrez la configuration DNS du domaine

Lorsque vous sélectionnez Modifier, vous verrez tous les enregistrements DNS actuellement configurés pour le domaine.

En bas du tableau, vous trouverez l'option Ajouter un nouvel enregistrement.

Cliquez sur Ajouter.

3. Créez l'enregistrement TXT

Sur l'écran de création des enregistrements:

1. Saisissez le nom de l'hôte ou de la zone indiqué par le service qui demande l'enregistrement.
2. Sélectionnez le type TXT.
3. Copiez exactement la valeur fournie dans le champ Texte.
4. Cliquez sur ENREGISTRER.

Par exemple, un service de vérification pourrait vous demander de créer un hôte comme _acme-challenge avec une chaîne de vérification déterminée.

N'inventez pas et ne modifiez pas cette valeur: copiez-la exactement telle qu'elle vous a été fournie par le service.

4. Activez les changements

Après avoir enregistré l'enregistrement, vous reviendrez à la configuration du domaine.

Le nouvel enregistrement n'est pas encore publié sur Internet.

PRIMARI.NET vous indiquera qu'il y a des changements en attente d'activation.

Cliquez sur Activer les changements.

À partir de ce moment, PRIMARI.NET publiera la nouvelle configuration sur les serveurs DNS.

Guide visuel

Erreurs fréquentes

Les erreurs les plus fréquentes sont:

• ajouter la valeur au domaine principal alors que le service demandait un sous-domaine;
• saisir deux fois le nom de l'enregistrement parce que le panneau ajoute déjà le domaine automatiquement;
• modifier ou supprimer un enregistrement TXT existant sans savoir à quoi il sert;
• créer deux enregistrements SPF séparés pour le même domaine;
• copier une valeur incomplète;
• modifier les guillemets, espaces ou signes de la valeur originale;
• s'attendre à ce que la vérification fonctionne immédiatement alors que le DNS n'est pas encore à jour.

Précautions

Ne remplacez pas un enregistrement existant sans comprendre pourquoi il existe.

Certains types de configuration, comme SPF, nécessitent généralement un seul enregistrement par domaine. Si un SPF existe déjà, il ne faut normalement pas créer un second SPF séparé, mais combiner correctement les valeurs.

Il faut aussi être prudent avec les enregistrements liés à l'e-mail. Un changement qui paraît mineur peut amener d'autres serveurs à se méfier des messages du domaine ou faire échouer une vérification.

Comment vérifier si c'est correct?

Le premier indicateur est le service qui a demandé l'enregistrement. Il propose généralement un bouton de vérification ou indique si le domaine est déjà validé.

Si la vérification échoue juste après l'enregistrement du changement, cela ne signifie pas toujours que le registre est incorrect. Le DNS n'est peut-être pas encore propagé.

Si l'échec persiste après un délai d'attente, il faut vérifier le nom de l'enregistrement, la valeur exacte et si l'enregistrement a été ajouté dans la bonne zone DNS.

Quand contacter PRIMARI.NET

Contactez PRIMARI.NET si le service vous donne une valeur longue, si un enregistrement SPF existe déjà, si vous avez un doute sur le nom de l'enregistrement ou si la vérification échoue encore après avoir attendu.

Nous pouvons vérifier la zone DNS, contrôler si l'enregistrement a été ajouté au bon endroit et vous aider à éviter des changements susceptibles d'affecter l'e-mail, le site web ou d'autres services du domaine.