Autres systèmes
Deux recettes couvrent tout ce qui n'a pas son propre guide : un client ACME générique quand le système en accepte un, l'API de local-cert quand il ne sait qu'importer un certificat.
Reconnaître le bon cas
| Le système… | Recette |
|---|---|
| a un client ACME avec URL de CA personnalisée, EAB et HTTP-01 | le configurer avec les trois valeurs de l'identifiant EAB, comme dans Serveur ACME |
| donne un accès shell | acme.sh et un hook de déploiement — voir certbot, acme.sh, lego |
| ne sait qu'importer un certificat, ou seulement faire du DNS-01 | l'API de local-cert, ci-dessous |
Repères par système
| Système | Approche |
|---|---|
| OPNsense | Greffon os-acme-client : créez un compte sur une CA personnalisée avec l'URL du directory et les champs EAB, puis un certificat en challenge HTTP-01. Le greffon s'appuie sur acme.sh. |
| pfSense | Paquet ACME : si votre version propose un serveur ACME personnalisé avec EAB, même démarche. Sinon, acme.sh en shell puis import dans System → Certificates. |
| TrueNAS | Son client ACME ne fait que du DNS-01 avec ses propres fournisseurs : utilisez l'API de local-cert, puis importez le certificat. |
| Unraid, UniFi, imprimantes, iDRAC/iLO, équipements réseau | Import de certificat : API de local-cert. |
| Zoraxy, SWAG, proxys basés sur lego ou certbot | S'ils exposent l'URL de CA et l'EAB, cas générique. Sinon, import. |
| Envoy, proxys sans client ACME | acme.sh ou lego à côté, fichiers montés dans le proxy, rechargement en hook. |
Recette API : local-cert garde la clé et renouvelle
Ici le système cible ne parle pas à local-cert. C'est local-cert qui génère la clé, obtient le certificat, le renouvelle, et un script vient chercher la version à jour. Il faut une clé d'API (Clés & droits) avec les droits cert:issue, cert:read et cert:export sur le domaine.
1. Demander le certificat, une fois
curl
curl -X POST https://certs.example.com/api/v1/certificates \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'content-type: application/json' \
-d '{"domains": ["nas.home.example.com"], "key_type": "ec-256", "auto_renew": true}'
# → { "id": "cert_…", "status": "pending", … }2. Récupérer certificat et clé, à chaque passage
script planifié (cron, quotidien)
#!/bin/sh
set -eu
ID=cert_XXXXXXXXXXXXXXXX
OUT=/etc/ssl/local-cert
curl -fsS -H "Authorization: Bearer $TOKEN" \
"https://certs.example.com/api/v1/certificates/$ID/bundle?format=pem&include=fullchain" \
-o "$OUT/fullchain.pem.new"
curl -fsS -H "Authorization: Bearer $TOKEN" \
"https://certs.example.com/api/v1/certificates/$ID/bundle?format=pem&include=key" \
-o "$OUT/privkey.pem.new"
# ne recharge que si le certificat a changé
if ! cmp -s "$OUT/fullchain.pem.new" "$OUT/fullchain.pem"; then
mv "$OUT/fullchain.pem.new" "$OUT/fullchain.pem"
mv "$OUT/privkey.pem.new" "$OUT/privkey.pem"
# ici : la commande d'import ou de rechargement du système cible
fiPlutôt que d'interroger chaque jour, la demande accepte un webhook_url appelé à chaque émission et renouvellement. Le détail des routes est dans API.