Aller au contenu
local-cert

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

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/directory avec 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:issue ou cert:export sur 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.

  1. 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.

  2. 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é.

  3. 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.

  4. 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

  1. 1L'hôte demande un certificat (API ou ACME).
  2. 2local-cert publie l’enregistrement TXT du challenge.
  3. 3Il interroge les serveurs de noms autoritatifs de la zone — pas un résolveur qui met en cache — jusqu'à ce que tous répondent.
  4. 4Let's Encrypt vérifie l'enregistrement et émet le certificat.
  5. 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.

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ôteUn wildcard
Enregistrement A public vers l’IP privéeOuiNon
CertificatsUn par sous-domaineUn *.home.example.com partagé
Rate limit Let’s EncryptAtteint au-delà de ~40 hôtesUn seul ordre
Topologie interne visible dans le DNS publicOuiNon
RévocationPar hôteTout 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-cert rend la propriété vérifiable par un simple dig.
docker-compose.yml, abrégé
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.