Provider Google Cloud
local-cert pilote Cloud DNS en tant que compte de service, à partir de sa clé JSON. Un provider correspond à un projet Google Cloud.
Avant de commencer
- L'API Cloud DNS est activée sur le projet (API et services → Bibliothèque → Cloud DNS API).
- La zone est publique. Une zone privée est invisible pour Let's Encrypt.
1. Créer le compte de service
- Console Google Cloud, projet qui contient vos zones → IAM et administration → Comptes de service → Créer un compte de service.
- Nom :
local-cert-dns. Créer et continuer. - Rôle : Administrateur DNS (
roles/dns.admin). Continuer, puis OK.
Ou en ligne de commande :
gcloud
PROJECT=mon-projet
gcloud iam service-accounts create local-cert-dns --project "$PROJECT"
gcloud projects add-iam-policy-binding "$PROJECT" \
--member "serviceAccount:local-cert-dns@$PROJECT.iam.gserviceaccount.com" \
--role roles/dns.admin2. Créer la clé JSON
- Ouvrez le compte de service → onglet Clés → Ajouter une clé → Créer une clé → JSON.
- Un fichier
.jsonest téléchargé : c'est le seul exemplaire.
gcloud
gcloud iam service-accounts keys create local-cert-dns.json \
--iam-account "local-cert-dns@$PROJECT.iam.gserviceaccount.com"3. Créer le provider
- Providers → + nouveau provider → Google Cloud.
- Donnez un nom et collez tout le contenu du fichier JSON. L'ID du projet est lu dans la clé ; ne le renseignez que si les zones sont dans un autre projet.
- Tester la connexion, puis Enregistrer. Supprimez ensuite le fichier téléchargé.
4. Ajouter un domaine
Domaines → + ajouter un domaine → ce provider → la zone. Le test crée puis supprime un enregistrement TXT temporaire.
À savoir
- Le rôle
roles/dns.adminporte sur toutes les zones du projet. Pour isoler une zone, placez-la dans un projet dédié, ou accordez le rôle au niveau de la zone plutôt que du projet (IAM de la zone gérée) en conservant au compteroles/dns.readersur le projet pour la liste. - Le domaine doit être délégué aux serveurs de noms indiqués par Cloud DNS pour la zone (
ns-cloud-*.googledomains.com). - Plusieurs projets : un provider par projet, chacun avec son compte de service — ou un seul compte de service auquel chaque projet accorde le rôle, déclaré en autant de providers avec des ID de projet différents.
Dépannage
| Message | Cause |
|---|---|
invalid_grant | Clé supprimée ou compte de service désactivé ; horloge du serveur déréglée. |
403 … Cloud DNS API has not been used | L'API Cloud DNS n'est pas activée sur le projet. |
403 Forbidden | Le compte de service n'a pas le rôle DNS sur ce projet. |
The service account key is not valid JSON | Le fichier a été collé partiellement. |