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
| Mot | Ce que ça veut dire |
|---|---|
| Annuaire | la liste des adresses ACME de l’AC |
| Compte | une paire de clés par laquelle l’AC connaît le client |
| Commande | une demande pour un certificat et ses noms |
| Autorisation | la trace, chez l’AC, de la preuve d’un nom |
| Finaliser | envoyer la demande de signature une fois chaque nom prouvé |
| CSR | une 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
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crtAffiché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 |
|---|---|
| newNonce | Obtenir un nonce neuf avant une requête |
| newAccount | Enregistrer la clé du compte |
| newOrder | Demander un certificat pour des noms |
| revokeCert | Dire qu’un certificat ne doit plus être cru |
| keyChange | Remplacer 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
docker exec python python3 steps/order.pyAffiché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 | État | Ce qui s’est passé |
|---|---|---|
| 1 new-account | compte valid | La clé du client est désormais un compte |
| 2 new-order | commande pending | Demande un certificat pour shop |
| 3 et 4 authorization, challenge | pending, puis processing | Le client dit : venez voir |
| 5 authorization | valid | L’AC a récupéré la preuve et elle correspondait |
| 6 à 8 order, finalize, order | ready, processing, valid | La CSR est signée |
| 9 certificate | issued | Le 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
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --forceAffiché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
docker exec client step certificate inspect client.crt --shortAffiché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.