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 bases de l’automatisation des certificats

La leçon entière est gratuite et interactive. Lisez-la ici, ou appuyez sur Démarrer le labo pour la pratiquer pour de vrai dans un labo en direct, sans compte.

Labo de conteneurs11 min de lecture7 commandes

Pourquoi le cadenas n’expire-t-il jamais ?

Chaque site qui affiche un cadenas présente un certificat, et chaque certificat a une date de fin. Bientôt, un certificat public ne pourra pas durer plus de 47 jours. Personne ne renouvelle des milliers de certificats à la main : un programme en demande un nouveau avant que l'ancien n'expire. Ce lab te montre comment.

À la fin de cette leçon

Remarque

Je peux demander un certificat à une autorité de certification privée avec ACME et vérifier quand il faut le renouveler.

Mots-clés

  • Certificat : un fichier signé qui relie un nom, comme shop, à une clé publique.
  • Autorité de certification (AC) : le service qui contrôle une demande et signe les certificats.
  • ACME : le protocole qu'un programme utilise pour demander un certificat à une AC, sans personne derrière le clavier.
  • Défi (challenge) : l'épreuve que fixe l'AC pour prouver que tu contrôles le nom demandé.
  • Chaîne : ton certificat, puis les certificats d'AC au-dessus, jusqu'à une racine de confiance.
  • Renouvellement : obtenir un certificat neuf avant la fin de l'ancien.

Pour commencer : ce que tu sais déjà

Remarque

Réponds dans ta tête. 1. Qu'apporte le S de HTTPS ? 2. Qui décide qu'un site est bien celui qu'il prétend être ? 3. Que se passe-t-il quand une chose dont tu dépends expire sans que personne ne le remarque ? Réponses : le chiffrement et une vérification de l'identité du serveur ; une autorité de certification à laquelle ton navigateur fait confiance ; elle cesse de marcher, souvent au pire moment.

Avant de commencer

Remarque

Appuie sur Démarrer le lab dans la barre en haut de la leçon et attends qu'il indique qu'il est en marche. Il y a quatre conteneurs, ca, shop, client et python, et le terminal atteint chacun avec docker exec <nom>, qui lance une commande à l'intérieur. Chaque bouton Exécuter ci-dessous tape sa commande dans le terminal de ton lab, l'une après l'autre, dans la même session. Pour suivre les commandes ou taper les tiennes, appuie sur Ouvrir le terminal dans la barre.

L’AC liste ses adresses ACME dans un annuaire

Un client ACME commence par lire l'annuaire de l'AC, une courte liste d'adresses. Cette commande le demande avec curl, en faisant confiance à la racine du lab. La réponse cite newNonce, newAccount, newOrder, revokeCert et keyChange : une adresse par tâche. Un client n'a besoin de connaître que l'adresse de l'annuaire pour trouver toutes les autres.

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.

La boutique a déjà obtenu seule son certificat

Personne n'a donné son certificat à la boutique. Au démarrage, elle l'a demandé à l'AC par ACME et a prouvé qu'elle contrôle le nom shop. La première commande ouvre la page en HTTPS et affiche « The shop is open ». La seconde lit le certificat : il est valable pour DNS:shop, l'émetteur est Lab Private CA Intermediate CA, la durée de vie est de 24 heures et le sujet est vide, car le nom qui compte est dans la liste des noms.

Commande
docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop

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

Commande
docker exec python python3 steps/read_shop.py

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

Vérifie

Astuce

Pourquoi curl a-t-il besoin de --cacert ici ? Réponse : la racine du lab n'est pas une racine à laquelle ton ordinateur fait déjà confiance, donc on indique à curl contre quelle racine vérifier la chaîne. Sans elle, il refuse avec l'erreur 60.

Demander un certificat à la main

C'est maintenant toi le client. step crée un compte, passe une commande pour le nom client, répond au défi http-01 en écoutant un instant sur le port 80, puis envoie une demande de signature. Il affiche done! pour le défi, l'attente et la fin, puis nomme les deux fichiers écrits : client.crt et client.key. Le nom client marche parce que l'AC, quand elle le cherche, arrive sur ce conteneur même.

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.

Un nom que tu ne contrôles pas est refusé

Demande bank, un nom auquel rien ne répond dans le lab. L'AC essaie d'aller chercher la preuve chez bank, ne trouve personne et s'arrête : Unable to validate challenge: The server could not connect to validation target. Aucun certificat n'est écrit. Ce refus est toute la raison d'être d'un défi.

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.

Vérifier s’il faut le renouveler

needs-renewal répond oui dès que les deux tiers de la durée de vie sont passés. Ton certificat a une minute, donc la première commande affiche certificate does not need renewal. La seconde demande s'il expire dans les 25 prochaines heures. Il expire dans 24, donc elle affiche certificate needs renewal. Une tâche de renouvellement pose cette question à intervalles réguliers et agit selon la réponse.

Commande
docker exec client step certificate needs-renewal client.crt --verbose

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

Commande
docker exec client step certificate needs-renewal client.crt --expires-in 25h --verbose

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

Une erreur fréquente

Attention

Beaucoup pensent qu'un certificat prouve qu'un site est sûr ou honnête. Il prouve seulement que le détenteur de la clé contrôlait le nom au moment où l'AC a vérifié. C'est pourquoi la vérification recommence à chaque renouvellement, et pourquoi les durées de vie courtes comptent.

Vérification finale

Astuce

Réponds sans revenir en arrière. 1. Que lit d'abord un client pour trouver les adresses d'une AC ? 2. Qu'a fait l'AC pour vérifier le nom client ? 3. Pourquoi bank a-t-il été refusé ? 4. Quand needs-renewal répond-il oui par défaut ? Réponses : l'annuaire ; elle est allée chercher une preuve en HTTP auprès de ce nom ; rien ne répondait à ce nom ; après les deux tiers de la durée de vie.

Pour les enseignants

Astuce

Cette leçon est un petit exemple de leçon qui se fait dans un lab : les étapes et les boutons Exécuter sont la leçon, et le lab est la copie de chaque élève. Le lab compte quatre conteneurs : step-ca comme AC privée avec ACME, Caddy comme serveur web qui obtient et renouvelle seul son certificat, le client step et Python avec OpenSSL. Rien ne se corrige tout seul : l'élève rend un court compte rendu. Points clés : 1. ACME permet à un programme d'obtenir un certificat sans intervention humaine. 2. Un défi prouve le contrôle d'un nom. 3. Le renouvellement est dû après les deux tiers de la durée de vie. Erreur fréquente : prendre un certificat pour la preuve qu'un site est honnête. Les numéros de série et les dates diffèrent pour chaque élève, la durée de vie non. Matériel : le lab et un navigateur. Conseil : demandez aux élèves ce qui arriverait à la boutique si son renouvellement cessait de marcher aujourd'hui. Copiez-la dans votre propre module et modifiez-la, ou créez-en une de zéro avec le menu Lab de l'éditeur de leçons.

À 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 ces leçons à vos élèves avec correction et un labo pour chaque élève.