Le policy sul confine di accesso dell'entità (PAB) ti consentono di definire le risorse a cui le entità possono accedere.
Altre policy relative all'accesso, come le policy di autorizzazione e di negazione, sono collegate alle risorse. Queste policy definiscono chi è autorizzato ad accedere alla risorsa a cui sono collegate. Al contrario, le policy sul confine di accesso dell'entità sono collegate ai set di entità e controllano ciò che le entità nel set di entità possono fare.
Ad esempio, puoi utilizzare le policy sul confine di accesso dell'entità per impedire alle entità di accedere alle risorse di altre organizzazioni, il che può aiutare a prevenire attacchi di phishing o l'esfiltrazione di dati.
Come funzionano le policy sul confine di accesso dell'entità
Per impostazione predefinita, le entità sono idonee ad accedere a qualsiasi risorsa Google Cloud . Ciò significa che, se una policy di autorizzazione concede a un'entità l'accesso a una risorsa e nessuna policy di negazione blocca l'accesso, l'entità può accedere alla risorsa.
Con le policy sul confine di accesso dell'entità, puoi definire le risorse a cui un'entità è idonea ad accedere. Se un'entità non è idonea ad accedere a una risorsa, il suo accesso a quella risorsa è limitato, indipendentemente dai ruoli che le sono stati concessi. Per saperne di più sull'utilizzo delle policy sul confine di accesso dell'entità per definire le risorse a cui un'entità è idonea ad accedere, consulta Definisci le risorse idonee.
Le policy sul confine di accesso dell'entità bloccano solo i tentativi di accesso che coinvolgono autorizzazioni supportate. Se una policy sul confine di accesso dell'entità non può bloccare un'autorizzazione, le entità possono utilizzare l'autorizzazione per accedere a qualsiasi risorsa, indipendentemente dalle policy a cui sono soggette. Per saperne di più, consulta Autorizzazioni che possono essere bloccate dalle policy sul confine di accesso dell'entità.
Casi d'uso
Le policy sul confine di accesso dell'entità sono utili in circostanze come le seguenti:
- Impedire alle entità di accedere alle risorse di cui non sei proprietario
- Limitare determinati tipi di entità, come i service account, a determinati progetti
Per esempi dettagliati di come utilizzare le policy sul confine di accesso dell'entità in situazioni come queste, consulta Esempi di casi d'uso per le policy sul confine di accesso dell'entità.
Componenti delle policy di Principal Access Boundary
Le policy sul confine di accesso dell'entità sono costituite da singole regole. Ogni regola definisce un insieme di risorse a cui le entità possono accedere. Ogni policy può avere fino a 500 regole.
Le policy contengono anche altre informazioni, tra cui metadati e dettagli di configurazione. Per saperne di più, consulta Struttura di una policy Principal Access Boundary.
Dopo aver creato una policy sul confine di accesso dell'entità, applicala a insiemi di entità creando associazioni delle policy. Tutte le entità di questi set di entità sono quindi soggette alla policy sul confine di accesso dell'entità, il che significa che sono idonee ad accedere alle risorse elencate nella policy. Puoi associare una policy sul confine di accesso dell'entità a un numero qualsiasi di set di entità.
Puoi creare fino a 1000 policy di Principal Access Boundary nella tua organizzazione.
Autorizzazioni bloccate dalle policy sul confine di accesso dell'entità
Le policy sul confine di accesso dell'entità possono bloccare tutte le autorizzazioni incluse nella versione di applicazione della policy. Se una policy di Principal Access Boundary può bloccare un'autorizzazione, può impedire alle entità non idonee di utilizzare l'autorizzazione per accedere alle risorse.
La versione di applicazione di una policy viene specificata al momento della creazione della policy. L'aggiornamento della versione di applicazione aggiorna le autorizzazioni che la policy può bloccare. Per un elenco completo delle autorizzazioni bloccate da ogni versione di applicazione, consulta il riferimento alle versioni di applicazione.
Se una policy sul confine di accesso dell'entità non può bloccare un'autorizzazione, la policy non ha alcun effetto sulla possibilità per le entità di utilizzare l'autorizzazione. In altre parole, IAM non può applicare la policy per i tentativi di accesso che coinvolgono questa autorizzazione.
Ad esempio, immagina che a un'entità, Lee (lee@example.com), venga concesso il ruolo Sviluppatore Dataflow (roles/dataflow.developer). Questo ruolo include l'autorizzazione dataflow.googleapis.com/jobs.snapshot, che consente a Lee di acquisire snapshot dei job Dataflow. Lee è inoltre soggetto a una policy sul confine di accesso dell'entità che non lo rende idoneo ad accedere alle risorse al di fuori di example.com.
Tuttavia, se la policy dei confini di accesso delle entità non può bloccare l'autorizzazione dataflow.jobs.snapshot, Lee può comunque acquisire snapshot dei job Dataflow in organizzazioni esterne a example.com.
Gestisci le versioni di applicazione forzata
Periodicamente, IAM aggiunge nuove versioni di applicazione che possono bloccare autorizzazioni aggiuntive. Ogni nuova versione può anche bloccare tutte le autorizzazioni della versione precedente.
Per bloccare le autorizzazioni in una nuova versione di applicazione, devi aggiornare le policy sul confine di accesso dell'entità in modo che utilizzino la nuova versione.
Se vuoi che la versione di applicazione di una policy venga aggiornata automaticamente man mano che vengono rilasciate nuove versioni, puoi utilizzare il valore latest durante la creazione della policy.
Tuttavia, non consigliamo di utilizzare questo valore, perché potrebbe causare la perdita imprevista dell'accesso alle risorse da parte delle entità.
Le policy che utilizzano latest per il numero di versione utilizzano la versione di applicazione predefinita. La versione di applicazione predefinita è in genere quella più recente.
Tuttavia, possono essere necessarie fino a 4 settimane prima che una nuova versione diventi la versione di applicazione predefinita. Per scoprire qual è la versione di applicazione predefinita, consulta il riferimento alla versione di applicazione.
La versione di applicazione predefinita viene utilizzata anche per le nuove policy sul confine di accesso dell'entità che non specificano un numero di versione.
Definisci le risorse idonee
Le entità possono essere interessate o soggette a un numero qualsiasi di policy dei limiti di accesso all'entità. Insieme, queste policy definiscono le risorse a cui l'entità può accedere.
Le policy sul confine di accesso dell'entità sono additive. Ciò significa che le risorse a cui un'entità è idonea ad accedere sono l'unione di tutte le risorse in tutte le policy sul confine di accesso dell'entità a cui l'entità è soggetta. In altre parole, se una singola policy sul confine di accesso dell'entità rende un'entità idonea ad accedere a una risorsa, l'entità è idonea ad accedere alla risorsa, indipendentemente dalle altre policy sul confine di accesso dell'entità a cui è soggetta.
Se un'entità non è soggetta a policy sul confine di accesso dell'entità, è idonea ad accedere a qualsiasi risorsa Google Cloud .
Le sezioni seguenti descrivono come personalizzare l'insieme di risorse a cui un'entità è idonea ad accedere.
Aggiungi risorse idonee
Esistono diversi modi per rendere un'entità idonea ad accedere a una risorsa a cui non è idonea ad accedere:
- Aggiungi la risorsa a una policy sul confine di accesso dell'entità a cui è soggetta l'entità.
- Crea una nuova policy sul confine di accesso dell'entità con la risorsa aggiuntiva e associa la policy a un set di entità che include l'entità.
- Rimuovi o elimina tutte le policy sul confine di accesso dell'entità a cui è soggetta l'entità. Questa azione rende l'entità idonea ad accedere a tutte le risorse Google Cloud .
Rimuovi le risorse idonee
Esistono diversi modi per rendere un'entità non idonea ad accedere a una risorsa a cui è idonea ad accedere.
Innanzitutto, trova tutte le policy sul confine di accesso dell'entità a cui è soggetta l'entità che includono la risorsa. In base alle norme che trovi, puoi eseguire una delle seguenti operazioni:
Se l'entità non è soggetta a policy sul confine di accesso dell'entità, crea una nuova policy sul confine di accesso dell'entità che includa solo le risorse a cui vuoi che l'entità possa accedere. Quindi, associa la policy a un set di entità che contiene l'entità.
Dopo aver applicato la policy, l'entità non è più idonea ad accedere a tutte le risorse, ma solo a quelle elencate nella policy.
Se l'entità è già soggetta a una o più policy sul confine di accesso dell'entità, devi assicurarti che nessuna delle policy sul confine di accesso dell'entità a cui è soggetta includa la risorsa. Per istruzioni passo passo, consulta Riduci le risorse a cui le entità sono idonee ad accedere.
Durante questa procedura, devi assicurarti che l'entità sia sempre soggetta ad almeno una policy sul confine di accesso dell'entità. In caso contrario, l'entità potrebbe diventare idonea ad accedere a tutte le risorse.
Policy sul confine di accesso dell'entità e risorse memorizzate nella cache
Alcuni servizi Google Cloud memorizzano nella cache le risorse visibili pubblicamente. Ad esempio, Cloud Storage memorizza nella cache gli oggetti pubblicamente leggibili.
La possibilità che una policy sul confine di accesso dell'entità impedisca alle entità non idonee di visualizzare una risorsa visibile pubblicamente dipende dal fatto che la risorsa sia memorizzata nella cache:
- Se la risorsa è memorizzata nella cache, le policy sul confine di accesso dell'entità non possono impedire alle entità di visualizzarla
- Se la risorsa non è memorizzata nella cache, il confine di accesso dell'entità impedisce alle entità non idonee di visualizzarla
In tutti i casi, le policy sul confine di accesso dell'entità impediscono comunque alle entità non idonee di modificare o eliminare le risorse visibili pubblicamente.
Risorse di proprietà di Google
Per consentire agli sviluppatori di utilizzare i servizi Google Cloud , come BigQuery e Cloud Workstations, Google Cloud fornisce risorse pubbliche di proprietà di Google. Ad esempio, BigQuery fornisce set di dati pubblici che puoi integrare nelle tue applicazioni. Queste risorse pubbliche sono ospitate in un'organizzazione di proprietà di GoogleGoogle Cloud con l'ID 433637338589. Questa organizzazione viene utilizzata anche per gestire i progetti tenant per servizi come Cloud Workstations.
Le entità soggette alle policy sul confine di accesso dell'entità perderanno l'accesso a queste risorse pubbliche, a meno che non le rendi idonee ad accedere alle risorse nell'organizzazione di proprietà di Google.
Per rendere le entità idonee ad accedere alle risorse nell'organizzazione di proprietà di Google, aggiungi la seguente regola a una policy sul confine di accesso dell'entità che si applica alle entità:
{
"description": "Make principals eligible to access Google-owned public resources",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/433637338589"
],
"effect": "ALLOW"
}
In alternativa, puoi creare una nuova policy sul confine di accesso dell'entità con questa regola e associarla al set di entità pertinente.
Valutazione delle policy sul confine di accesso dell'entità
Quando un'entità tenta di accedere a una risorsa, IAM valuta le policy sul confine di accesso dell'entità pertinenti per determinare se bloccare il tentativo di accesso. Una policy è pertinente se l'entità che effettua il tentativo di accesso è soggetta alla policy.
Le policy sul confine di accesso dell'entità possono solo bloccare o non bloccare l'accesso, non possono concederlo. Solo le policy di autorizzazione possono effettivamente concedere alle entità l'accesso alle risorse. Per scoprire in che modo i diversi tipi di policy influiscono sull'accesso delle entità alle risorse, consulta Tipi di policy.
IAM non blocca l'accesso se si verifica una delle seguenti condizioni:
- L'entità non è soggetta a policy sul confine di accesso dell'entità
- Le policy sul confine di accesso dell'entità pertinenti non possono bloccare l'autorizzazione nella richiesta
- Una policy sul confine di accesso dell'entità rende l'entità idonea ad accedere alla risorsa
IAM blocca l'accesso se l'entità è soggetta ad almeno una policy sul confine di accesso dell'entità, ma nessuna delle policy pertinenti rende l'entità idonea ad accedere alla risorsa.
Valutazione fail-closed
Le policy sul confine di accesso dell'entità sono fail-closed. Ciò significa che, se IAM rileva un errore durante la valutazione di una policy sul confine di accesso dell'entità, impedisce all'entità di accedere alla risorsa.
Il motivo più comune per cui IAM riscontra un errore durante la valutazione delle policy sul confine di accesso dell'entità è che i dettagli di un'entità sono ancora in fase di propagazione nel sistema. Questa situazione si verifica con più probabilità per gli utenti appena creati. Per risolvere il problema, chiedi alla nuova entità di attendere e riprovare ad accedere alla risorsa in un secondo momento.
Applica le policy sul confine di accesso dell'entità ai set di entità
Per applicare una policy sul confine di accesso dell'entità a un set di entità, devi creare un binding della policy che specifichi sia la policy sul confine di accesso dell'entità che vuoi applicare sia il set di entità a cui vuoi applicarla. Questa associazione delle policy associa la policy al set di entità.
Dopo aver associato una policy a un set di entità, le entità di quel set possono accedere solo alle risorse elencate nelle policy sul confine di accesso dell'entità a cui sono soggette.
Puoi associare una policy sul confine di accesso dell'entità a un numero qualsiasi di set di entità. A ogni set di entità possono essere associate fino a 10 policy sul confine di accesso dell'entità.
Puoi creare associazioni solo per le policy sul confine di accesso dell'entità esistenti. Il tentativo di creare un'associazione per una policy sul confine di accesso dell'entità eliminata non andrà a buon fine. Se hai eliminato di recente una policy sul confine di accesso dell'entità, a volte puoi creare un'associazione, ma questa non avrà alcun effetto. IAM elimina automaticamente queste associazioni.
Per scoprire come gestire le policy sul confine di accesso dell'entità, consulta Crea e applica le policy sul confine di accesso dell'entità.
Set di entità supportati
La tabella seguente elenca i tipi di set di entità a cui puoi associare le policy sul confine di accesso dell'entità. Ogni riga contiene quanto segue:
- Il tipo di set di entità
- Le entità in quel tipo di set di entità
- Il formato degli ID per quel tipo di set di entità
- La risorsa di Resource Manager (progetto, cartella o organizzazione) che è l'elemento padre delle associazioni delle policy per quel tipo di set di entità
| Set di entità | Dettagli | Risorsa padre delle associazioni delle policy |
|---|---|---|
| Pool di identità della forza lavoro |
Contiene tutte le identità nel pool di identità della forza lavoro specificato.
Formato: |
L'organizzazione che contiene il pool di identità della forza lavoro |
| Pool di identità del workload |
Contiene tutte le identità nel pool di identità del workload specificato.
Formato: |
Il progetto che contiene il pool di identità del workload |
| Dominio Google Workspace |
Contiene tutte le identità nel dominio Google Workspace specificato.
Formato: Puoi trovare il tuo ID cliente utilizzando i seguenti metodi:
|
L'organizzazione associata al dominio Google Workspace |
| Set di entità del progetto |
Contiene tutti i service account, i pool di identità del workload e le identità degli agenti nel progetto specificato.
Formato: |
Il progetto |
| Set di entità della cartella |
Contiene tutti i service account, tutti i pool di identità del workload e tutte le identità degli agenti in qualsiasi progetto nella cartella specificata.
Formato: |
La cartella |
| Set di entità dell'organizzazione |
Contiene le seguenti identità:
Formato: |
L'organizzazione |
| Identità dell'agente |
Tutte le identità dell'agente nel dominio di attendibilità del progetto specificato. Per impostazione predefinita, il dominio di attendibilità di un progetto contiene tutte le identità degli agenti nel progetto. Formati:
|
Il progetto |
Ereditarietà delle policy e set di entità
Le policy sul confine di accesso dell'entità sono collegate ai set di entità, non alle risorse. Di conseguenza, non vengono ereditati tramite la gerarchia delle risorse nello stesso modo in cui vengono ereditate le policy di autorizzazione e di negazione.
Tuttavia, i set di entità per cartelle e organizzazioni includono sempre tutte le entità nei set di entità dei relativi discendenti. Ad esempio, se un'entità è inclusa nel set di entità di un progetto, è inclusa anche nei set di entità di qualsiasi cartella o organizzazione principale.
Ad esempio, considera un'organizzazione, example.com. Questa organizzazione è associata al dominio example.com e dispone delle seguenti risorse:
- Un'organizzazione,
example.com - Un progetto,
project-1, che è un elemento secondario dell'organizzazione - Una cartella,
folder-a, che è un elemento secondario dell'organizzazione - Due progetti,
project-2eproject-3, che sono elementi secondari difolder-a
I set di entità di queste risorse contengono le seguenti identità:
| Set di entità | Identità Google Workspace nel dominio example.com |
Pool di federazione delle identità per la forza lavoro in example.com |
Service account, pool di identità del workload e identità degli agenti in project-1 |
Service account, pool di identità del workload e identità degli agenti in project-2 |
Service account, pool di identità del workload e identità degli agenti in project-3 |
|---|---|---|---|---|---|
Set di entità per example.com |
|||||
Set di entità per folder-a |
|||||
Set di entità per project-1 |
|||||
Set di entità per project-2 |
|||||
Set di entità per project-3 |
Di conseguenza, le seguenti entità sono interessate dalle seguenti policy sul confine di accesso dell'entità:
Un'identità Google Workspace nel dominio
example.comsi trova nel set di entità perexample.come sarà interessata dalle policy sul confine di accesso dell'entità associate a quel set di entità.Un account di servizio in
project-1si trova nei set di entità perproject-1eexample.come sarà interessato dalle policy sul confine di accesso dell'entità associate a uno di questi set di entità.Un'identità dell'agente in
project-3si trova nei set di entità perproject-3,folder-aeexample.come sarà interessata dalle policy sul confine di accesso dell'entità associate a uno di questi set di entità.
Associazioni di policy condizionali per le policy sul confine di accesso dell'entità
Puoi utilizzare espressioni di condizione nelle associazioni delle policy per le policy sul confine di accesso dell'entità per perfezionare ulteriormente le entità a cui si applica la policy.
Le espressioni di condizione per le associazioni delle policy sono costituite da una o più istruzioni unite da un massimo di 10 operatori logici (&&, || o !). Ogni istruzione esprime una regola di controllo basata sugli attributi che si applica all'associazione della policy e, in ultima analisi, determina se la policy viene applicata.
Puoi utilizzare gli attributi principal.type e principal.subject nelle condizioni per le associazioni delle policy. Non sono supportati altri attributi.
L'attributo
principal.typesi riferisce al tipo di entità che ha effettuato la richiesta, ad esempio un account di servizio o un'identità agente. Puoi utilizzare le condizioni con questo attributo per controllare a quali tipi di entità si applica una policy di Principal Access Boundary.Ad esempio, se aggiungi la seguente espressione di condizione a un'associazione per una policy sul confine di accesso dell'entità, la policy si applica solo ai service account:
principal.type == 'iam.googleapis.com/ServiceAccount'L'attributo
principal.subjectsi riferisce all'identità dell'entità che ha effettuato la richiesta, ad esempiocruz@example.com. Puoi utilizzare le condizioni con questo attributo per controllare esattamente quali entità sono soggette a una policy sul confine di accesso dell'entità.Ad esempio, se aggiungi la seguente espressione di condizione a un'associazione per una policy dei limiti di accesso dell'entità, la policy non verrà applicata all'utente
special-admin@example.com:principal.subject != 'special-admin@example.com'
Per scoprire di più sui valori che puoi utilizzare per queste condizioni, consulta il riferimento per l'attributo conditions.
Per un esempio di come utilizzare queste condizioni nelle policy dei confini di accesso delle entità, consulta Rendi i service account idonei ad accedere alle risorse in un singolo progetto.
Associazioni di policy tra organizzazioni
Non puoi creare un'associazione di policy tra organizzazioni per una policy di Principal Access Boundary. Un'associazione delle policy tra organizzazioni è un'associazione delle policy che associa una policy di un'organizzazione a un set di entità di un'altra organizzazione.
IAM elimina periodicamente tutte le associazioni di policy tra organizzazioni esistenti. Le associazioni di policy tra organizzazioni possono verificarsi quando sposti un progetto da un'organizzazione a un'altra. Ad esempio, prendi in considerazione la seguente situazione:
- Hai un progetto,
example-project, nell'organizzazioneexample.com. - Vuoi che le entità in
example-projectsiano idonee ad accedere alle risorse inexample.com. Per farlo, crea una policy di Principal Access Boundary inexample.comche renda le entità idonee ad accedere alle risorse inexample.come associa la policy al set di entità perexample-project. - Sposti
example-projectdaexample.comacymbalgroup.com.
In questo caso, lo spostamento del progetto crea un'associazione di policy tra organizzazioni. Questo perché la policy di Principal Access Boundary in example.com è associata a un set di entità in cymbalgroup.com. Se non elimini l'associazione manualmente, IAM la elimina automaticamente. L'eliminazione di questa associazione contribuisce a garantire che gli amministratori di cymbalgroup.com abbiano accesso a tutte le policy sul confine di accesso dell'entità associate alle loro entità.
Struttura di una policy sul confine di accesso dell'entità
Una policy sul confine di accesso dell'entità è una raccolta di metadati e dettagli della policy sul confine di accesso dell'entità. I metadati forniscono informazioni come il nome della policy e la data di creazione. I dettagli della policy definiscono cosa fa la policy, ad esempio le risorse a cui le entità interessate sono idonee ad accedere.
Ad esempio, la seguente policy sul confine di accesso dell'entità rende le entità soggette alla policy idonee ad accedere alle risorse nell'organizzazione con l'ID 0123456789012.
{
"name": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"annotations": {
"example-key": "example-value"
},
"createTime": "2024-01-02T15:01:23Z",
"updateTime": "2024-01-02T15:01:23Z",
"details": {
"rules": [
{
"description": "Example principal access boundary policy rule",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/0123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
Le sezioni seguenti descrivono i campi nei metadati e nei dettagli di una policy sul confine di accesso dell'entità.
Metadati
Le policy sul confine di accesso dell'entità contengono i seguenti metadati:
name: il nome della policy Principal Access Boundary. Questo nome ha il formatoorganizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, doveORGANIZATION_IDè l'ID numerico dell'organizzazione in cui è stata creata la policy sul confine di accesso dell'entità ePAB_POLICY_IDè l'ID alfanumerico della policy sul confine di accesso dell'entità.uid: un ID univoco assegnato alla policy Principal Access Boundary.etag: un identificatore dello stato attuale della policy. Questo valore cambia quando aggiorni la policy. Per evitare aggiornamenti in conflitto, il valoreetagdeve corrispondere al valore archiviato in IAM. Se i valorietagnon corrispondono, la richiesta non va a buon fine.displayName: un nome leggibile per la policy dei limiti di accesso dell'entità.annotations: (Facoltativo) Un elenco di coppie chiave-valore definite dall'utente. Puoi utilizzare queste annotazioni per aggiungere metadati aggiuntivi alla policy, ad esempio chi l'ha creata o se è stata implementata da una pipeline automatizzata. Per ulteriori informazioni sulle annotazioni, consulta Annotazioni.createTime: la data e l'ora di creazione della policy di Principal Access Boundary.updateTime: la data e l'ora dell'ultimo aggiornamento della policy sul confine di accesso dell'entità.
Dettagli
Ogni policy sul confine di accesso dell'entità contiene un campo details. Questo campo contiene le regole e la versione di applicazione del confine di accesso dell'entità:
rules: un elenco di regole del confine di accesso dell'entità, che definiscono le risorse a cui le entità interessate possono accedere. Ogni regola contiene i seguenti campi:description: una descrizione della regola leggibile da una persona.resources: un elenco di risorse di Resource Manager (progetti, cartelle e organizzazioni) a cui vuoi che le entità possano accedere. Qualsiasi entità soggetta a questa policy è idonea ad accedere a queste risorse.Ogni policy sul confine di accesso dell'entità può fare riferimento a un massimo di 500 risorse in tutte le regole della policy.
effect: la relazione che le entità hanno con le risorse elencate nel camporesources. L'unico effetto che puoi specificare nelle regole dei confini di accesso dell'entità è"ALLOW". Questa relazione rende le entità idonee ad accedere alle risorse elencate nella regola.
enforcementVersion: la versione di applicazione utilizzata da IAM per applicare la policy. La versione della policy sul confine di accesso dell'entità determina quali autorizzazioni possono essere bloccate dalla policy.Per saperne di più su come impostare e gestire le versioni di applicazione, consulta Gestisci le versioni di applicazione in questa pagina.
Struttura di un'associazione di policy
Un'associazione delle policy per una policy di Principal Access Boundary contiene il nome di una policy, il nome del set di entità a cui associare la policy e i metadati che descrivono l'associazione delle policy. Può anche contenere condizioni che modificano le entità esatte a cui si applica la policy.
Ad esempio, la seguente associazione delle policy associa la policy example-policy a tutte le entità dell'organizzazione example.com, che ha l'ID 0123456789012. L'associazione della policy contiene anche una condizione che impedisce l'applicazione della policy per l'entità super-admin@example.com.
{
"name": "organizations/0123456789012/locations/global/policyBindings/example-policy-binding",
"uid": "buid_01234567890123456789",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example policy binding",
"annotations": {
"example-key": "example-value"
},
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"policyUid": "puid_0123456789012345678",
"condition": {
"title": "Exempt principal",
"description": "Don't enforce the policy for super-admin@example.com",
"expression": "principal.subject != 'super-admin@example.com'"
},
"createTime": "2024-01-02T17:00:16Z",
"updateTime": "2024-01-02T17:00:16Z"
}
Ogni associazione della policy contiene i seguenti campi:
name: il nome dell'associazione delle policy. Questo nome ha il formatoRESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, doveRESOURCE_TYPE/RESOURCE_IDè il tipo e l'ID della risorsa padre dell'associazione delle policy eBINDING_IDè l'ID alfanumerico dell'associazione delle policy.uid: un ID univoco assegnato all'associazione della policy.etag: un identificatore dello stato attuale della policy. Questo valore cambia quando aggiorni la policy. Per evitare aggiornamenti in conflitto, il valoreetagdeve corrispondere al valore archiviato in IAM. Se i valorietagnon corrispondono, la richiesta non va a buon fine.displayName: un nome leggibile per l'associazione della policy.annotations: (Facoltativo) Un elenco di coppie chiave-valore definite dall'utente. Puoi utilizzare queste annotazioni per aggiungere metadati aggiuntivi all'associazione della policy, ad esempio chi ha creato l'associazione della policy o se l'associazione della policy è stata implementata da una pipeline automatizzata. Per ulteriori informazioni sulle annotazioni, consulta Annotazioni.target: il set di entità a cui associare la policy. Il valore ha il formato{"principalSet": PRINCIPAL_SET}, dovePRINCIPAL_SETè l'ID del set di entità a cui vuoi associare la policy.A ogni target possono essere associate fino a 10 policy.
policyKind: il tipo di policy a cui fa riferimento l'associazione della policy. Per le associazioni delle policy per le policy sul confine di accesso dell'entità, questo valore è semprePRINCIPAL_ACCESS_BOUNDARY.policy: la policy sul confine di accesso dell'entità da associare al set di entità di destinazione.policyUid: un ID univoco assegnato alla policy dei confini di accesso dell'entità a cui viene fatto riferimento nel campopolicy.condition: (Facoltativo) Un'espressione logica che influisce sulle entità per le quali IAM applica la policy. Se la condizione restituisce true o non può essere valutata, Identity and Access Management applica la policy per l'entità che effettua la richiesta. Se la condizione restituisce false, Identity and Access Management non applica la policy per l'entità. Per saperne di più, consulta Confine di accesso dell'entità e condizioni in questa pagina.createTime: la data e l'ora in cui è stata creata l'associazione delle policy.updateTime: l'ora dell'ultimo aggiornamento dell'associazione della policy.
Passaggi successivi
- Scopri di più sui casi d'uso delle policy dei confini di accesso dell'entità.
- Scopri come creare e applicare le policy sul confine di accesso dell'entità.
- Esamina l'autorizzazione bloccata da ogni versione di applicazione delle policy dei limiti di accesso dell'entità.