Christophe CasalegnoAutoimmune warrior, Entrepreneur & Bio/Hacker

SxSSL : génération automatique en Bash de certificats Let’s Encrypt pour Apache

SxSSL : StackX SSL

SxSSL 0.6 est un script Bash sous licence GPL qui demande, installe et vérifie des certificats TLS Let’s Encrypt pour Apache. Il est conçu pour nos serveurs StackX, mais reste utilisable ailleurs à condition d’adapter explicitement les IP autorisées et les chemins du serveur.

Le principe est simple : avant de laisser Certbot agir, SxSSL vérifie que chaque nom demandé résout bien vers une IPv4 ou une IPv6 autorisée. Après l’émission, il ne se contente pas d’un code retour heureux : il contrôle la couverture des domaines, la validité du certificat, la correspondance entre la clé privée et le certificat, puis la configuration Apache concernée.

Fonctionnalités principales

– Un ou plusieurs FQDN, séparés par des virgules.
– Validation stricte des noms, des IPv4 et des IPv6.
– Refus de l’opération si le DNS est absent, illisible ou pointe vers une adresse non autorisée.
– Mode --expand pour étendre un certificat existant.
– Mode --certonly pour obtenir un certificat par webroot sans installation dans Apache.
– Contrôle OpenSSL local de l’usage serveur, des dates, de la clé et des noms couverts.
– Ajout atomique de HTTP/2 dans les vhosts Certbot concernés, suivi d’un test de configuration et d’un rechargement Apache.

Pré-requis

Le script s’exécute en root et utilise notamment certbot, host, python3 et openssl. Le mode normal attend Apache et son plugin Certbot. Le mode --certonly utilise le webroot /home/letsencrypt et n’installe rien dans Apache.

Configuration

L’adresse de contact Certbot peut être fournie avec SXSSL_EMAIL. Les IP autorisées se définissent avec SXSSL_IPS :

export SXSSL_EMAIL="admin@example.net"
export SXSSL_IPS="192.0.2.10,2001:db8::10"

Dans un environnement StackX, SxSSL peut aussi lire host_ip et vip dans /root/SX/.sx. En dernier recours, il tente de détecter l’adresse locale avec hostname -I. Pour un usage extérieur à StackX, je recommande de fournir SXSSL_EMAIL et SXSSL_IPS explicitement plutôt que de compter sur une détection implicite.

Installation et utilisation

cp sxssl.sh /usr/local/bin/sxssl
chmod +x /usr/local/bin/sxssl

sxssl domaine.tld
sxssl domaine.tld,www.domaine.tld
sxssl domaine.tld,www.domaine.tld --expand
sxssl domaine.tld --certonly

Attention : --certonly accepte un seul nom et ne peut pas être combiné avec --expand. SxSSL refuse également de poursuivre lorsque la validation DNS n’est pas concluante. C’est volontaire : générer un certificat à moitié au hasard n’est pas une stratégie d’administration système.

Ressources

Script : sxssl.sh

—
Christophe Casalegno (retrouvez tous mes réseaux sur : all.bo)

Christophe Casalegno Brain 0verride

Soyez simple
et direct !