Lab d’automatisation des certificats : ACME, certificats TLS de courte durée et renouvellement automatique avec une AC privée

Ce lab donne à chaque élève son propre petit monde de certificats TLS : une autorité de certification (AC) privée qui parle ACME, le protocole qui permet à un programme d’obtenir un certificat sans que personne ne tape rien, un serveur web qui obtient et renouvelle seul son certificat auprès d’elle, la ligne de commande step pour en demander un à la main, et Python avec OpenSSL pour les lire. Les certificats publics durent au plus 200 jours depuis mars 2026 et dureront 47 jours à partir de mars 2029 : le renouvellement doit donc être automatique, et c’est ici que les élèves voient comment.

Ce n’est pas un lab d’attaque. Chaque copie n’a aucune route vers internet ni vers un autre élève, et aucun navigateur ne fait confiance à ce qu’elle contient : l’AC crée ses propres clés au premier démarrage du lab. Il n’a pas de page web, tout se tape donc dans le terminal à côté, et l’AC signe des certificats valables 24 heures : le renouvellement y est un événement quotidien et non annuel.

Ce que les élèves apprennent

Comment lire un certificat avec openssl x509 (ses noms dans l’extension subject alternative name, son émetteur, ses dates et la chaîne jusqu’à une racine, vérifiée avec openssl verify), comment une commande ACME va du compte au certificat téléchargé (l’annuaire de l’AC, la commande, le défi, la finalisation), comment le défi http-01 réussit pour un nom que vous contrôlez et échoue pour un nom qui n’est pas le vôtre, quand renouveler (aux deux tiers de la durée de vie, step certificate needs-renewal, la gigue et ACME Renewal Information), pourquoi la révocation ne protège que les clients qui vérifient alors qu’une courte durée de vie limite une clé volée pour tout le monde, et comment on mène le renouvellement à grande échelle : sonder le certificat réellement servi, tenir un inventaire, alerter. Il convient à un cours de sécurité des réseaux, d’administration système ou de DevOps, et le module « Certificats de courte durée et automatisation ACME » s’y travaille.

Le lancer dans votre navigateur

Le lab démarre quatre services, ca, shop, client et python, et attend que chacun soit en bonne santé. À ce moment, le serveur web a déjà demandé son certificat à l’AC. Le terminal atteint chaque service avec docker exec suivi de son nom.

  1. Ouvrir la page Conteneur. Ouvrez « Créer » dans la barre et choisissez « Lancer un conteneur ». Tout le monde peut ouvrir la page, et le lab Git et le lab SQL se lancent sans compte. Tous les autres labs demandent un compte gratuit : créez-en un, connectez-vous, puis appuyez sur « Démarrer ».
  2. Trouver le lab. La carte « Laboratoires d’exemple » liste tous les exemples. Trouvez « Certificats : ACME et renouvellement automatique ».
  3. Appuyer sur Démarrer. « Démarrer » le lance tel quel, en un clic. « Modifier le fichier d’abord » ouvre le fichier compose pour que vous puissiez le changer avant de démarrer.
  4. L’ouvrir. Sur la page du lab, appuyez sur « Ouvrir le terminal ». Il n’y a aucun lien sous « Dans votre navigateur », car le lab n’a pas de page web. Tapez docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop : la boutique répond en HTTPS avec un certificat signé par l’AC du lab. Puis docker exec python python3 steps/read_shop.py affiche les noms pour lesquels il est valable, son émetteur et sa durée de vie de 24 heures.

Ce qui est réel et ce qui est un modèle

Réel : l’AC (step-ca) avec son annuaire ACME, ses comptes et ses commandes, le serveur web (Caddy) qui obtient et renouvelle son certificat par http-01, un certificat demandé à la main avec le client step, l’échec de http-01 pour un nom auquel rien ne répond et pour un nom tenu par un autre serveur, la chaîne lue et vérifiée avec OpenSSL, les contrôles de renouvellement, et une révocation suivie du renouvellement que l’AC refuse. Modèles en Python, qui le disent à l’écran : dns-01, parce que le lab n’a pas de serveur DNS où un élève pourrait ajouter un enregistrement TXT, et ACME Renewal Information (RFC 9773), parce que l’AC du lab ne la propose pas encore. Les deux suivent les règles du protocole sur des valeurs inventées. Les numéros de série et les dates changent à chaque certificat émis : les scripts affichent donc des durées de vie et des règles plutôt que des dates.

Que demander aux élèves de rendre

