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

Comment fonctionne le protocole ACME

Après cette leçon: Je peux décrire les étapes d’une commande ACME, du compte au certificat téléchargé.

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

ACME obtient un certificat sans personne

ACME, pour Automatic Certificate Management Environment, est le protocole qu’un programme utilise pour obtenir un certificat d’une AC sans intervention humaine. Il est défini dans la RFC 8555.

Sans lui, un certificat de 47 jours oblige quelqu’un à renouveler toutes les quelques semaines, pour chaque nom. Avec lui, le renouvellement est une tâche qui tourne seule.

À la fin de cette leçon

Remarque

Je peux décrire les étapes d’une commande ACME, du compte au certificat téléchargé.

Mots clés

MotCe que ça veut dire
Annuairela liste des adresses ACME de l’AC
Compteune paire de clés par laquelle l’AC connaît le client
Commandeune demande pour un certificat et ses noms
Autorisationla trace, chez l’AC, de la preuve d’un nom
Finaliserenvoyer la demande de signature une fois chaque nom prouvé
CSRune demande de signature de certificat qui contient la clé publique

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

Tout commence par l’annuaire

On donne une seule adresse au client : l’annuaire. Il le lit et y trouve toutes les autres. Elles disent où obtenir un nonce, créer un compte, passer une commande, révoquer et changer de clé.

Un nonce est un nombre à usage unique. Chaque requête en porte un neuf, pour que personne ne puisse renvoyer une ancienne requête.

Lire l’annuaire de l’AC du labo

Commande
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crt

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

Ce que liste l’annuaire

Nom dans la réponseÀ quoi le client s’en sert
newNonceObtenir un nonce neuf avant une requête
newAccountEnregistrer la clé du compte
newOrderDemander un certificat pour des noms
revokeCertDire qu’un certificat ne doit plus être cru
keyChangeRemplacer la clé du compte par une nouvelle

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

Une commande passe par cinq états

Chaque requête est signée avec la clé du compte. Le client passe une commande pour des noms. Chaque nom reçoit une autorisation, qui propose des défis.

La commande est pending tant que chaque nom n’est pas prouvé, puis ready. Le client finalise avec une CSR : la commande passe processing, puis valid. Une preuve ratée la rend invalid.

Afficher une commande enregistrée, étape par étape

Commande
docker exec python python3 steps/order.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 que montre la commande enregistrée

ÉtapeÉtatCe qui s’est passé
1 new-accountcompte validLa clé du client est désormais un compte
2 new-ordercommande pendingDemande un certificat pour shop
3 et 4 authorization, challengepending, puis processingLe client dit : venez voir
5 authorizationvalidL’AC a récupéré la preuve et elle correspondait
6 à 8 order, finalize, orderready, processing, validLa CSR est signée
9 certificateissuedLe client télécharge la chaîne

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

Une erreur courante

Attention

Beaucoup pensent que l’AC fabrique la clé du serveur et la lui envoie. Le client crée sa propre paire de clés et n’envoie que la moitié publique, dans la CSR. La clé privée ne quitte jamais le serveur.

Passez maintenant une vraie commande

Le conteneur client a la commande step, qui sait où est l’AC et à quelle racine se fier. Le Run suivant crée un compte, commande un certificat pour le nom client, le prouve par http-01 et finalise.

Il affiche done! pour le défi, pour l’attente de ready et pour la finalisation, puis nomme client.crt et client.key.

Commander un certificat pour client

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

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

Regarder ce que vous avez reçu

Commande
docker exec client step certificate inspect client.crt --short

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

Votre certificat, en bref

La vue courte indique Subject: client, Issuer: Lab Private CA Intermediate CA et Provisioner: acme, avec votre propre numéro de série et des dates à un jour d’écart.

La boutique a fait la même chose seule à son démarrage. Tapez docker logs shop dans le terminal pour voir ses lignes de compte, de commande, de défi et de finalisation. Ses heures et ses identifiants lui sont propres.

À 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.