Aller au contenu
local-cert
Parcourir la documentation

Démarrage rapide

local-cert obtient des certificats Let's Encrypt pour des machines qui ne sont pas joignables depuis Internet : NAS, hyperviseurs, services internes. La validation passe par le DNS (DNS-01), donc seul local-cert a besoin d'un accès à votre zone.

Le chemin complet

  1. Déclarer un provider DNS. C'est le compte chez l'hébergeur de votre zone, avec ses identifiants : AWS, OVHcloud, Gandi, GoDaddy ou Google Cloud. Page Providers, guides Providers DNS.
  2. Ajouter un domaine. Vous choisissez une zone du provider, local-cert génère la politique IAM à coller, teste les droits, puis enregistre. Page Domaines, guide Ajouter un domaine.
  3. Donner un accès. Dans Clés & droits, créez selon le besoin une clé d'API (scripts, agents) ou un identifiant EAB (clients ACME : Traefik, Caddy, certbot…).
  4. Émettre. Par le serveur ACME ou par l'API — voir ci-dessous.

Quelle voie choisir

Serveur ACMEAPI REST
Pourun reverse proxy ou un outil qui sait déjà parler ACMEun script, un outil sans ACME, un agent (MCP)
Accèsidentifiant EABclé d'API
Clé privéegénérée et gardée par le clientgénérée par local-cert, chiffrée en base
Renouvellementpar le clientpar local-cert (auto_renew)

Voie ACME, en une commande

Avec un identifiant EAB autorisé sur le domaine, n'importe quel client ACME obtient un certificat. Exemple avec certbot :

certbot
certbot certonly --standalone -d nas.home.example.com \
  --server https://certs.example.com/acme/directory \
  --eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC

Le fonctionnement et les guides par outil sont dans Serveur ACME.

Voie API, en une requête

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,
    "dns": { "create_record": true, "target_ip": "192.168.1.50" }
  }'

La réponse est immédiate (202) ; l'émission prend une à trois minutes. Toutes les routes sont décrites dans API.

Les exemples utilisent https://certs.example.com comme adresse de votre instance : remplacez-la par la vôtre. La page Docs de votre console affiche chaque guide avec vos propres URLs.