Un court compte rendu : le certificat de la boutique lu avec openssl (sujet, noms, émetteur, durée de vie et chaîne), un certificat qu’ils ont demandé eux-mêmes, un contrôle de renouvellement qui dit oui et un qui dit non, une révocation suivie du renouvellement refusé par l’AC, et une phrase expliquant pourquoi les certificats de courte durée font le travail que la révocation devait faire. Une bonne phrase dit que la plupart des clients ne vérifient pas la révocation, et que seule la date de fin arrête une clé volée pour tout le monde.

A basic lesson on this lab

Certificate Automation Basics est une petite leçon qui se fait dans ce lab. L’élève y lit l’annuaire ACME de l’AC, ouvre la boutique en HTTPS et lit son certificat, demande un certificat à la main, voit refuser un nom qu’il ne contrôle pas, et vérifie si un certificat doit être renouvelé.

Les comptes personnels gratuits l’ont dans le module Basics, qui se trouve sur l’« Accueil », chaque établissement peut la copier depuis le dossier Basics de la Bibliothèque, et un nouvel établissement l’a dans un module appelé DevOps Labs (Sample). Elle est volontairement petite : elle montre à un enseignant ce qu’est une leçon qui se fait dans un lab, et le lab fait le reste. Copiez-la dans un module à vous pour la modifier.

Le code sur GitHub

Le fichier compose n’a pas de Dockerfile : il lance des images publiques standard figées à une version, step-ca pour l’AC et le client (Apache-2.0), Caddy pour le serveur web (Apache-2.0) et l’image Python officielle, qui contient OpenSSL, avec 384 Mo de mémoire en tout. Aucune n’est distribuée par nous. L’AC garde ses clés dans un volume nommé : les certificats émis avant un arrêt se vérifient encore après un redémarrage, et les autres services ne lisent que sa racine. Les scripts de steps/ sont écrits par le fichier compose lui-même à partir d’un texte fixe. Le lab n’a aucun accès à internet et ne contient ni clé ni mot de passe : l’AC crée les siens, au hasard, à son premier démarrage.

En faire un travail

Indiquez dans la tâche ce qu’il faut rendre.

  1. Créer le lab. Dans votre module, ajoutez une tâche et choisissez la carte « Lab de conteneurs », puis « Dans un dépôt GitHub ». Indiquez https://github.com/mitsurutech/lab-acme-lab avec la branche main. Le fichier compose par défaut est compose.yaml. Faites d’abord un fork du dépôt si vous voulez le modifier.
  2. Publier et l’essayer. « Publier » fige le commit qui vous a été montré : un changement ultérieur dans le dépôt ne modifie donc pas un lab que vous avez déjà proposé. Démarrez d’abord votre propre copie.
  3. Le distribuer. Attribuez-le comme n’importe quelle tâche, avec une échéance si vous le souhaitez, et indiquez dans la tâche ce qu’il faut faire et ce qu’il faut rendre.
  4. Noter ce qui est rendu. Ouvrez la copie d’un élève et le travail rendu, notez-le et renvoyez-le avec un motif s’il demande un complément.

Essayer ce lab, et ce qu’il coûte

Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.

Questions fréquentes

Pourquoi les certificats de ce lab ne durent-ils que 24 heures ?
C’est le réglage par défaut de l’AC du lab, et il permet de voir un renouvellement en une seule séance plutôt qu’une fois par an. Les certificats publics vont dans le même sens : 200 jours depuis mars 2026, 100 à partir de mars 2027 et 47 à partir de mars 2029.
Un navigateur fera-t-il confiance au certificat de la boutique ?
Non, et il ne le doit pas. La racine n’appartient qu’à cette copie du lab, créée à son premier démarrage. Dans le lab, curl et OpenSSL reçoivent l’ordre de lui faire confiance avec --cacert et -CAfile, exactement comme une entreprise le fait avec sa propre AC privée.
Pourquoi dns-01 et ARI sont-ils des modèles et non la vraie chose ?
dns-01 demande un serveur DNS où l’élève peut ajouter un enregistrement TXT, et le lab n’en a pas. ACME Renewal Information demande une AC qui la propose, et celle du lab ne le fait pas encore. Les deux sont travaillés en Python avec les règles du protocole : les valeurs sont celles que calculerait un vrai client.
Pourquoi un certificat révoqué se vérifie-t-il encore ?
step certificate verify, comme la plupart des clients, contrôle les signatures et les dates et ne demande pas à l’AC si le certificat a été révoqué. L’AC, elle, s’en souvient : c’est pourquoi elle refuse ensuite de le renouveler. Cet écart est le cœur de la leçon : seule la date de fin arrête une clé volée pour tous les clients.