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
- 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.
- 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.
- 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…).
- Émettre. Par le serveur ACME ou par l'API — voir ci-dessous.
Quelle voie choisir
| Serveur ACME | API REST | |
|---|---|---|
| Pour | un reverse proxy ou un outil qui sait déjà parler ACME | un script, un outil sans ACME, un agent (MCP) |
| Accès | identifiant EAB | clé d'API |
| Clé privée | générée et gardée par le client | générée par local-cert, chiffrée en base |
| Renouvellement | par le client | par 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_HMACLe 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.