La funzionalità di appartenenza basata su cartelle nei Controlli di servizio VPC ti consente di definire perimetri di servizio con cartelle Google Cloud come membri. Aiutandoti a proteggere un'intera gerarchia di cartelle con una singola configurazione del perimetro, questa funzionalità riduce l'overhead amministrativo della gestione del perimetro su larga scala.
Questo documento spiega come funziona il supporto delle cartelle nei perimetri e illustra quanto segue:
Concetti, comportamenti e vantaggi principali dell'utilizzo delle cartelle nei perimetri.
Interazioni tra l'appartenenza basata su cartelle, le risorse nidificate e le regole della gerarchia delle risorse, come l'ereditarietà e la precedenza di valutazione.
Come cercare i perimetri configurati per progetti e cartelle.
Best practice e limitazioni note per l'utilizzo di questa funzionalità.
Informazioni sull'appartenenza delle cartelle ai perimetri
Una cartellaGoogle Cloud può contenere più progetti, altre cartelle o una combinazione di entrambi. Sebbene tu possa aggiungere singoli progetti all'interno di una cartella a un perimetro di servizio, ti consigliamo di aggiungere la cartella principale. Quando specifichi una cartella come risorsa protetta durante la creazione di un perimetro, i Controlli di servizio VPC includono tutte le risorse all'interno della cartella, ad esempio progetti e cartelle nidificate.
Quando aggiungi progetti a una cartella che hai configurato in un perimetro, i Controlli di servizio VPC aggiungono automaticamente questi progetti allo stesso perimetro. Non è necessario aggiornare la configurazione del perimetro per includere questi progetti. Allo stesso modo, quando rimuovi i progetti dalla cartella, i Controlli di servizio VPC li rimuovono automaticamente dal perimetro.
Cartelle nidificate ed ereditarietà
I Controlli di servizio VPC limitano tutte le risorse all'interno di una cartella che hai configurato in un perimetro, ad esempio le cartelle nidificate e le relative risorse. Quando aggiungi una cartella a un perimetro, i Controlli di servizio VPC limitano automaticamente tutti i progetti in quella cartella e nelle relative sottocartelle.
Precedenza della valutazione dell'appartenenza alle risorse
Una risorsa Google Cloud può essere protetta da un solo perimetro di servizio regolare in modalità di applicazione forzata e da uno in modalità dry run. Se una risorsa o le relative cartelle principali sono associate a più perimetri, l'associazione di livello più basso nella gerarchia delle risorse determina il perimetro effettivo.
I Controlli di servizio VPC valutano la precedenza in modo indipendente per la modalità di applicazione forzata e la modalità dry run:
- Precedenza della modalità di applicazione forzata: il perimetro in modalità di applicazione forzata effettivo è determinato dalla risorsa più bassa nella gerarchia (il progetto stesso o la cartella predecessore più vicina) assegnata esplicitamente a un perimetro in modalità di applicazione forzata.
- Precedenza della modalità dry run: il perimetro in modalità di prova effettivo è determinato dalla risorsa più bassa nella gerarchia assegnata esplicitamente a un perimetro in modalità di prova o ereditata implicitamente da una risorsa applicata assegnata esplicitamente.
La configurazione di un perimetro in modalità di prova per un progetto o una sottocartella non disabilita o sostituisce un perimetro in modalità di applicazione forzata configurato in una cartella predecessore.
Esempi di precedenza
Esempio 1 (override diretto del progetto in modalità di applicazione forzata): se configuri una cartella principale (
folders/1) in un perimetro in modalità di applicazione forzata (sp1) e configuri esplicitamente un progetto all'interno di quella cartella (projects/1) in un perimetro in modalità di applicazione forzata diverso (sp2),projects/1è protetto dasp2. L'assegnazione diretta del progetto ha la precedenza sull'ereditarietà delle cartelle. Tutti gli altri progetti infolders/1(ad esempioprojects/2) rimangono protetti dasp1tramite l'ereditarietà delle cartelle.Esempio 2 (ereditarietà delle cartelle in modalità dry run): quando configuri una cartella (
folders/1) in un perimetro di servizio in modalità dry run, tutti i progetti all'interno di quella cartella (projects/1eprojects/2) ereditano la configurazione del perimetro dry run (sp1), a meno che non sia esplicitamente disabilitata. L'ereditarietà in modalità dry run si comporta in modo identico all'ereditarietà in modalità di applicazione forzata, a meno che una risorsa nidificata non sia configurata esplicitamente con un perimetro in modalità di prova diverso.Esempio 3 (valutazione indipendente dei perimetri applicati e in modalità dry run): i Controlli di servizio VPC valutano le associazioni applicate e in modalità dry run in modo indipendente. Se configuri una cartella principale (
folders/1) in un perimetro in modalità di applicazione forzata (sp1) e assegni esplicitamente un progetto all'interno della cartella (projects/1) a un perimetro in modalità di prova (sp2),projects/1rimane protetto dasp1in modalità di applicazione forzata, mentre viene valutato contemporaneamente in modalità dry run dasp2. L'assegnazione di un progetto a un perimetro in modalità di prova non esegue l'override o la disattivazione del perimetro in modalità di applicazione forzata della cartella principale.Esempio 4 (gerarchia di cartelle multilivello e precedenza delle sottocartelle): in una gerarchia di cartelle multilivello, i Controlli di servizio VPC valutano la precedenza a ogni livello della gerarchia. Se una cartella predecessore (
folders/2) è configurata in un perimetro in modalità di applicazione forzata (sp1), tutti i progetti contenuti (projects/1eprojects/2) ereditano l'applicazione forzata disp1. Quando i perimetri in modalità dry run vengono assegnati a livelli diversi, ad esempio assegnando l'antenatofolders/2al perimetro in modalità di provasp2e il progettoprojects/2(nella sottocartellafolders/1) al perimetro in modalità di provasp1, ogni progetto eredita la configurazione dry run dall'antenato più vicino. Di conseguenza,projects/1viene valutato in modalità dry runsp2, mentreprojects/2viene valutato in modalità dry runsp1.
Cerca al volo i perimetri configurati effettivi
Poiché le risorse possono ereditare la protezione del perimetro dalle cartelle precedenti, puoi utilizzare il metodo LookupConfiguredServicePerimeter per identificare quali perimetri di servizio proteggono un progetto o una cartella.
L'API restituisce quanto segue:
servicePerimeter: il nome completo del perimetro in modalità di applicazione forzata effettivo.servicePerimeterDryRun: il nome completo del perimetro in modalità dry run effettivo.restrictedResource: la risorsa specifica (progetto o cartella) a cui è collegato direttamente il perimetro in modalità di applicazione forzata.restrictedResourceDryRun: la risorsa specifica a cui è collegato direttamente il perimetro in modalità dry run.
Per saperne di più, consulta Cerca i perimetri configurati.
Esclusione di progetti dai perimetri
Per escludere un progetto da un perimetro a livello di cartella, assegnalo esplicitamente a un perimetro separato che non limiti alcun servizio e consenta tutto il traffico in entrata e in uscita. Poiché le configurazioni esplicite dei progetti hanno la precedenza sui perimetri a livello di cartella, il progetto viene escluso dal perimetro della cartella.
Per informazioni sull'aggiornamento dei perimetri, consulta Aggiorna un perimetro di servizio.
Policy con ambito
I perimetri di servizio all'interno di una policy con ambito limitano solo le risorse che esistono nell'ambito di quella policy. Affinché una cartella venga inclusa come membro in un perimetro con ambito, la policy di accesso deve avere come ambito la cartella o un suo predecessore (ad esempio una cartella principale o l'organizzazione).
Best practice
Consulta le seguenti best practice per la gestione dei perimetri basati su cartelle.
Migrazione sicura dei progetti ai perimetri delle cartelle
Quando passi dalle appartenenze esplicite ai progetti a quelle basate su cartelle, segui questi passaggi per evitare interruzioni involontarie dell'applicazione del perimetro:
- Aggiungi la cartella principale di destinazione al perimetro di servizio.
- Sposta i progetti nella cartella principale nella gerarchia delle risorse.
- Conserva le voci esplicite dei progetti nella configurazione del perimetro fino al completamento della propagazione della gerarchia delle risorse in tutti i sistemi. La propagazione richiede in genere alcuni minuti, ma in alcuni casi può richiedere più tempo.
- Rimuovi le configurazioni di progetto esplicite dal perimetro. I progetti rimangono protetti tramite l'ereditarietà delle cartelle.
Spostamenti nella gerarchia
Lo spostamento di cartelle o progetti modifica la protezione perimetrale effettiva. Per evitare rifiuti di accesso imprevisti, coordina tutti gli spostamenti della gerarchia con l'amministratore di Resource Manager.
Se sposti i progetti che hai configurato in un perimetro in un'altra cartella e aggiungi quest'ultima allo stesso perimetro, mantieni le configurazioni di appartenenza esplicita dei progetti esistenti nel perimetro fino al completamento della propagazione della gerarchia delle risorse. La propagazione richiede in genere alcuni minuti, ma può richiedere più tempo. Questo periodo di attesa aiuta a evitare problemi imprevisti di applicazione forzata del perimetro quando rimuovi le configurazioni esplicite del progetto dal perimetro.
Limitazioni
L'appartenenza basata su cartelle non è supportata nei bridge del perimetro. I bridge del perimetro accettano solo risorse di progetto.
I Controlli di servizio VPC non supportano le risorse API a livello di cartella.
L'appartenenza alle cartelle non è supportata per le API nonGoogle Cloud e i perimetri configurati con
allowed_service_patterns. Per consentire l'accesso a questi pattern di servizi, i progetti o le reti VPC di origine devono essere aggiunti esplicitamente al perimetro, anziché essere ereditati tramite una cartella.
Passaggi successivi
- Configura le cartelle nei perimetri di servizio
- Scopri di più sui Controlli di servizio VPC
- Scopri di più sui perimetri di servizio.
- Scopri di più sulla progettazione e l'architettura dei perimetri di servizio.