Aller au contenu
local-cert
Parcourir la documentation

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-01le configurer avec les trois valeurs de l'identifiant EAB, comme dans Serveur ACME
donne un accès shellacme.sh et un hook de déploiement — voir certbot, acme.sh, lego
ne sait qu'importer un certificat, ou seulement faire du DNS-01l'API de local-cert, ci-dessous

Repères par système

SystèmeApproche
OPNsenseGreffon 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.
pfSensePaquet 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.
TrueNASSon 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éseauImport de certificat : API de local-cert.
Zoraxy, SWAG, proxys basés sur lego ou certbotS'ils exposent l'URL de CA et l'EAB, cas générique. Sinon, import.
Envoy, proxys sans client ACMEacme.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
fi

Plutô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.