Preparare un'identificazione Google Cloud
01In breve #sec_ca35eb77
REVIEWIT raccoglie un'organizzazione Google Cloud tramite un account di servizio dedicato. Questo account di servizio riceve un ruolo personalizzato di lettura sul nodo dell'organizzazione: le cartelle e i progetti ne ereditano. Tutto è in lettura: REVIEWIT non legge mai il valore di un segreto, il contenuto di un oggetto né i dati di una tabella.
REVIEWIT agisce sotto questo account di servizio in due modi, a scelta:
- senza chiave (consigliato): la vostra organizzazione si fida di questa connessione solo tramite la federazione d'identità del carico di lavoro. REVIEWIT firma un token breve con una chiave che non esce mai dal suo cofano. Nessun segreto da creare, affidare o rinnovare, e nessuna eccezione alla politica che vieta le chiavi;
- con una chiave: create una chiave JSON dell'account di servizio e incollatela in REVIEWIT.
Ciò che deve essere concesso dipende dalle risorse che volete raccogliere. Due percorsi, lo stesso risultato:
- il passaggio Preparare dell'assistente di connessione rende il ruolo esatto delle risorse che selezionate, e i comandi gcloud che lo impostano;
- lo script Cloud Shell qui sotto imposta il ruolo di tutto il catalogo Google Cloud, crea l'account di servizio e attiva le API del suo progetto.
021. Scegliere il progetto host #sec_91fcbbe4
REVIEWIT collega un'organizzazione Google Cloud: un progetto "senza organizzazione" non è supportato. L'account di servizio risiede in un progetto host di tua scelta, idealmente un progetto dedicato (ad esempio reviewit-connector) in una cartella di sicurezza.
Il progetto host non ha bisogno di alcun conto di fatturazione: REVIEWIT attiva solo sette API di organizzazione (Resource Manager, Service Usage, IAM, Org Policy, Cloud Billing, Recommender, Privileged Access Manager), che si attivano senza fatturazione. Le letture di un progetto sono conteggiate su quel progetto: un progetto che contiene risorse ha già le API corrispondenti.
032. Esegui lo script #sec_dcebd435
Apri Cloud Shell con un account che detiene, sull'organizzazione, i ruoli Amministratore dell'organizzazione e Amministratore dei ruoli dell'organizzazione (un super-amministratore di Google Workspace non li ha di default: può assegnarli in IAM e amministrazione › IAM), carica lo script, poi:
HOST_PROJECT=reviewit-connector bash reviewit-gcp-setup.sh
Lo script, in ordine:
- attiva le sette API dell'organizzazione nel progetto host;
- crea (o aggiorna) il ruolo personalizzato REVIEWIT_Read sull'organizzazione;
- crea l'account di servizio reviewit-collector nel progetto host;
- gli assegna il ruolo sul nodo dell'organizzazione.
Non crea alcuna chiave e non modifica alcuna politica dell'organizzazione senza che tu lo richieda (sezione 3 b). Riavvio dopo un'evoluzione del catalogo: aggiorna il ruolo.
043. Scegliere il metodo #sec_0afbfc3f
a. Senza chiave (consigliato)
Nell'assistente di connessione, al passo Identificativo, scegli Senza chiave (federazione), poi Genera la chiave per questa connessione. REVIEWIT genera la chiave nel suo caveau e ti restituisce la sua parte pubblica. Copia i comandi Cloud Shell ed esegui-li in Cloud Shell, dopo lo script della sezione 2. Devi essere proprietario del progetto ospite o avere i ruoli Amministratore pool identità carico di lavoro e Amministratore account di servizio.
Questi comandi, in ordine:
- attivano due API nel progetto ospite (sts, iamcredentials);
- creano il pool di identità reviewit, se non esiste ancora;
- vi creano un provider OIDC specifico per questa connessione: conosce la chiave pubblica di REVIEWIT e ammette solo il soggetto di questa connessione;
- autorizzano questo unico soggetto ad agire come reviewit-collector (ruolo Utente Workload Identity).
Alla fine mostrano l'account di servizio e il provider da riportare nell'assistente (sezione 4). Un'altra connessione REVIEWIT, anche dello stesso cliente, non apre mai questa organizzazione: ha la sua chiave e il suo soggetto unici.
b. Con una chiave
Le organizzazioni create dal 2024 impediscono per impostazione predefinita la creazione di chiavi degli account di servizio (politica di organizzazione Disabilita la creazione delle chiavi degli account di servizio, applicata automaticamente). Questa è una buona pratica: una chiave è un segreto a lunga durata. Ecco perché la connessione senza chiave è consigliata.
Per la connessione con chiave, solleva il divieto solo sul progetto ospite, poi crea la chiave:
HOST_PROJECT=reviewit-connector ALLOW_KEY_EXCEPTION=yes CREATE_KEY=yes bash reviewit-gcp-setup.sh
Per farlo, hai bisogno del ruolo di amministratore delle regole di amministrazione (roles/orgpolicy.policyAdmin). Una regola sollevata richiede da alcuni minuti a minuti per essere applicata: durante questo periodo, Google rifiuta la chiave (CUSTOM_ORG_POLICY_VIOLATION) e lo script riprova da solo. Lo script scrive reviewit-collector-key.json: incolla il suo contenuto in REVIEWIT (sezione 4), poi elimina il file.
054. Dichiarare e verificare #sec_05593f95
Tornate all'assistente, passo Identificatore :
- senza chiave: riportate il conto di servizio e il fornitore ( projects/…/workloadIdentityPools/reviewit/providers/… ) che i comandi hanno visualizzato ;
- con una chiave: incollare la chiave JSON .
Se chiamate i vostri proprietari con un'altra dicitura che non sia owner , indicate la sua chiave. Poi Verificare . Non c'è nessun identificatore di organizzazione da inserire: REVIEWIT lo scopre.
REVIEWIT ottiene l'accesso del conto di servizio, scopre l'organizzazione ( organizations/… ), vede i progetti, poi chiede a Google, permesso per permesso , ciò che il conto di servizio ha il diritto di fare sull'organizzazione — inclusi l'eredità e i ruoli personalizzati. Mostra il verdetto di ogni risorsa, e nomina le API ancora da attivare nel progetto ospite ; ciò che manca riporta al passo Preparare . Senza chiave, un rifiuto nomina il passo in questione: il fornitore che rifiuta il token (riavviate i comandi), o il diritto di agire in qualità di conto di servizio che manca. Google impiega da uno a due minuti per applicare questo diritto: una verifica lanciata subito dopo i comandi può essere rifiutata per questo motivo ; riavviatela due minuti più tardi.
Una chiave è conservata nel cofano di REVIEWIT, mai in chiaro; potete anche affidarla a SEAL , che firma al suo posto senza mai renderla. Per rinnovarla, create una nuova chiave, aggiornate l'identificatore in REVIEWIT, poi eliminate quella vecchia. Senza chiave, non c'è nulla da rinnovare.
06Chi risponde di una risorsa #sec_f86c62c9
REVIEWIT legge il proprietario nella dicitura che scegliete ( owner per impostazione predefinita) : prima sulla risorsa, poi sul suo progetto. Un valore di dicitura non ammette né « @ » né « . » : indicate la parte locale dell'indirizzo ( marie-dupont per marie-dupont@vostro-dominio) ; REVIEWIT la risolve nei domini della vostra organizzazione. Senza dicitura, sono i detentori diretti del ruolo Owner del progetto ; altrimenti, la risorsa è segnalata orfana .
07Ciò che REVIEWIT non fa mai #sec_6e5ae848
- Non distribuisce nulla e non si concede alcun diritto: il vostro amministratore lancia lo script o imposta il ruolo.
- Non legge né il valore di un segreto ( secretmanager.versions.access ), né il contenuto di un oggetto ( storage.objects.get ), né i dati di una tabella ( bigquery.tables.getData ) : nessuna di queste autorizzazioni è richiesta.
- Non richiede Cloud Asset Inventory : se è attivato, REVIEWIT lo utilizza per enumerare più velocemente; altrimenti, nulla cambia.
08Per andare oltre #sec_06d33e2c
- Comprendere una connessione di raccolta
- Riferimento dei diritti per risorsa
- Leggere un verdetto