Préparer un identifiant Google Cloud
01En bref #sec_ca35eb77
REVIEWIT collecte une organisation Google Cloud par un compte de service dédié . Ce compte de service reçoit un rôle personnalisé de lecture sur le nœud de l'organisation : dossiers et projets en héritent. Tout est en lecture : REVIEWIT ne lit jamais la valeur d'un secret, le contenu d'un objet ni les données d'une table.
REVIEWIT agit sous ce compte de service de deux façons, au choix :
- sans clé (recommandé) : votre organisation fait confiance à cette connexion seulement , par la fédération d'identité de charge de travail. REVIEWIT signe un jeton court avec une clé qui ne quitte jamais son coffre. Aucun secret à créer, à confier ni à renouveler, et aucune exception à la politique qui interdit les clés ;
- avec une clé : vous créez une clé JSON du compte de service et la collez dans REVIEWIT.
Ce qu'il faut accorder dépend des ressources que vous voulez collecter. Deux chemins, le même résultat :
- l'étape Préparer de l'assistant de connexion rend le rôle exact des ressources que vous cochez, et les commandes gcloud qui le posent ;
- le script Cloud Shell ci-dessous pose le rôle de tout le catalogue Google Cloud , crée le compte de service et active les API de son projet.
021. Choisir le projet hôte #sec_91fcbbe4
REVIEWIT raccorde une organisation Google Cloud : un projet « sans organisation » n'est pas pris en charge. Le compte de service vit dans un projet hôte de votre choix, idéalement un projet dédié (par exemple reviewit-connector ) dans un dossier de sécurité.
Le projet hôte n'a besoin d' aucun compte de facturation : REVIEWIT y active seulement sept API d'organisation (Resource Manager, Service Usage, IAM, Org Policy, Cloud Billing, Recommender, Privileged Access Manager), qui s'activent sans facturation. Les lectures d'un projet sont comptées sur ce projet : un projet qui contient des ressources a déjà les API correspondantes.
032. Lancer le script #sec_dcebd435
Ouvrez Cloud Shell avec un compte qui détient, sur l'organisation, les rôles Administrateur de l'organisation et Administrateur des rôles d'organisation (un super-administrateur Google Workspace ne les a pas d'office : il peut se les accorder dans IAM et administration › IAM ), déposez-y le script, puis :
HOST_PROJECT=reviewit-connector bash reviewit-gcp-setup.sh
Le script, dans l'ordre :
- active les sept API d'organisation dans le projet hôte ;
- crée (ou met à jour) le rôle personnalisé REVIEWIT_Read sur l'organisation ;
- crée le compte de service reviewit-collector dans le projet hôte ;
- lui accorde le rôle sur le nœud de l'organisation.
Il ne crée aucune clé et ne touche à aucune politique d'organisation sans que vous le demandiez (section 3 b). Relancez-le après une évolution du catalogue : il met le rôle à jour.
043. Choisir la méthode #sec_0afbfc3f
a. Sans clé (recommandé)
Dans l'assistant de connexion, étape Identifiant , choisissez Sans clé (fédération) , puis Générer la clé de cette connexion . REVIEWIT fait naître la clé dans son coffre et vous rend sa partie publique. Copiez les commandes Cloud Shell et lancez-les dans Cloud Shell, après le script de la section 2. Il faut être propriétaire du projet hôte, ou détenir les rôles Administrateur de pools d'identités de charge de travail et Administrateur de comptes de service .
Ces commandes, dans l'ordre :
- activent deux API dans le projet hôte ( sts , iamcredentials ) ;
- créent le pool d'identités reviewit , s'il n'existe pas encore ;
- y créent un fournisseur OIDC propre à cette connexion : il connaît la clé publique de REVIEWIT et n'admet que le sujet de cette connexion ;
- autorisent ce seul sujet à agir en tant que reviewit-collector (rôle Utilisateur Workload Identity ).
Elles affichent pour finir le compte de service et le fournisseur à reporter dans l'assistant (section 4). Une autre connexion REVIEWIT, même du même client, n'ouvre jamais cette organisation : elle a sa propre clé et son propre sujet.
b. Avec une clé
Les organisations créées depuis 2024 interdisent par défaut la création de clés de compte de service (politique d'organisation Disable service account key creation , appliquée d'office). C'est une bonne pratique : une clé est un secret de longue durée. C'est pourquoi la connexion sans clé est recommandée.
Pour la connexion par clé, levez l'interdiction sur le seul projet hôte , puis créez la clé :
HOST_PROJECT=reviewit-connector ALLOW_KEY_EXCEPTION=yes CREATE_KEY=yes bash reviewit-gcp-setup.sh
Il faut pour cela le rôle d'administrateur des règles d'administration ( roles/orgpolicy.policyAdmin ). Une règle levée met une à quelques minutes à s'appliquer : pendant ce délai, Google refuse la clé ( CUSTOM_ORG_POLICY_VIOLATION ) et le script réessaie seul. Le script écrit reviewit-collector-key.json : collez son contenu dans REVIEWIT (section 4), puis supprimez le fichier .
054. Déclarer et vérifier #sec_05593f95
Revenez à l'assistant, étape Identifiant :
- sans clé : reportez le compte de service et le fournisseur ( projects/…/workloadIdentityPools/reviewit/providers/… ) que les commandes ont affichés ;
- avec une clé : collez la clé JSON .
Si vous nommez vos propriétaires par un autre libellé que owner , indiquez sa clé. Puis Vérifier . Il n'y a pas d'identifiant d'organisation à saisir : REVIEWIT le découvre.
REVIEWIT obtient l'accès du compte de service, découvre l'organisation ( organizations/… ), voit des projets, puis demande à Google, permission par permission , ce que le compte de service a le droit de faire sur l'organisation — héritage et rôles personnalisés compris. Il affiche le verdict de chaque ressource, et nomme les API encore à activer dans le projet hôte ; ce qui manque ramène à l'étape Préparer . Sans clé, un refus nomme l'étape en cause : le fournisseur qui refuse le jeton (relancez les commandes), ou le droit d'agir en tant que compte de service qui manque. Google met une à deux minutes à appliquer ce droit : une vérification lancée juste après les commandes peut être refusée pour cette raison ; relancez-la deux minutes plus tard.
Une clé est gardée dans le coffre de REVIEWIT, jamais en clair ; vous pouvez aussi la confier à SEAL , qui signe à sa place sans jamais la rendre. Pour la renouveler, créez une nouvelle clé, mettez à jour l'identifiant dans REVIEWIT, puis supprimez l'ancienne. Sans clé, il n'y a rien à renouveler.
06Qui répond d'une ressource #sec_f86c62c9
REVIEWIT lit le propriétaire dans le libellé que vous choisissez ( owner par défaut) : sur la ressource d'abord, puis sur son projet. Une valeur de libellé n'admet ni « @ » ni « . » : indiquez la partie locale de l'adresse ( marie-dupont pour marie-dupont@votre-domaine) ; REVIEWIT la résout dans les domaines de votre organisation. Sans libellé, ce sont les détenteurs directs du rôle Owner du projet ; sinon, la ressource est signalée orpheline .
07Ce que REVIEWIT ne fait jamais #sec_6e5ae848
- Il ne déploie rien et ne s'accorde aucun droit : votre administrateur lance le script ou pose le rôle.
- Il ne lit ni la valeur d'un secret ( secretmanager.versions.access ), ni le contenu d'un objet ( storage.objects.get ), ni les données d'une table ( bigquery.tables.getData ) : aucune de ces permissions n'est demandée.
- Il n' exige pas Cloud Asset Inventory : s'il est activé, REVIEWIT s'en sert pour énumérer plus vite ; sinon, rien ne change.
08Pour aller plus loin #sec_06d33e2c
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict