Loading...

Sécurité

Challenge DNS-01 : des certificats Let's Encrypt validés dans le DNS

Avant qu'une autorité de certification comme Let's Encrypt délivre un certificat, elle vérifie que vous contrôlez le domaine. Le challenge DNS-01 le fait avec un enregistrement TXT plutôt qu'avec un fichier sur votre serveur web : il fonctionne donc où que passe votre trafic, avant une migration, derrière un CDN, sur des serveurs que l'internet ne peut pas joindre. C'est aussi la voie pour obtenir un certificat wildcard. Ce guide explique comment il fonctionne et comment l'utiliser.

9 min de lecture Intermédiaire Mis à jour

Challenge DNS-01 : des certificats Let's Encrypt validés dans le DNS

Pourquoi une autorité de certification demande une preuve

Un certificat TLS atteste qu'une clé publique appartient à un domaine. Avant de signer cette attestation, une autorité a besoin de la preuve que celui qui demande le certificat contrôle le domaine. Avec ACME, le protocole qu'utilisent Let's Encrypt et d'autres autorités, la preuve est un challenge : l'autorité remet à votre client ACME un jeton aléatoire, le client le publie à un endroit que seul le propriétaire du domaine pourrait atteindre, et l'autorité va le chercher.

Les trois types de challenge ne diffèrent que par l'endroit où va le jeton. Cette seule différence détermine quels certificats vous pouvez obtenir, où votre client doit s'exécuter, et si ce qui se trouve devant votre site importe.

HTTP-01, TLS-ALPN-01 et DNS-01 comparés

HTTP-01. Le client sert un fichier à http://<domain>/.well-known/acme-challenge/<token> et l'autorité le récupère sur le port 80. C'est le choix par défaut de la plupart des clients et le plus simple pour commencer. Le domaine doit déjà pointer vers un serveur capable de servir le fichier, le port 80 doit être ouvert, et il ne peut pas émettre de certificats wildcard.

TLS-ALPN-01. Le client répond à une connexion TLS sur le port 443 avec un certificat spécial pour le protocole acme-tls/1. Il convient aux installations qui gardent le port 80 fermé, exige de contrôler le listener TLS lui-même, et ne peut pas non plus émettre de wildcards.

DNS-01. Le client publie un enregistrement TXT à _acme-challenge.<domain> contenant une valeur dérivée du jeton, et l'autorité le recherche dans le DNS. Rien du côté du serveur web n'intervient. Il valide les wildcards, fonctionne pour des hôtes que l'internet ne peut pas joindre et quoi qu'il y ait devant le site. En contrepartie, le client a besoin d'un moyen d'écrire des enregistrements DNS : une API, ou vos mains.

Comment fonctionne DNS-01, étape par étape

1. Commande. Votre client ACME demande un certificat couvrant, par exemple, example.com et *.example.com.

2. Jeton. Pour chaque nom, l'autorité renvoie un challenge DNS-01, et le client calcule la valeur à publier à partir du jeton et de sa clé de compte.

3. Enregistrement TXT. La valeur va dans un enregistrement TXT nommé _acme-challenge.example.com. Le wildcard utilise le même nom que le domaine nu : un certificat pour les deux exige donc deux valeurs TXT sous un même nom. C'est normal : ajoutez-les toutes les deux.

4. Propagation. L'enregistrement doit atteindre chaque serveur de noms faisant autorité de la zone, car l'autorité peut interroger n'importe lequel d'entre eux, depuis plusieurs endroits.

5. Validation et émission. Le client demande à l'autorité de vérifier ; l'autorité trouve les valeurs, marque les noms comme validés, et le client télécharge le certificat. Les enregistrements TXT peuvent ensuite être supprimés.

Vous pouvez voir ce que l'autorité verra avant de lui demander de regarder.

Vérifier l'enregistrement TXT avant la validation

# what your resolver sees
dig +short TXT _acme-challenge.example.com

# ask every authoritative name server directly
for ns in $(dig +short NS example.com); do
  echo "$ns: $(dig +short TXT _acme-challenge.example.com @$ns)"
done

Les certificats wildcard exigent DNS-01

Un certificat wildcard couvre chaque nom de premier niveau sous un domaine : *.example.com correspond à www.example.com, api.example.com et à tout sous-domaine que vous ajouterez l'an prochain, mais pas à example.com lui-même ni à a.b.example.com. C'est pourquoi les commandes wildcard demandent généralement example.com et *.example.com ensemble.

Let's Encrypt ne valide les noms wildcard qu'avec DNS-01, et la raison est simple : un fichier sur un serveur web prouve le contrôle d'un seul nom d'hôte, alors qu'un wildcard parle pour tous les noms d'hôte de la zone ; la preuve doit donc venir de la zone elle-même.

Avant une migration, derrière un CDN, sur des hôtes privés

Comme DNS-01 ne touche jamais le serveur web, il ne se soucie pas de l'endroit où va le trafic.

Avant une migration. Émettez le certificat de la nouvelle plateforme alors que le domaine pointe encore vers l'ancienne. Quand vous changez de DNS, le certificat est déjà en place et HTTPS fonctionne dès la première requête.

Derrière un CDN ou un proxy. La validation ne dépend pas du serveur qui répond sur le port 80 : le même client fonctionne donc que le site soit servi directement ou via un CDN.

