Aller au contenu
local-cert
Parcourir la documentation

Providers DNS

Un provider est un compte chez l'hébergeur de vos zones DNS, avec les identifiants qui permettent à local-cert d'y écrire. C'est par là que passe la preuve demandée par Let's Encrypt : un enregistrement TXT posé le temps de la validation.

Hébergeurs pris en charge

HébergeurServiceIdentifiantsTTL minimalGuide
AWSRoute53clé IAM, rôle conseillé30 souvrir
OVHcloudzones DNS OVHcloudRégion de l’API, Application key, Application secret, Consumer key60 souvrir
GandiLiveDNSPersonal Access Token300 souvrir
GoDaddyDNS GoDaddyAPI key, API secret600 souvrir
Google CloudCloud DNSClé du compte de service (JSON)1 souvrir

Le principe, quel que soit l'hébergeur

  1. Vous créez chez l'hébergeur des identifiants limités au DNS — jamais ceux de votre compte principal.
  2. Providers → + nouveau provider : vous choisissez l'hébergeur, collez les identifiants, testez, enregistrez.
  3. Domaines → + ajouter un domaine : local-cert liste les zones du compte, vous en choisissez une, il teste ses droits.

Plusieurs providers du même hébergeur sont le cas normal : un par compte, ou un par périmètre de droits. Les secrets sont chiffrés en base (AES-256-GCM avec MASTER_KEY) et ne sont jamais réaffichés ni renvoyés par l'API.

Ce qui diffère d'un hébergeur à l'autre

AWS Route53Les autres
Droitspar zone : une politique IAM à faire évoluer à chaque domaine ajoutéportés par les identifiants : rien à modifier quand on ajoute un domaine
Test des droitssans aucune écriture dans la zoneun enregistrement TXT temporaire (_localcert-preflight-…) est créé puis supprimé
Écrituresatomiques, suivies jusqu'à propagationenregistrement par enregistrement

Marquage de ce que local-cert crée

Chaque enregistrement publié à votre demande est accompagné d'un TXT _local-cert.<nom> : c'est ce qui permet de distinguer, dans la zone, ce qui vient de local-cert de ce qui existait déjà. La variable TAG_RECORDS=0 le désactive.

Déclarer un provider par variables d'environnement

Quand les identifiants doivent venir du déploiement plutôt que de la base, un provider se déclare par variables. C'est facultatif, et le bloc se répète avec un autre libellé pour chaque compte.

.env
# PROVIDER_<HÉBERGEUR>_<LIBELLÉ>_NAME déclare le provider ; le reste, ses identifiants
PROVIDER_AWS_DEFAULT_NAME="Default AWS"
PROVIDER_AWS_DEFAULT_ACCESS_KEY_ID=AKIA…
PROVIDER_AWS_DEFAULT_SECRET_ACCESS_KEY=…
PROVIDER_AWS_DEFAULT_ROLE_ARN=arn:aws:iam::123456789012:role/local-cert-dns

PROVIDER_OVH_PERSO_NAME="ovh-perso"
PROVIDER_OVH_PERSO_ENDPOINT=ovh-eu
PROVIDER_OVH_PERSO_APPLICATION_KEY=…
PROVIDER_OVH_PERSO_APPLICATION_SECRET=…
PROVIDER_OVH_PERSO_CONSUMER_KEY=…

PROVIDER_GANDI_MAIN_NAME="gandi"
PROVIDER_GANDI_MAIN_TOKEN=…

PROVIDER_GODADDY_MAIN_NAME="godaddy"
PROVIDER_GODADDY_MAIN_API_KEY=…
PROVIDER_GODADDY_MAIN_API_SECRET=…

PROVIDER_GCP_MAIN_NAME="gcp"
PROVIDER_GCP_MAIN_SERVICE_ACCOUNT_JSON=<le JSON de la clé, ou son encodage base64>
PROVIDER_GCP_MAIN_PROJECT_ID=mon-projet   # facultatif
  • Le libellé (DEFAULT, PERSO, MAIN…) est libre : lettres majuscules, chiffres et tirets bas.
  • Ces providers apparaissent dans la console avec la mention environnement. On peut les tester, mais pas les modifier ni les retirer : cela se fait dans les variables, suivi d'un redémarrage. Leurs secrets ne sont jamais écrits en base.
  • Une déclaration incomplète est ignorée, avec un message au démarrage qui nomme la variable manquante.