Policy di Principal Access Boundary

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:

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: //iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID

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: //iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/WORKLOAD_POOL_ID

Il progetto che contiene il pool di identità del workload
Dominio Google Workspace

Contiene tutte le identità nel dominio Google Workspace specificato.

Formato: //iam.googleapis.com/locations/global/workspace/CUSTOMER_ID

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: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID

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: //cloudresourcemanager.googleapis.com/folders/FOLDER_ID

La cartella
Set di entità dell'organizzazione

Contiene le seguenti identità:

  • Tutte le identità in tutti i domini associati al tuo ID cliente Google Workspace
  • Tutti i pool di identità della forza lavoro nella tua organizzazione
  • Tutti i service account, i pool di identità del workload e le identità degli agenti in qualsiasi progetto dell'organizzazione

Formato: //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID

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:

  • //agents.global.org-ORGANIZATION_ID.system.id.goog/attribute.container/projects/PROJECT_NUMBER
  • //agents.global.proj-PROJECT_NUMBER.system.id.goog/attribute.container/projects/PROJECT_NUMBER
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:

Gerarchia delle risorse per example.com

Gerarchia delle risorse per example.com

  • 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-2 e project-3, che sono elementi secondari di folder-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.com si trova nel set di entità per example.com e sarà interessata dalle policy sul confine di accesso dell'entità associate a quel set di entità.

  • Un account di servizio in project-1 si trova nei set di entità per project-1 e example.com e sarà interessato dalle policy sul confine di accesso dell'entità associate a uno di questi set di entità.

  • Un'identità dell'agente in project-3 si trova nei set di entità per project-3, folder-a e example.com e 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.type si 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.subject si riferisce all'identità dell'entità che ha effettuato la richiesta, ad esempio cruz@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'organizzazione example.com.
  • Vuoi che le entità in example-project siano idonee ad accedere alle risorse in example.com. Per farlo, crea una policy di Principal Access Boundary in example.com che renda le entità idonee ad accedere alle risorse in example.com e associa la policy al set di entità per example-project.
  • Sposti example-project da example.com a cymbalgroup.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 formato organizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, dove ORGANIZATION_ID è l'ID numerico dell'organizzazione in cui è stata creata la policy sul confine di accesso dell'entità e PAB_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 valore etag deve corrispondere al valore archiviato in IAM. Se i valori etag non 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 campo resources. 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 formato RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, dove RESOURCE_TYPE/RESOURCE_ID è il tipo e l'ID della risorsa padre dell'associazione delle policy e BINDING_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 valore etag deve corrispondere al valore archiviato in IAM. Se i valori etag non 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}, dove PRINCIPAL_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 è sempre PRINCIPAL_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 campo policy.

  • 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