Hôtes privés et internes. Un serveur de préproduction, une application d'intranet ou un serveur de messagerie que l'internet ne peut pas joindre peuvent tout de même obtenir un certificat reconnu publiquement, du moment que leur nom se trouve dans une zone DNS publique où vous pouvez écrire.

Plusieurs serveurs, un seul nom. Derrière un répartiteur de charge, HTTP-01 doit retrouver le jeton sur le serveur qui répond. DNS-01 est validé une seule fois, et vous distribuez le certificat.

certbot, acme.sh et cert-manager

certbot gère DNS-01 de deux façons. Un plugin DNS écrit et supprime les enregistrements TXT via l'API de votre fournisseur DNS, ce qui rend aussi possible un renouvellement sans surveillance ; il existe des plugins pour la plupart des grands fournisseurs DNS et pour les mises à jour dynamiques RFC 2136 vers vos propres serveurs de noms. Le mode manuel affiche l'enregistrement et attend que vous l'ajoutiez : correct pour un certificat ponctuel, mais chaque renouvellement exige une personne.

acme.sh gère DNS-01 avec bien plus d'une centaine d'API de fournisseurs, et dans Kubernetes, cert-manager fait de même via le solveur dns01 d'un Issuer. Quel que soit votre choix, gardez les identifiants d'API lisibles uniquement par root et donnez au jeton la permission la plus restreinte que propose votre fournisseur, idéalement la modification du DNS d'une seule zone. Le guide certbot couvre l'installation, le renouvellement et le côté HTTP-01.

certbot : un certificat wildcard avec DNS-01

# with a DNS plugin (here: RFC 2136 dynamic updates to your own name server)
sudo certbot certonly \
  --dns-rfc2136 --dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
  -d example.com -d '*.example.com'

# manual: certbot prints the TXT values and waits for you
sudo certbot certonly --manual --preferred-challenges dns \
  -d example.com -d '*.example.com'

# test renewal (works with a plugin; manual mode needs you again)
sudo certbot renew --dry-run

Sur cdn.com.tr : le certificat de périphérie, prêt avant le changement de DNS

Quand vous déplacez un domaine en production vers cdn.com.tr, le panneau émet le certificat de périphérie avec DNS-01 alors que le domaine pointe encore vers votre fournisseur actuel. Dans l'onglet Domaines de Domaines et règles, cliquez sur Définir le certificat et choisissez Obtenir un certificat avant de changer le DNS. L'assistant nomme le domaine racine et son wildcard, affiche l'enregistrement TXT à ajouter chez votre fournisseur DNS actuel, vérifie l'enregistrement pour vous, et émet un certificat wildcard Let's Encrypt qui est installé automatiquement sur les serveurs du CDN.

Changez de DNS quand vous êtes prêt : le domaine est servi en HTTPS dès la première seconde, sans interruption pendant l'émission d'un certificat. Le panneau affiche la date d'expiration du certificat, et relancer l'assistant prend les mêmes quelques minutes. Le guide de la validation DNS détaille chaque écran.

Quand DNS-01 est le bon challenge

Migrations sans interruption

Le certificat de la nouvelle plateforme existe avant que le premier visiteur y arrive.

Nombreux sous-domaines

Un seul certificat wildcard pour chaque nom de premier niveau, y compris ceux que vous ajouterez plus tard.

Hôtes internes

Des certificats reconnus publiquement pour les serveurs de préproduction, d'intranet et de messagerie que l'internet ne peut pas joindre.

Comment le mettre en place

Guides pas à pas dans le centre d'aide :

FAQ DNS-01

Quelle est la différence entre HTTP-01 et DNS-01 ?

HTTP-01 prouve le contrôle avec un fichier servi sur le port 80 du domaine ; DNS-01 le prouve avec un enregistrement TXT dans le DNS du domaine. HTTP-01 exige que le domaine pointe vers le serveur qui demande le certificat ; DNS-01 fonctionne où que pointe le domaine et c'est le challenge qui émet les certificats wildcard.

Pourquoi y a-t-il deux enregistrements TXT portant le même nom ?

Un certificat pour example.com et *.example.com demande une validation par nom, et les deux utilisent _acme-challenge.example.com. Ajoutez les deux valeurs comme des enregistrements TXT distincts et gardez-les jusqu'à la fin de la validation.

Combien de temps dure la propagation ?

En général quelques minutes, selon votre fournisseur DNS et le TTL de l'enregistrement. Interrogez chaque serveur de noms faisant autorité avec dig avant de lancer la validation ; si l'un répond encore sans la nouvelle valeur, attendez.

DNS-01 fonctionne-t-il derrière un CDN ?

Oui. Le challenge est résolu par votre DNS, pas par le serveur qui répond au trafic web : il fonctionne donc de la même façon avec ou sans CDN devant le site.

Un certificat DNS-01 se renouvelle-t-il automatiquement ?

Avec un client qui écrit dans votre DNS via une API, comme un plugin DNS de certbot, acme.sh ou cert-manager, oui. En mode manuel, quelqu'un ajoute l'enregistrement TXT à chaque renouvellement : prévoyez-le ou passez à une API.

Est-il sûr de donner à un client ACME l'accès à mon DNS ?

Limitez-le. Créez un jeton qui ne peut modifier que la zone concernée, ou faites pointer _acme-challenge par un CNAME vers une zone distincte utilisée uniquement pour la validation, pour que le client ne puisse rien changer d'autre. Gardez les identifiants lisibles uniquement par root.