Debian 13 : tutoriel / Configurer HTTPS dans Nginx et vérifier le renouvellement des certificats
Pour faire fonctionner HTTPS sur Debian 13, vous devez vérifier non seulement l'émission du certificat, mais aussi le nom, la chaîne de confiance, la date d'expiration et le certificat effectivement fourni par le serveur web. Une fois qu'un domaine public et un chemin de vérification externe sont prêts, vous pouvez configurer l'émission et le renouvellement avec Certbot, et dans une machine virtuelle de laboratoire sans de telles conditions, vous pouvez apprendre le même flux de vérification avec une autorité de certification (CA, Certificate Authority) locale de test. La vérification d'exécution dans ce cours utilise cette dernière méthode, et elle est distinguée afin de ne pas la confondre avec l'émission réussie d'un certificat public.
Séparer l'émission publique du laboratoire avec une CA de test locale
HTTPS est une méthode de protection de la communication HTTP avec TLS (Transport Layer Security, sécurité de la couche transport). Les certificats contiennent des informations telles que la clé publique du serveur et le nom à utiliser, et sont signés par une autorité de certification (CA). Les clients vérifient si cela se rattache à une CA de confiance, si le nom de connexion correspond au certificat et si celui-ci est dans la période de validité.
ACME (Automatic Certificate Management Environment) est un protocole pour vérifier le contrôle sur les domaines et automatiser l'émission et le renouvellement des certificats. Certbot est un client qui l'utilise. Les CA créées localement ne sont pas par défaut reconnues par les navigateurs Internet et ne remplacent pas les certificats de sites publics.
| Méthode | Exigences | Portée de la vérification dans ce cours |
|---|---|---|
| Émission publique Certbot | Domaine réel contrôlable, DNS/accès externe selon la méthode de vérification | Ceci est une procédure d'opération conditionnelle qui vérifie les documents officiels et les options installées. L'émission réelle n'a pas été effectuée. |
| CA de test locale | VM Debian séparée avec accès sudo, Nginx·OpenSSL·curl | Nous avons vérifié directement la confiance et la validation des noms, la réponse HTTPS, la réémission de certificats et le rechargement. |
Le guide sur le type de challenge de Let's Encrypt explique que HTTP-01 nécessite un accès externe à un jeton via le domaine sur le port 80. Ouvrir uniquement le port 8443 de la VM ou modifier un fichier hosts local ne satisfait pas cette condition. DNS-01 nécessite le contrôle de l'enregistrement TXT DNS public ; le renouvellement automatisé nécessite un plugin DNS approprié et des permissions API soigneusement définies.
Inspecter les versions installées et le minuteur de renouvellement réel
Pour vous entraîner, utilisez la VM de la leçon précédente où Nginx fonctionne normalement, et assurez-vous que le port 8443 et le chemin dédié ci-dessous sont vides. Sur les serveurs avec des sites publics existants, sauvegardez en toute sécurité la configuration, les certificats et les clés, et définissez l'étendue des modifications avant de continuer.
sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager
La machine virtuelle de vérification utilisait OpenSSL 3.5.7, Certbot 4.0.0 et Nginx 1.26.3. Dans le paquet Debian, certbot.timer ajoutait un délai aléatoire aux deux horaires de référence quotidiens et était configuré avec Persistent=true. Le certbot.service était un oneshot qui exécute renew. Si la méthode d'installation diffère, le nom du timer et le planning peuvent aussi différer, donc vérifiez les paramètres réels.
timer active signifie que le planning est activé. Cela ne signifie pas qu'un certificat existe ou que le renouvellement/déploiement a réussi. Le résultat de certbot certificates sur cette VM était No certificates found, et les certificats OpenSSL locaux subséquents ne sont pas automatiquement enregistrés comme cibles gérées par Certbot.
Créer la CA locale et compléter le site de test HTTPS
Exécutez le bloc complet uniquement lorsque chaque chemin de laboratoire dédié énuméré dans la vérification d’existence au début du code est absent. Placez la clé CA et la clé serveur dans des chemins accessibles uniquement par root, et ne laissez lisible par le client que le certificat CA public dans un chemin public séparé. Ne l'ajoutez pas au magasin de confiance du système ou du navigateur. Les clés sont générées sans mot de passe mais sont limitées avec des permissions de répertoire 700 et de fichier 600 ; cette méthode est uniquement pour un exercice local de courte durée.
Exécutez explicitement les privilèges administrateur avec sudo bash, et exécutez les commandes internes dans un seul shell root. Rendez la CA valide pendant 3 jours et le premier certificat serveur valide pendant 1 jour, incluant lab26.test dans le SAN (Subject Alternative Name). Ce nom est utilisé uniquement pour des tests locaux.
sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
listen 127.0.0.1:8443 ssl;
server_name lab26.test;
ssl_certificate /etc/nginx/lf-tls26/server.crt;
ssl_certificate_key /etc/nginx/lf-tls26/server.key;
default_type text/plain;
return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT
Parmi les fichiers générés, ca.key et server.key sont des clés privées, et ca.crt et server.crt sont des certificats publics. Ne supposez pas que le fait de définir le nom commun (CN, Common Name) suffit pour la validation du nom ; vérifiez également le SAN. Les extensions du certificat serveur spécifient qu'il n'est pas une CA et qu'il est destiné à l'authentification du serveur. La configuration et les conditions d'accès aux clés privées sont également expliquées dans le document de configuration HTTPS Nginx.
Après avoir vérifié la configuration et rechargé, effectuez des requêtes en tant qu'utilisateur régulier sur la machine virtuelle Debian. Si une connexion échoue immédiatement après le rechargement, réessayez après un court instant et vérifiez la sortie de ss et les journaux du service. L'option --resolve associe les noms aux adresses uniquement pour cette requête sans modifier le DNS, et --cacert rend la CA de test fiable uniquement pour cette requête.
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
La réponse attendue est TLS LAB 26. Ce succès est basé sur la vérification dans des conditions de loopback, de CA spécifiée et de nom spécifié, et ne reflète pas les résultats provenant du DNS public ou des vérifications de confiance d'un navigateur classique.
Distinguer les erreurs de confiance des incohérences de nom
Pour la première requête ci-dessous, ne spécifiez pas le certificat CA, et pour la deuxième requête, spécifiez le certificat CA mais connectez-vous à une adresse IP non incluse dans le certificat. Les deux commandes sont censées échouer. Exécutez cette comparaison dans un shell ordinaire neuf sans activer set -e, et lisez le code de sortie immédiatement après chaque requête ; un shell avec errexit pourrait se fermer avant que echo ne s'exécute.
curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"
Lors de la vérification, les deux cas ont renvoyé un code de sortie curl 60, mais le premier était causé par un émetteur non fiable et le second par une incompatibilité de nom. Ne vous contentez pas de les regrouper simplement en fonction du numéro ; lisez également le message d'erreur. Le résultat qui a réussi en désactivant la vérification avec -k ne peut pas être utilisé pour les vérifications de confiance du certificat.
Vérifiez la chaîne, le nom et la date d'expiration du fichier lui-même comme suit. Le chemin du certificat du serveur se trouve dans le répertoire réservé à root, donc sudo est utilisé.
sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600
-checkend 3600 vérifie s'il expirera dans les 3 600 prochaines secondes et renvoie un statut non nul si l'expiration est proche. Cela seul ne vérifie pas la chaîne ni le nom. Selon description de l'option OpenSSL x509, distinguez les objectifs pour les vérifications de date, SAN et chaîne.
Comparez le fichier de certificat avec le certificat servi par Nginx
Même si vous remplacez le certificat du serveur, vous ne pouvez pas garantir que le Nginx en cours d'exécution servira le nouveau certificat. Tout d'abord, vérifiez le numéro de série du certificat fourni lors d'une nouvelle connexion. -servername transmet le nom de serveur souhaité via le SNI (Server Name Indication) de TLS. Cette commande sert à observer le certificat, et la confiance réelle et la vérification du nom sont effectuées par les commandes curl et openssl verify précédentes.
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
Exécutez cette comparaison de remplacement une fois dans le laboratoire neuf. Conservez le premier server-before.crt plutôt que de l'écraser lors des tentatives répétées. Ces certificats expirent intentionnellement après seulement quelques jours ; utilisez une horloge système correcte et régénérez le laboratoire dédié si nécessaire.
Le numéro de série initial est 26 en hexadécimal. Ensuite, en utilisant le même CA de test et la même demande de signature de certificat (CSR, Certificate Signing Request), créez un nouveau certificat avec une période de validité de 2 jours et le numéro de série 27, et après que la vérification soit terminée, remplacez le nom du fichier dans le même répertoire. Cette comparaison est une réémission locale où l'étape de déploiement est observée séparément, et non un renouvellement ACME.
sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT
Immédiatement après avoir terminé le bloc ci-dessus, le numéro de série du fichier est 27, mais le certificat reçu dans une nouvelle connexion était toujours 26. C'est la preuve que le succès de la sauvegarde du fichier et le succès du déploiement sont différents. Le fichier known-good server-before.crt a été conservé à cette étape.
Le script de déploiement ci-dessous recharge Nginx uniquement si la vérification de sa configuration réussit. Dans cette pratique, il a été confirmé lors de la préparation qu'un fichier portant ce nom n'existe pas encore. Il n'est pas utilisé pour écraser les scripts existants sur les serveurs de production.
sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
Lors de la vérification, après le rechargement, le numéro de série de la nouvelle connexion est passé à 27 et la réponse HTTP était normale. L’arrêt des anciens workers peut prendre un peu de temps ; réessayez ensuite avec une nouvelle connexion. Si la vérification de la configuration échoue, le rechargement n'est pas effectué et la correspondance des fichiers/clés ainsi que le chemin/les permissions sont examinés. Lors de la restauration de ce certificat de pratique, copiez le certificat conservé server-before.crt vers server.crt et effectuez la vérification, le rechargement et la vérification de la fourniture du certificat dans le même ordre.
Utilisez Certbot uniquement après avoir préparé un domaine public
Cette procédure s'applique uniquement lors de l'exploitation d'un domaine réel. Séparé du site local à 127.0.0.1:8443, les enregistrements IPv4 A du domaine, ainsi que tout enregistrement IPv6 AAAA effectivement publié, doivent pointer vers le bon serveur, et l'accès HTTP-01 sur le port 80 doit être disponible sur tous les chemins utilisés. Vérifiez également les adresses IPv6 incorrectes, les proxies, CDN, pare-feu et paramètres NAT. Vérifiez l'accès au domaine depuis d'autres réseaux et ajustez le server_name dans le site Nginx pour qu'il corresponde au domaine réel.
Un test Certbot avec --dry-run contacte le service de préproduction (staging) et peut temporairement ajuster et recharger le serveur web. Sauvegardez d'abord la configuration du site concerné. Si nginx -t ou la validation en préproduction échoue, arrêtez et corrigez avant de tenter la délivrance en production ; les commandes suivantes ne sont pas un lot à exécuter après une erreur.
Ci-dessous se trouve une commande conditionnelle appliquée à un site Nginx déjà préparé. Saisissez le domaine que vous contrôlez et une adresse e-mail de contact, et sauvegardez d'abord les paramètres sur le serveur réel. --dry-run tente une vérification sur le serveur de préproduction, donc il n’est pas nécessaire de l’exécuter sur une VM sans conditions externes.
read -r -p "Real domain you control: " domain
read -r -p "Certificate contact email: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos
Les certificats de préproduction ne sont pas reconnus par les clients généraux. En suivant les instructions de préproduction de Let's Encrypt, résolvez d'abord les erreurs de validation, puis poursuivez l'émission en production. Même si l'exécution à blanc réussit, le certificat de production n'est pas sauvegardé. Dans des conditions normales, la commande suivante émet un certificat de production et modifie la configuration Nginx, donc les modifications doivent être examinées.
sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"
Vérifiez le nom du certificat et le chemin dans le répertoire live à partir de la sortie de certbot certificates. Nginx doit être lié avec fullchain.pem contenant le certificat du serveur et les certificats intermédiaires requis, ainsi que le privkey.pem correspondant. Ne terminez pas la vérification en vous contentant de confirmer que les fichiers existent ; vérifiez la réponse HTTPS externe et confirmez le nom, l'émetteur et la date d'expiration du certificat fourni.
La vérification du renouvellement opérationnel est effectuée avec sudo certbot renew --dry-run. L'aide de la version 4.0.0 installée indique que les hooks de déploiement ne sont pas exécutés lors du dry-run par défaut et que --run-deploy-hooks doit être ajouté. Si vous avez configuré vos propres hooks de déploiement en plus de la réapplication gérée par le plugin Nginx, examinez les cibles et le rechargement en double, et des tests incluant les hooks devraient être effectués dans le cadre de la maintenance.
certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager
Le résultat de la fin sans aucune action parce qu'il n'y a rien à renouveler n'est pas une preuve d'un renouvellement réussi. Tout d'abord, vérifiez s'il existe réellement des certificats en cours de gestion, et enregistrez séparément les résultats du renouvellement, les résultats du déploiement, et les certificats des nouvelles connexions aux moments requis. Pour la signification des plugins et des hooks, référez-vous au Guide officiel d'utilisation de Certbot , mais privilégiez la vérification de l'aide de la version installée et de la configuration réelle.
Supprimer uniquement le laboratoire TLS local
Les lecteurs qui ont configuré les paramètres publics de Certbot ne doivent pas appliquer cette section de nettoyage aux sites publics. Le bloc ci-dessous supprime le lien pour lf-tls26 créé précédemment, puis vérifie et recharge, et ne supprime la clé, le certificat et le dossier dédiés que si l'écouteur 8443 a disparu. Comme le magasin de confiance n'a pas été modifié, il n'est pas nécessaire de supprimer non plus la CA du système.
sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT
Sur la VM de vérification, les sites HTTPS dédiés, les clés, les CA et les scripts de déploiement ont été supprimés, et le hash de la configuration Nginx par défaut originale a été conservé. Le paquet Certbot et les temporisateurs actifs ont été conservés, mais il n'y avait pas de certificats gérés. Cet état n'est pas considéré comme équivalent à l'opération de renouvellement automatique des certificats publics.




