v0.5.0 · providers DNS, serveur ACME, console en six langues
Du HTTPS reconnu pour les machines qu’Internet ne voit pas
local-cert émet et renouvelle de vrais certificats Let's Encrypt pour vos NAS, hyperviseurs et services internes. La validation passe par le DNS : l'hôte en 192.168.1.50 n'est jamais exposé — et ne détient aucun identifiant DNS.
- Auto-hébergé, un seul conteneur
- SQLite ou Postgres
- Renouvellement automatique
Certificats
| Nom | Statut | Expire |
|---|---|---|
| nas.home.example.com | issued | 89 jours |
| pve.home.example.com | issued | 61 jours |
| *.lab.example.com | issued | 34 jours |
| grafana.lab.example.com | dns_propagating | — |
Événements en direct · grafana.lab.example.com
- 14:02:07Ordre créé chez Let’s Encrypt
- 14:02:08UPSERT TXT _acme-challenge, TTL 60
- 14:02:39Changement Route53 INSYNC
- 14:03:11Tous les NS autoritatifs voient le TXT
- 14:03:24Challenge valide — certificat émis
- 14:03:25Enregistrement TXT supprimé
Le problème
Votre réseau local mérite mieux qu’un avertissement du navigateur
D'habitude, Let's Encrypt vérifie que vous contrôlez un nom en appelant le serveur qui se trouve derrière. Un hôte en 192.168.x.x n'est pas joignable depuis Internet : HTTP-01 et TLS-ALPN-01 sont hors jeu.
Certificats auto-signés
Chaque appareil affiche un avertissement, tout le monde apprend à cliquer au travers, et personne ne remarque le jour où il compte vraiment.
Une CA privée à entretenir
Il faut installer votre racine sur chaque portable, téléphone et conteneur — et la garder secrète pour toujours.
Des clés DNS sur chaque machine
Faire tourner un client ACME en DNS-01 sur chaque hôte, c'est copier des identifiants capables de réécrire toute votre zone sur vos machines les moins bien patchées.
La solution
Un seul service détient l’accès DNS. Vos hôtes n’ont qu’à demander.
local-cert est le seul à toucher votre zone DNS. Il écrit l'enregistrement TXT _acme-challenge, attend que tous les serveurs de noms autoritatifs le voient, laisse Let's Encrypt valider, puis fait le ménage. Les hôtes reçoivent des clés d'API ou des identifiants ACME valables pour leur domaine, et rien d'autre.
- Des certificats publiquement reconnus — aucune racine à installer
- Rien de votre réseau local exposé sur Internet
- Identifiants DNS stockés une seule fois, chiffrés
Fonctionnalités
Tout ce qu’il faut à un parc d’hôtes internes
D'un simple home lab à des dizaines de services répartis sur plusieurs comptes DNS.
DNS-01 sur cinq hébergeurs
AWS Route53, OVHcloud, Gandi LiveDNS, GoDaddy et Google Cloud DNS. Plusieurs comptes par hébergeur, c’est le cas normal.
Un serveur ACME intégré
Pointez Traefik, Caddy, certbot, acme.sh, lego ou cert-manager vers
/acme/directoryavec un identifiant EAB. Ils gardent leur fonctionnement habituel.API REST avec OpenAPI 3.1
Émettre, renouveler, révoquer et télécharger des certificats. La spec est générée depuis les validateurs, et un explorateur dans la console envoie de vraies requêtes.
Serveur MCP pour agents IA
Les agents disposent des mêmes outils que l'API — mêmes scopes, même journal d'audit. Une clé ne peut rien faire de plus par MCP que par curl.
Des droits par domaine
Chaque clé porte des scopes comme
cert:issueoucert:exportsur des domaines précis. La clé du NAS ne peut pas émettre pour le serveur de build.Renouvellement en pilote automatique
Les certificats sont renouvelés avant expiration, avec un décalage déterministe de ±24 h pour que tout votre parc ne sollicite jamais Let's Encrypt à la même minute.
IAM au plus juste, généré
La console rédige la politique IAM de vos zones exactes, puis sonde les cinq appels Route53 nécessaires avant d'enregistrer un domaine.
Sûr par construction
Mots de passe en argon2id, clés privées chiffrées en AES-256-GCM, chaque mutation dans un journal d'audit, webhooks signés en HMAC-SHA256.
Suivi en direct
Chaque émission diffuse ses événements en direct : ordre, TXT publié, propagation, validation, nettoyage. Les échecs sont relancés avec un backoff exponentiel.
Fonctionnement
Du compte DNS au premier certificat, en quatre étapes
La console guide chaque étape, et sa documentation intégrée reprend les URLs de votre instance.
- 01
Déclarer un provider DNS
Le compte qui héberge votre zone. Pour AWS, un utilisateur IAM sans droits et un rôle qu'il peut assumer — l'assistant génère les deux politiques.
- 02
Ajouter un domaine
Choisissez une zone. local-cert vérifie qu'elle correspond à l'apex saisi et sonde chaque permission nécessaire. Rien n'est enregistré tant que ce n'est pas validé.
- 03
Donner les accès
Créez une clé d'API par hôte ou script, ou un identifiant EAB par client ACME, limité aux domaines qu'il doit toucher.
- 04
Émettre
Par le serveur ACME ou en un seul appel d'API. Suivez le journal en direct, téléchargez le PEM, et laissez le renouvellement faire le reste.
Sous le capot : une validation DNS-01
Votre hôte
nas.home.example.com · 192.168.1.50
local-cert
sur votre réseau
Hébergeur DNS
TXT _acme-challenge
Let's Encrypt
valide par le DNS
- 1L'hôte demande un certificat (API ou ACME).
- 2local-cert publie l’enregistrement TXT du challenge.
- 3Il interroge les serveurs de noms autoritatifs de la zone — pas un résolveur qui met en cache — jusqu'à ce que tous répondent.
- 4Let's Encrypt vérifie l'enregistrement et émet le certificat.
- 5Le TXT est supprimé, même en cas d’échec.
Intégrations
Avec le DNS que vous avez et les outils que vous utilisez
Chacun a son guide pas à pas dans la documentation.
Hébergeurs DNS
Identifiants stockés chiffrés, ou déclarés par variables d'environnement.
Reverse proxies, plateformes et clients
Tout ce qui parle ACME utilise le serveur intégré ; pour le reste, l'API ou un hook de déploiement.
Pour les développeurs
Trois portes d’entrée, un seul modèle de droits
Quelle que soit la porte empruntée, une requête est contrôlée avec les mêmes scopes par domaine et consignée dans le même journal d'audit.
POST /api/v1/certificates
curl -X POST https://certs.example.com/api/v1/certificates \
-H "Authorization: Bearer lc_…" \
-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" }
}'
# Follow the issuance live
curl -N -H "Authorization: Bearer lc_…" \
"https://certs.example.com/api/v1/certificates/$ID/events?stream=1"
202 Accepted immédiat ; suivez la progression en Server-Sent Events. Une Idempotency-Key évite qu'un retry client consomme un ordre Let's Encrypt pour rien.
traefik.yml
certificatesResolvers:
localcert:
acme:
caServer: https://certs.example.com/acme/directory
email: ops@example.com
storage: /letsencrypt/localcert.json
eab:
kid: eab_…
hmacEncoded: <hmac_key>
httpChallenge:
entryPoint: web
Traefik croit parler à une CA en HTTP-01. local-cert répond au challenge en DNS-01 à sa place.
POST /api/mcp
# Claude Code
claude mcp add --transport http local-cert \
https://certs.example.com/api/mcp \
--header "Authorization: Bearer lc_..."
# Then, in plain words:
# "Is grafana.lab.example.com taken? If not, issue a
# certificate for it pointing at 192.168.1.60."
Le serveur embarque ses propres skills : un agent apprend le cycle de vie d'un certificat et ses pièges avant d'appeler un outil.
Deux stratégies
Un certificat par hôte, ou un wildcard
Les deux sont supportées — cochez « Wildcard » dans la console.
| Un certificat par hôte | Un wildcard | |
|---|---|---|
| Enregistrement A public vers l’IP privée | Oui | Non |
| Certificats | Un par sous-domaine | Un *.home.example.com partagé |
| Rate limit Let’s Encrypt | Atteint au-delà de ~40 hôtes | Un seul ordre |
| Topologie interne visible dans le DNS public | Oui | Non |
| Révocation | Par hôte | Tout ou rien |
Un certificat par hôte est plus simple et plus granulaire. Passez au wildcard au-delà de quelques hôtes, ou si publier vos IP privées dans une zone publique vous dérange.
Auto-hébergé
Chez vous, selon vos règles
local-cert détient les clés privées de tout votre parc : sa place est sur une infrastructure que vous contrôlez.
- Un seul conteneur — le worker d'émission et le planificateur de renouvellement tournent dans le même processus.
- SQLite ou Postgres — un seul schéma, migrations appliquées au démarrage.
- Assistant de configuration — ou compte administrateur provisionné par variables d'environnement.
- Staging d'abord — l'environnement ACME suit
APP_ENV: le développement ne consomme jamais les quotas de production. - Chaque enregistrement marqué — un TXT
_local-certrend la propriété vérifiable par un simpledig.
services:
app:
build: .
ports: ['3000:3000']
environment:
MASTER_KEY: ${MASTER_KEY} # openssl rand -base64 32
JWT_SECRET: ${JWT_SECRET} # openssl rand -base64 48
ACME_EMAIL: ops@example.com
APP_ENV: production
volumes:
- certdata:/app/data
volumes:
certdata:FAQ
Vos questions, nos réponses
Qu’est-ce que local-cert ?
local-cert est un service auto-hébergé qui obtient et renouvelle des certificats Let's Encrypt publiquement reconnus pour les machines d'un réseau privé — NAS, hyperviseurs, applications internes — grâce au challenge DNS-01. Il centralise les identifiants DNS et délivre les certificats par une API REST, un serveur ACME intégré et un serveur MCP pour agents IA.
Quelle différence avec certbot ou acme.sh en DNS-01 sur chaque hôte ?
Ces clients ont besoin d'identifiants DNS sur chaque machine, et chacun peut en général réécrire toute la zone. Avec local-cert, les identifiants vivent dans un seul service, chaque hôte reçoit une clé limitée à son domaine, les renouvellements sont planifiés au même endroit et chaque émission figure dans un seul journal d'audit. Les clients ACME existants continuent de fonctionner : ils pointent vers local-cert au lieu de Let's Encrypt.
Mon hôte doit-il être joignable depuis Internet ?
Non. La validation passe par le DNS, pas par votre hôte. Seul local-cert a besoin d'un accès sortant à l'API de votre hébergeur DNS et à Let's Encrypt.
Quels hébergeurs DNS sont pris en charge ?
AWS Route53, OVHcloud, Gandi LiveDNS, GoDaddy et Google Cloud DNS. La zone de votre domaine doit être hébergée chez l’un d’eux ; plusieurs comptes par hébergeur sont possibles.
Ce sont de vrais certificats, publiquement reconnus ?
Oui. Ils sont émis par Let's Encrypt : tous les navigateurs et systèmes d'exploitation leur font confiance d'emblée. Aucun certificat racine à installer.
Dois-je publier mes IP privées dans le DNS public ?
Seulement si vous voulez que local-cert crée l'enregistrement A pour vous. Avec un certificat wildcard, rien de votre topologie interne n'apparaît dans la zone.
Traefik, Caddy ou cert-manager peuvent-ils l’utiliser sans modification ?
Oui. Ils pointent vers le directory ACME de local-cert avec un identifiant EAB, comme vers n'importe quelle CA. Leur challenge HTTP-01 est honoré en DNS-01 en coulisses.
Et les limites de Let’s Encrypt ?
La production autorise 50 certificats par domaine enregistré et par semaine. Les instances de développement utilisent l'environnement de staging par défaut, les renouvellements sont étalés, et un wildcard ne demande qu'un seul ordre.
Où sont stockées les clés privées ?
Dans votre base de données, chiffrées en AES-256-GCM. Elles ne sortent en clair que par l'endpoint de bundle, pour les clés dotées du scope cert:export — et chaque export est tracé.
Que se passe-t-il si mon compte DNS devient inaccessible ?
Rien ne reste bloqué. La suppression révoque et nettoie au mieux, efface la ligne quoi qu’il arrive, et vous indique les enregistrements à supprimer à la main.
Un cadenas sur chaque machine de la baie
Déployez local-cert, connectez votre compte DNS et émettez votre premier certificat en quelques minutes — sur staging d’abord.