Aller au contenu
local-cert
Parcourir la documentation

Exploitation

Comment une émission passe par le DNS, comment choisir entre un certificat par hôte et un wildcard, comment supprimer et récupérer quand une zone n'est plus accessible, et les limites connues.

Fonctionnement du DNS-01

  1. Création de l'ordre ACME, récupération du token de challenge.
  2. UPSERT du TXT _acme-challenge.<fqdn> dans Route53, TTL 60.
  3. Attente de INSYNC sur le ChangeId Route53.
  4. Puis interrogation directe des NS autoritatifs de la zone jusqu'à ce que tous voient le TXT. Pas 8.8.8.8 : un résolveur récursif met en cache les réponses négatives et mentira pendant tout le TTL.
  5. Notification à l'ACME, validation, finalize CSR, download.
  6. Suppression du TXT — y compris en cas d'échec (finally). Un _acme-challenge orphelin casse la tentative suivante.

Le renouvellement automatique se déclenche à not_after - renew_before_days, avec un jitter déterministe de ±24 h par certificat pour éviter qu'un parc entier ne tape Let's Encrypt à la même heure.

Deux stratégies possibles

A — un cert par hôteB — un wildcard
Enregistrement A public vers l'IP privéeouinon
Certificats1 par sous-domaine*.home.example.com partagé
Rate limit LEatteint vite au-delà de ~40 hôtes1 seul ordre
Topologie interne exposée dans le DNS publicouinon
Révocationpar hôtetout ou rien

A est plus simple et plus granulaire. Passez à B au-delà de quelques hôtes, ou si publier vos IP privées dans une zone publique vous dérange. Les deux sont supportés : cochez Wildcard dans la console.

Suppression et récupération

Le cas qui compte : la zone Route53 n'est plus accessible (rôle révoqué, zone supprimée, credentials périmés) et il faut quand même pouvoir nettoyer la base.

Rien ne bloque sur une erreur d'API externe. Supprimer un certificat révoque au mieux auprès de la CA et nettoie au mieux la zone : si l'un des deux échoue, la ligne est quand même supprimée et ce qui reste publié est renvoyé dans warnings.

shell
curl -X DELETE "https://certs.example.com/api/v1/certificates/$ID?purge=true" \
  -H "Authorization: Bearer $TOKEN"
réponse
{
  "id": "cert_…",
  "status": "deleted",
  "warnings": [
    "Could not remove A nas.home.example.com -> 192.168.1.50 from Route53: No hosted zone found with ID: ZINACCESSIBLE. The record is still published — delete it by hand."
  ]
}

Un domaine ne peut pas partir tant qu'un certificat le référence. certificates.domain_id est en ON DELETE RESTRICT : toute ligne restante épingle le domaine — révoquée, en échec ou expirée, pas seulement les actives. Le refus est explicite et chiffré :

409
{
  "type": "conflict",
  "title": "Domain still has 3 certificate(s) (1 active). Delete them first, or repeat with ?force=true to remove them along with the domain.",
  "detail": { "certificates": 3, "active": 1, "by_status": { "issued": 1, "failed": 1, "expired": 1 } }
}

?force=true fait la cascade explicitement : révocation CA au mieux, nettoyage de zone au mieux, puis suppression des certificats et du domaine dans une seule transaction. Les certificate_events et les grants suivent par cascade SQL.

shell
curl -X DELETE "https://certs.example.com/api/admin/domains/$ID?force=true" -b cookies.txt

Dans la console, retirer affiche le décompte en cas de refus et remplace le bouton par forcer (N). Les enregistrements laissés en place dans la zone sont listés en avertissement après coup.

Serveur ACME : à savoir

La description complète du point d'accès ACME est dans Serveur ACME. Les points d'exploitation :

  • Le client signe l'URL exacte qu'il appelle. Derrière un reverse proxy, soit celui-ci transmet X-Forwarded-Proto / X-Forwarded-Host, soit vous fixez PUBLIC_URL. Une erreur JWS "url" is … but this endpoint is … vient de là.
  • La validation DNS prend une à trois minutes ; le client attend sur son challenge pendant ce temps.
  • Ces certificats apparaissent dans la console (key_type: external) sans clé privée ni renouvellement automatique : la clé reste chez le client, qui renouvelle lui-même. POST …/renew les refuse.
  • Révocation ACME (revoke-cert) : un compte peut révoquer les certificats qu'il a lui-même obtenus.
  • Non implémenté : keyChange (rotation de clé de compte) et la révocation signée par la clé du certificat.

Limites connues

  • Tous les SAN d'un même ordre doivent appartenir à une seule zone gérée.
  • Pas de compteur de rate limit Let's Encrypt côté application : un parc important peut se faire refuser par la CA. À ajouter si vous dépassez ~40 certificats par semaine et par domaine enregistré.
  • Le format d'export PKCS#12 n'est pas implémenté (JSON et PEM seulement).
  • Les marqueurs de provenance doublent le nombre d'enregistrements créés dans la zone (un TXT par nom). C'est le prix de la propriété interrogeable, faute de tags sur les record sets ; TAG_RECORDS=0 si vous préférez une zone épurée.
  • Pas de rotation de MASTER_KEY : la changer rend illisibles les clés privées déjà stockées. Un renouvellement les régénère.
  • Un seul compte administrateur, créé au setup. Pas de gestion multi-utilisateurs ni de changement de mot de passe depuis la console — la rotation passe par scripts/reset-admin.ts.