Aller au contenu
local-cert
Parcourir la documentation

certbot, acme.sh, lego

Les trois clients en ligne de commande. Ils suffisent à équiper n'importe quelle machine, et la plupart des intégrations des autres guides reposent sur l'un d'eux.

ValeurOù la trouverDans ce guide
Directory ACMEfixe pour chaque instancehttps://certs.example.com/acme/directory
Key ID (kid)Clés & droits → Identifiants EABeab_XXXXXXXXXXXXXXXX
Clé HMACaffichée une seule fois à la créationCLE_HMAC

certbot

Port 80 libre sur la machine : mode autonome.

certbot — standalone
certbot certonly --standalone -d nas.home.example.com \
  --server https://certs.example.com/acme/directory \
  --eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC \
  --email ops@example.com --agree-tos --no-eff-email

Port 80 occupé : mode webroot, vers un dossier vide.

certbot — webroot
mkdir -p /var/lib/letsencrypt/webroot
certbot certonly --webroot -w /var/lib/letsencrypt/webroot -d nas.home.example.com \
  --server https://certs.example.com/acme/directory \
  --eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC \
  --email ops@example.com --agree-tos --no-eff-email \
  --deploy-hook "systemctl reload nginx"

Les fichiers arrivent dans /etc/letsencrypt/live/nas.home.example.com/. Le serveur et l'EAB sont mémorisés dans le fichier de renouvellement : le timer certbot renew installé par le paquet renouvelle sans autre réglage. Vérifiez avec certbot renew --dry-run.

acme.sh

L'enregistrement du compte est une étape séparée, faite une fois par machine.

acme.sh
# 1. compte, avec l'EAB
acme.sh --register-account --server https://certs.example.com/acme/directory \
  --eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC -m ops@example.com

# 2. émission (webroot vers un dossier vide)
mkdir -p /var/lib/acme-webroot
acme.sh --issue --server https://certs.example.com/acme/directory \
  -d nas.home.example.com -w /var/lib/acme-webroot

# 3. installation des fichiers et commande de rechargement
acme.sh --install-cert -d nas.home.example.com \
  --key-file       /etc/ssl/private/nas.home.example.com.key \
  --fullchain-file /etc/ssl/certs/nas.home.example.com.pem \
  --reloadcmd      "systemctl reload nginx"

Avec le port 80 libre, remplacez -w … par --standalone (socat requis). Le renouvellement passe par la tâche cron installée par acme.sh ; le dossier webroot doit donc exister durablement, d'où un chemin hors de /tmp.

lego

lego
lego --server https://certs.example.com/acme/directory \
  --eab --kid eab_XXXXXXXXXXXXXXXX --hmac CLE_HMAC \
  --email ops@example.com --accept-tos \
  --http --domains nas.home.example.com \
  run

Les fichiers arrivent dans ./.lego/certificates/. lego n'installe pas de tâche planifiée : programmez vous-même la même commande terminée par renew --days 30. Avec le port 80 occupé, ajoutez --http.webroot /var/lib/acme-webroot.

Vérifier

openssl
openssl x509 -in /etc/letsencrypt/live/nas.home.example.com/fullchain.pem -noout -issuer -subject -enddate

L'émetteur doit être Let's Encrypt (ou (STAGING) tant que local-cert est en environnement de test). Le certificat apparaît aussi dans Certificats.