Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Les défis ACME : HTTP-01 et DNS-01

Après cette leçon: Je peux calculer la valeur que publie un défi HTTP-01 ou DNS-01 et dire de quel défi un nom a besoin.

Leçon de 65 min3 commandesLab d’automatisation des certificats : ACME, certificats TLS de courte durée et renouvellement automatique avec une AC privée

Comment l’AC sait que le nom est vôtre

Un défi ACME est l’épreuve qu’une AC impose pour prouver que vous contrôlez un nom de domaine avant de signer un certificat. HTTP-01 vous demande de publier une valeur à une adresse web, DNS-01 dans un enregistrement DNS.

Choisissez le mauvais, et le renouvellement échoue à trois heures du matin.

À la fin de cette leçon

Remarque

Je peux calculer la valeur que publie un défi HTTP-01 ou DNS-01 et dire de quel défi un nom a besoin.

Mots clés

MotCe que ça veut dire
Empreinteun court condensé qui représente la clé du compte
Autorisation de cléla valeur de l’AC, un point et l’empreinte
HTTP-01une preuve servie sur le port 80 à un chemin fixe
DNS-01une preuve publiée dans un enregistrement TXT
Enregistrement TXTun enregistrement DNS qui contient du texte brut
Jokerun nom comme *.shop.example qui couvre un niveau

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Les deux défis publient une autorisation de clé

L’AC choisit une valeur aléatoire pour chaque défi. Le client la joint à l’empreinte de sa clé de compte avec un point. Le résultat est l’autorisation de clé.

Seul le détenteur de la clé du compte peut la fabriquer. La publier prouve deux choses à la fois : vous contrôlez le nom, et vous êtes ce compte.

HTTP-01 la sert sur le port 80

Pour HTTP-01, l’AC récupère http://<nom>/.well-known/acme-challenge/<valeur> sur le port 80. La réponse doit être l’autorisation de clé.

Ce défi convient à un serveur web déjà joignable sous ce nom. Il ne peut pas prouver un joker, et il échoue si le port 80 est fermé ou si le nom pointe ailleurs.

Calculer les deux preuves en Python

Commande
docker exec python python3 steps/challenges.py

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Ce qu’affiche le modèle

LigneCe qu’elle veut dire
key authorisation: e8Kq2LvX0n4RcT7wYb1mPz9hJd3s.jW5aL0b7Qm3x...La valeur de l’AC, un point, l’empreinte
http://shop.example/.well-known/acme-challenge/e8Kq2LvX0n4RcT7wYb1mPz9hJd3sOù HTTP-01 est récupéré
_acme-challenge.shop.example TXT vmbbIVBfAfWejbz8l4MJmQwQ6JlM5mjoPCqB4qPA2HwL’enregistrement DNS-01
43 charactersUn condensé SHA-256 en base64url, sans remplissage
*.shop.example dns-01 onlyUn joker demande DNS-01

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

DNS-01 place un condensé dans le DNS

Pour DNS-01, le client passe l’autorisation de clé au SHA-256 et l’écrit, en base64url, dans un enregistrement TXT à _acme-challenge.<nom>. L’AC consulte cet enregistrement.

Rien n’a besoin d’être joignable depuis internet : un serveur interne peut donc prouver son nom. C’est le seul défi possible pour un joker. Le prix : le client a besoin d’une clé qui modifie votre DNS.

Exemple détaillé : choisir un défi

Nom ou situationDéfiPourquoi
shop.example sur un serveur web publicHTTP-01Le port 80 est déjà ouvert
*.shop.exampleDNS-01Un joker ne se prouve que dans le DNS
Un serveur du personnel injoignable de l’extérieurDNS-01L’AC ne s’y connecte jamais
Port 80 bloqué, port 443 ouvertTLS-ALPN-01Un troisième défi, prouvé en TLS sur le 443

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Une erreur courante

Attention

Beaucoup pensent que HTTP-01 est vérifié sur le port 443 parce que le site tourne en HTTPS. L’AC récupère toujours du HTTP simple sur le port 80. Fermez le port 80 et chaque renouvellement HTTP-01 échoue, quelle que soit la qualité de votre HTTPS.

Regardez HTTP-01 échouer deux fois

Dans la leçon 2, le nom client a réussi, parce que l’AC a joint le conteneur client. Demandez maintenant deux noms qui ne sont pas à vous.

Rien dans le labo ne répond au nom bank. Le nom shop répond, mais le serveur web qui s’y trouve n’est pas votre client : il ne peut pas servir votre preuve.

Demander un nom auquel rien ne répond

Commande
docker exec client step ca certificate bank bank.crt bank.key --provisioner acme --standalone

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Demander un nom servi par un autre

Commande
docker exec client step ca certificate shop mine.crt mine.key --provisioner acme --standalone

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Ce qu’affichent les deux échecs

NomDernière ligneCe qui s’est passé
bankUnable to validate challenge: The server could not connect to validation targetPersonne n’a répondu sur le port 80
shopUnable to validate challenge: The server will not issue certificates for the identifierCaddy a répondu, pas votre client : la preuve était fausse

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

À propos de ce labo et de sa source: Lab d’automatisation des certificats : ACME, certificats TLS de courte durée et renouvellement automatique avec une AC privée

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.