// travaux pratiques · Administration système
TP04 - Obtenir des certificats Let’s Encrypt avec ACME
- TP 4 / 8
- 5 étapes
- ≈ 40 min
- Accès libre
Objectif : configurer un résolveur de certificats ACME, valider la configuration sur l’environnement de test de Let’s Encrypt, puis basculer en production.
Prérequis :
- Le laboratoire du TP03.
- Une VM joignable depuis Internet sur le port 80 et un nom de domaine qui vous appartient (par exemple
app.exemple.fr) dont l’enregistrement DNS pointe vers elle. Sans ces deux éléments, lisez le TP sans l’exécuter : les autres TP n’en dépendent pas.
Actions à réaliser :
Déclarer le résolveur dans la configuration statique. Ajoutez à
traefik.yml(remplacez l’adresse e-mail) :certificatesResolvers: le: acme: email: admin@exemple.fr storage: /letsencrypt/acme.json caServer: https://acme-staging-v02.api.letsencrypt.org/directory httpChallenge: entryPoint: webLe défi HTTP-01 utilise l’entryPoint
web: Traefik répond lui-même au défi avant d’appliquer la redirection vers HTTPS.Préparer le stockage persistant.
mkdir -p letsencrypt touch letsencrypt/acme.json chmod 600 letsencrypt/acme.jsonAjoutez au service
traefikle volume- ./letsencrypt:/letsencrypt(en lecture-écriture).Publier une application avec le résolveur.
public: image: traefik/whoami labels: - "traefik.enable=true" - "traefik.http.routers.public.rule=Host(`app.exemple.fr`)" - "traefik.http.routers.public.entrypoints=websecure" - "traefik.http.routers.public.tls.certresolver=le"docker compose up -d --force-recreate docker compose logs -f traefikSurveillez les messages relatifs à ACME pendant une à deux minutes, puis quittez avec Ctrl+C.
Contrôler le certificat de test.
openssl s_client -connect app.exemple.fr:443 -servername app.exemple.fr </dev/null 2>/dev/null \ | openssl x509 -noout -issuer -subject -datesL’émetteur contient la mention
(STAGING): la chaîne de délivrance fonctionne, mais le navigateur ne fait pas confiance à ce certificat.Basculer en production. Supprimez la ligne
caServerdetraefik.yml, videz le stockage de test et redémarrez :rm letsencrypt/acme.json touch letsencrypt/acme.json chmod 600 letsencrypt/acme.json docker compose restart traefikRelancez la commande
opensslde l’étape 4 et ouvrez l’adresse dans un navigateur.
Vérification / résultat attendu :
- En production, l’émetteur est une autorité intermédiaire Let’s Encrypt et le navigateur affiche un cadenas sans alerte.
- Le fichier
letsencrypt/acme.jsonn’est plus vide et conserve ses droits600. - Après
docker compose restart traefik, aucun nouveau certificat n’est demandé : il est relu depuisacme.json.
Pour aller plus loin : consultez la liste des fournisseurs DNS pris en charge (documentation de Lego, liée depuis la documentation ACME de Traefik) et préparez une configuration dnsChallenge pour un certificat générique.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.