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ébergeur | Service | Identifiants | TTL minimal | Guide |
|---|---|---|---|---|
| AWS | Route53 | clé IAM, rôle conseillé | 30 s | ouvrir |
| OVHcloud | zones DNS OVHcloud | Région de l’API, Application key, Application secret, Consumer key | 60 s | ouvrir |
| Gandi | LiveDNS | Personal Access Token | 300 s | ouvrir |
| GoDaddy | DNS GoDaddy | API key, API secret | 600 s | ouvrir |
| Google Cloud | Cloud DNS | Clé du compte de service (JSON) | 1 s | ouvrir |
Le principe, quel que soit l'hébergeur
- Vous créez chez l'hébergeur des identifiants limités au DNS — jamais ceux de votre compte principal.
- Providers → + nouveau provider : vous choisissez l'hébergeur, collez les identifiants, testez, enregistrez.
- 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 Route53 | Les autres | |
|---|---|---|
| Droits | par zone : une politique IAM à faire évoluer à chaque domaine ajouté | portés par les identifiants : rien à modifier quand on ajoute un domaine |
| Test des droits | sans aucune écriture dans la zone | un enregistrement TXT temporaire (_localcert-preflight-…) est créé puis supprimé |
| Écritures | atomiques, suivies jusqu'à propagation | enregistrement 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.
# 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.