Accueil » Formations » Administration système » Reverse proxy et HTTPS avec Traefik » TP04 – Obtenir des certificats Let’s Encrypt avec ACME

TP04 – Obtenir des certificats Let’s Encrypt avec ACME

← Reverse proxy et HTTPS avec Traefik

// 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 :

  1. 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: web

    Le défi HTTP-01 utilise l’entryPoint web : Traefik répond lui-même au défi avant d’appliquer la redirection vers HTTPS.

  2. Préparer le stockage persistant.

    mkdir -p letsencrypt
    touch letsencrypt/acme.json
    chmod 600 letsencrypt/acme.json

    Ajoutez au service traefik le volume - ./letsencrypt:/letsencrypt (en lecture-écriture).

  3. 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 traefik

    Surveillez les messages relatifs à ACME pendant une à deux minutes, puis quittez avec Ctrl+C.

  4. 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 -dates

    L’émetteur contient la mention (STAGING) : la chaîne de délivrance fonctionne, mais le navigateur ne fait pas confiance à ce certificat.

  5. Basculer en production. Supprimez la ligne caServer de traefik.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 traefik

    Relancez la commande openssl de 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.json n’est plus vide et conserve ses droits 600.
  • Après docker compose restart traefik, aucun nouveau certificat n’est demandé : il est relu depuis acme.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.

Demander un programme
Défiler vers le haut