Aller au contenu
local-cert
Parcourir la documentation

Provider Gandi

local-cert pilote Gandi LiveDNS avec un Personal Access Token, que vous limitez aux domaines et aux droits strictement nécessaires.

1. Créer le token

  1. Dans Gandi : Organisations → l'organisation propriétaire des domaines → Partage → Personal Access Tokens → Créer un token. Adresse directe : https://admin.gandi.net/organizations/account/pat.
  2. Nom : local-cert. Expiration : la plus longue que vous acceptez — à l'échéance, émissions et renouvellements s'arrêtent.
  3. Ressources : restreignez aux domaines que local-cert doit gérer.
  4. Permissions : cochez Gérer la configuration technique des domaines. Les permissions de lecture associées se cochent d'elles-mêmes.
  5. Créer, puis copiez le token : il n'est affiché qu'une fois.

2. Créer le provider

  1. Providers → + nouveau provider → Gandi.
  2. Donnez un nom et collez le token.
  3. Tester la connexion, puis Enregistrer.

3. Ajouter un domaine

Domaines → + ajouter un domaine → ce provider → le domaine. Le test crée puis supprime un enregistrement TXT temporaire.

À savoir

  • Le domaine doit utiliser LiveDNS (serveurs ns-*.gandi.net). Un domaine enregistré chez Gandi mais servi par des serveurs de noms externes n'apparaît pas dans la liste.
  • TTL minimal : 300 secondes. local-cert relève toute valeur plus basse. Sans effet sur l'émission des certificats.
  • Pour changer de token à l'approche de son expiration : Providers → modifier, collez le nouveau, Tester, Enregistrer.

Dépannage

MessageCause
401Token mal recopié, expiré ou supprimé.
403Le token ne porte pas la permission de configuration technique, ou le domaine n'est pas dans ses ressources.
La liste des zones est videAucun domaine du périmètre du token n'utilise LiveDNS.