Qu'est-ce qu'un enregistrement TXT
Découvrez ce que sont les enregistrements TXT et comment ils sont utilisés pour la vérification de domaine, SPF, DKIM et DMARC. Inclut des exemples pour le tableau de bord et l'API DNScale.
Un enregistrement TXT (Text) stocke des données textuelles arbitraires dans le DNS. Bien qu'initialement conçu pour des notes lisibles par l'humain, les enregistrements TXT sont désormais essentiels pour la vérification de domaine, l'authentification des e-mails (SPF, DKIM, DMARC) et divers protocoles de sécurité.
Comment fonctionnent les enregistrements TXT
Les enregistrements TXT contiennent du texte libre, généralement entre guillemets :
example.com. 3600 TXT "v=spf1 include:_spf.google.com ~all"Plusieurs enregistrements TXT peuvent exister pour le même nom, et un seul enregistrement TXT peut contenir plusieurs chaînes qui sont concaténées.
Cas d'utilisation courants
Vérification de domaine
Prouver la propriété du domaine auprès de services tiers :
# Google Search Console
example.com. 3600 TXT "google-site-verification=abc123..."
# Microsoft 365
example.com. 3600 TXT "MS=ms12345678"
# Let's Encrypt (challenge DNS-01)
_acme-challenge.example.com. 300 TXT "gfj9Xq...token..."SPF (Sender Policy Framework)
Spécifier quels serveurs sont autorisés à envoyer des e-mails pour votre domaine :
# Autoriser Google Workspace à envoyer
example.com. 3600 TXT "v=spf1 include:_spf.google.com ~all"
# Autoriser votre propre serveur de messagerie
example.com. 3600 TXT "v=spf1 mx a:mail.example.com -all"
# Plusieurs inclusions
example.com. 3600 TXT "v=spf1 include:_spf.google.com include:sendgrid.net ~all"DKIM (DomainKeys Identified Mail)
Publier les clés publiques pour la signature des e-mails :
google._domainkey.example.com. 3600 TXT "v=DKIM1; k=rsa; p=MIGfMA0GCS..."
selector1._domainkey.example.com. 3600 TXT "v=DKIM1; k=rsa; p=MIIBIjANBg..."DMARC (Domain-based Message Authentication)
Définir la politique pour les e-mails qui échouent aux vérifications SPF/DKIM :
_dmarc.example.com. 3600 TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com"
# Politique stricte
_dmarc.example.com. 3600 TXT "v=DMARC1; p=reject; pct=100; rua=mailto:dmarc@example.com"Politiques de sécurité
BIMI (Brand Indicators for Message Identification) :
default._bimi.example.com. 3600 TXT "v=BIMI1; l=https://example.com/logo.svg"MTA-STS (Mail Transfer Agent Strict Transport Security) :
_mta-sts.example.com. 3600 TXT "v=STSv1; id=20231107"Données d'application personnalisées
Stocker toute donnée textuelle nécessaire à vos applications :
example.com. 3600 TXT "facebook-domain-verification=abc123"
example.com. 3600 TXT "stripe-verification=xyz789"Format de l'enregistrement
| Champ | Description | Exemple |
|---|---|---|
| Nom | Domaine ou sous-domaine | @, _dmarc, selector._domainkey |
| Type | Type d'enregistrement | TXT |
| Contenu | Valeur textuelle (entre guillemets) | "v=spf1 mx -all" |
| TTL | Durée de vie (secondes) | 3600 |
Enregistrements TXT longs
Les enregistrements TXT de plus de 255 caractères doivent être divisés en plusieurs chaînes :
example.com. 3600 TXT "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A" "MIIBCgKCAQEA..."DNScale gère cela automatiquement lorsque vous saisissez de longues valeurs.
Ajouter un enregistrement TXT
Via le tableau de bord
- Accédez à votre zone dans le tableau de bord DNScale
- Cliquez sur Add Record
- Configurez l'enregistrement :
- Name : Saisissez le sous-domaine ou
@pour l'apex - Type : Sélectionnez
TXT - Value : Saisissez le contenu textuel (guillemets facultatifs)
- TTL : Définissez la durée de cache (par défaut : 3600)
- Name : Saisissez le sous-domaine ou
- Cliquez sur Create Record
Via l'API
Créer un enregistrement SPF :
curl -X POST "https://api.dnscale.eu/v1/zones/{zone_id}/records" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "@",
"type": "TXT",
"content": "v=spf1 include:_spf.google.com ~all",
"ttl": 3600
}'Créer un enregistrement DMARC :
curl -X POST "https://api.dnscale.eu/v1/zones/{zone_id}/records" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "_dmarc",
"type": "TXT",
"content": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com",
"ttl": 3600
}'Créer un enregistrement de vérification de domaine :
curl -X POST "https://api.dnscale.eu/v1/zones/{zone_id}/records" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "@",
"type": "TXT",
"content": "google-site-verification=abc123xyz...",
"ttl": 3600
}'Réponse de l'API :
{
"status": "success",
"data": {
"message": "Record created successfully",
"record": {
"id": "encoded-record-id",
"name": "example.com.",
"type": "TXT",
"content": "\"v=spf1 include:_spf.google.com ~all\"",
"ttl": 3600,
"disabled": false
}
}
}Guide de configuration de l'authentification e-mail
Configuration complète de l'authentification des e-mails avec SPF, DKIM et DMARC :
Étape 1 : Ajouter l'enregistrement SPF
example.com. 3600 TXT "v=spf1 include:_spf.google.com ~all"Étape 2 : Ajouter l'enregistrement DKIM
google._domainkey.example.com. 3600 TXT "v=DKIM1; k=rsa; p=..."Étape 3 : Ajouter l'enregistrement DMARC
_dmarc.example.com. 3600 TXT "v=DMARC1; p=none; rua=mailto:dmarc@example.com"Étape 4 : Surveiller et renforcer
- Commencez avec
p=nonepour surveiller - Passez à
p=quarantineaprès avoir examiné les rapports - Utilisez enfin
p=rejectpour une protection complète
Bonnes pratiques
-
Un seul enregistrement SPF - Plusieurs enregistrements SPF causent des problèmes de livraison ; combinez-les en un seul
-
Progression DMARC appropriée - Commencez par
p=none, puisp=quarantine, puisp=reject -
Conservez les enregistrements de vérification - Ne supprimez pas les enregistrements TXT de vérification après la configuration initiale
-
Mettez les caractères spéciaux entre guillemets - Assurez-vous d'utiliser des guillemets autour des valeurs contenant des espaces ou des caractères spéciaux
-
TTL court pour les challenges - Utilisez un TTL court (300s) pour les challenges ACME/Let's Encrypt
Tester les enregistrements TXT
Vérifiez vos enregistrements TXT avec dig :
# Vérifier tous les enregistrements TXT
dig TXT example.com
# Vérifier SPF spécifiquement
dig TXT example.com +short
# Vérifier DMARC
dig TXT _dmarc.example.com
# Vérifier DKIM
dig TXT google._domainkey.example.comOutils en ligne pour tester l'authentification des e-mails :
- MXToolbox
- DMARC Analyzer
- Mail-Tester
Types d'enregistrements associés
- MX - Configuration du serveur de messagerie
- CAA - Restrictions d'autorité de certification
- TLSA - Authentification de certificat DANE
Conclusion
Les enregistrements TXT sont des éléments polyvalents et essentiels du DNS moderne, indispensables pour la sécurité des e-mails, la vérification de domaine et les besoins applicatifs personnalisés. Une configuration correcte des enregistrements SPF, DKIM et DMARC est critique pour la délivrabilité et la sécurité des e-mails. DNScale facilite la gestion de tous vos enregistrements TXT depuis une interface unique.