Aller au contenu
local-cert
Parcourir la documentation

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

  1. Console Google Cloud, projet qui contient vos zones → IAM et administration → Comptes de service → Créer un compte de service.
  2. Nom : local-cert-dns. Créer et continuer.
  3. 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.admin

2. Créer la clé JSON

  1. Ouvrez le compte de service → onglet Clés → Ajouter une clé → Créer une clé → JSON.
  2. Un fichier .json est 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

  1. Providers → + nouveau provider → Google Cloud.
  2. 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.
  3. 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.admin porte 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 compte roles/dns.reader sur 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

MessageCause
invalid_grantClé supprimée ou compte de service désactivé ; horloge du serveur déréglée.
403 … Cloud DNS API has not been usedL'API Cloud DNS n'est pas activée sur le projet.
403 ForbiddenLe compte de service n'a pas le rôle DNS sur ce projet.
The service account key is not valid JSONLe fichier a été collé partiellement.