Aller au contenu
local-cert
Parcourir la documentation

Apache httpd

Le module mod_md, livré avec Apache 2.4, gère ACME directement dans le serveur. L'EAB est pris en charge à partir d'Apache 2.4.52.

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

1. Activer les modules

Debian / Ubuntu
a2enmod md ssl && systemctl restart apache2

2. Configurer

/etc/apache2/conf-available/local-cert.conf
MDCertificateAuthority   https://certs.example.com/acme/directory
MDCertificateAgreement   accepted
MDContactEmail           ops@example.com
MDExternalAccountBinding eab_XXXXXXXXXXXXXXXX CLE_HMAC
MDCAChallenges           http-01

MDomain nas.home.example.com

<VirtualHost *:443>
    ServerName nas.home.example.com
    SSLEngine on
    # pas de SSLCertificateFile : mod_md fournit le certificat
    ProxyPass        / http://192.168.1.50:5000/
    ProxyPassReverse / http://192.168.1.50:5000/
</VirtualHost>

<VirtualHost *:80>
    ServerName nas.home.example.com
</VirtualHost>
activer
a2enconf local-cert && systemctl reload apache2

3. Laisser faire, puis recharger

mod_md obtient le certificat en arrière-plan, puis attend un rechargement pour l'activer. Suivez l'avancement dans le journal d'erreurs ; quand il annonce que le certificat est prêt :

recharger
systemctl reload apache2

Les renouvellements suivent le même schéma : obtention automatique, activation au rechargement suivant. Un rechargement quotidien par cron suffit.

À savoir

  • Pour ne pas écrire la clé HMAC dans la configuration, MDExternalAccountBinding accepte aussi le chemin d'un fichier JSON {"kid": "…", "hmac": "…"}, lisible par root uniquement.
  • Si mod_md gère déjà des domaines publics chez Let's Encrypt, placez ces directives dans un bloc <MDomain nas.home.example.com> … </MDomain> pour ne les appliquer qu'aux noms internes.