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
- 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. - Nom :
local-cert. Expiration : la plus longue que vous acceptez — à l'échéance, émissions et renouvellements s'arrêtent. - Ressources : restreignez aux domaines que local-cert doit gérer.
- Permissions : cochez Gérer la configuration technique des domaines. Les permissions de lecture associées se cochent d'elles-mêmes.
- Créer, puis copiez le token : il n'est affiché qu'une fois.
2. Créer le provider
- Providers → + nouveau provider → Gandi.
- Donnez un nom et collez le token.
- 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
| Message | Cause |
|---|---|
401 | Token mal recopié, expiré ou supprimé. |
403 | Le token ne porte pas la permission de configuration technique, ou le domaine n'est pas dans ses ressources. |
| La liste des zones est vide | Aucun domaine du périmètre du token n'utilise LiveDNS. |