Le policy sul confine di accesso dell'entità (PAB) ti consentono di limitare le risorse a cui un set di entità può accedere. Se non vuoi più che una policy sul confine di accesso dell'entità venga applicata a un set di entità, puoi eliminare l'associazione della policy che la associa al set di entità. Se vuoi rimuovere una policy sul confine di accesso dell'entità da tutti i set di entità a cui è associata, puoi eliminarla.
La rimozione di una policy sul confine di accesso dell'entità da un set di entità ha uno dei seguenti effetti:
- Se le entità nel set di entità non sono soggette ad altre policy sul confine di accesso dell'entità, potranno accedere a tutte le risorseGoogle Cloud .
- Se le entità nel set di entità sono soggette ad altre policy sul confine di accesso dell'entità, potranno accedere solo alle risorse di queste policy.
Prima di iniziare
Configurare l'autenticazione.
Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:
gcloud
Nella console Google Cloud , attiva Cloud Shell.
Nella parte inferiore della console Google Cloud , viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .
Leggi la panoramica delle policy sul confine di accesso dell'entità.
Ruoli richiesti per eliminare le policy sul confine di accesso dell'entità
Per ottenere l'autorizzazione necessaria per eliminare le policy sul confine di accesso dell'entità, chiedi all'amministratore di concederti il ruolo IAM Amministratore del confine di accesso dell'entità (roles/iam.principalAccessBoundaryAdmin) nella tua organizzazione.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene l'autorizzazione iam.principalaccessboundarypolicies.delete, necessaria per eliminare le policy sul confine di accesso dell'entità.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Ruoli richiesti per eliminare le associazioni delle policy di Principal Access Boundary
Le autorizzazioni necessarie per eliminare le associazioni delle policy per le policy sul confine di accesso dell'entità dipendono dal set di entità associato alla policy.
Per ottenere le autorizzazioni necessarie per eliminare le associazioni delle policy per i Principal Access Boundary, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Confine di accesso dell'entità Utente (
roles/iam.principalAccessBoundaryUser) nella tua organizzazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità della forza lavoro:
IAM Workforce Pool Admin (
roles/iam.workforcePoolAdmin) sul pool di identità della forza lavoro di destinazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità del workload:
IAM Workload Identity Pool Admin (
roles/iam.workloadIdentityPoolAdmin) nel progetto proprietario del pool di identità del workload di destinazione -
Ottenere lo stato di un'operazione a lunga esecuzione per l'eliminazione di un'associazione che fa riferimento a un pool di identità del workload:
IAM Operation Viewer (
roles/iam.operationViewer) sul progetto proprietario del pool di identità del workload di destinazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate a un dominio Google Workspace:
Workspace Pool IAM Admin (
roles/iam.workspacePoolAdmin) nell'organizzazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un progetto:
Project IAM Admin (
roles/resourcemanager.projectIamAdmin) sul progetto -
Ottieni lo stato di un'operazione a lunga esecuzione per l'eliminazione di un'associazione che fa riferimento al set di entità di un progetto:
IAM Operation Viewer (
roles/iam.operationViewer) sul progetto -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di una cartella:
Amministratore IAM cartella (
roles/resourcemanager.folderIamAdmin) sulla cartella -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un'organizzazione:
Organization Administrator (
roles/resourcemanager.organizationAdmin) sull'organizzazione
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per eliminare le associazioni delle policy per i confini di accesso delle entità. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eliminare le associazioni delle policy per le policy dei limiti di accesso delle entità sono necessarie le seguenti autorizzazioni:
-
iam.principalaccessboundarypolicies.unbindsull'organizzazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità della forza lavoro:
iam.workforcePools.deletePolicyBindingsul pool di identità della forza lavoro di destinazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità del workload:
iam.workloadIdentityPools.deletePolicyBindingnel progetto proprietario del pool di identità del workload di destinazione -
Recupera lo stato di un'operazione a lunga esecuzione per l'eliminazione di un'associazione che fa riferimento a un pool di identità del workload:
iam.operations.getsul progetto proprietario del pool di identità del workload di destinazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate a un dominio Google Workspace:
iam.workspacePools.deletePolicyBindingnell'organizzazione -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un progetto:
resourcemanager.projects.deletePolicyBindingsul progetto -
Recupera lo stato di un'operazione a lunga esecuzione per l'eliminazione di un'associazione che fa riferimento al set di entità di un progetto:
iam.operations.getsul progetto -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di una cartella:
resourcemanager.folders.deletePolicyBindingsulla cartella -
Elimina le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un'organizzazione:
resourcemanager.organizations.deletePolicyBindingsull'organizzazione
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Preparati a rimuovere una policy sul confine di accesso dell'entità
Prima di rimuovere una policy sul confine di accesso dell'entità, decidi quale dei seguenti obiettivi vuoi raggiungere:
- Rendi le entità di un set di entità idonee ad accedere a tutte le risorse
- Riduci il numero di risorse a cui le entità di un set di entità possono accedere
Le sezioni seguenti descrivono i passaggi da seguire per raggiungere ciascuno di questi obiettivi.
Rendi le entità idonee ad accedere a tutte le risorse
Se vuoi rendere le entità di un set di entità idonee ad accedere a tutte le risorse, segui questi passaggi:
- Identifica tutte le policy sul confine di accesso dell'entità associate al set di entità.
- Rimuovi tutte le policy sul confine di accesso dell'entità associate al set di entità eliminando le associazioni delle policy pertinenti.
Se un'entità non è soggetta a policy sul confine di accesso dell'entità, può accedere a tutte le risorse Google Cloud .
L'idoneità ad accedere a una risorsa non significa necessariamente che un utente sia in grado di accedervi. Per saperne di più, consulta Valutazione delle policy.
Riduci le risorse a cui le entità possono accedere
Se le entità di un set di entità sono soggette a più policy sul confine di accesso dell'entità, puoi ridurre il numero di risorse a cui le entità possono accedere rimuovendo una o più policy sul confine di accesso dell'entità a cui sono soggette. Tuttavia, non rimuovere mai tutte le policy sul confine di accesso dell'entità a cui sono soggette le entità. Se lo fai, le entità potranno accedere a tutte le risorse Google Cloud .
Per rimuovere una policy sul confine di accesso dell'entità assicurandoti che le entità di un set di entità siano sempre soggette ad almeno una policy sul confine di accesso dell'entità, segui questi passaggi:
- Identifica tutte le policy sul confine di accesso dell'entità associate al set di entità.
Identifica le policy sul confine di accesso dell'entità che contengono solo le risorse a cui vuoi che le entità nel set di entità possano accedere. Queste sono le policy che non rimuoverai dal set di entità.
Se non hai policy di questo tipo, crea una nuova policy sul confine di accesso dell'entità con solo le risorse a cui vuoi che le entità possano accedere. Poi, collega la policy al set di entità.
Identifica le policy sul confine di accesso dell'entità che contengono risorse a cui non vuoi che le entità nel set di entità possano accedere. Poi, rimuovi queste policy sul confine di accesso dell'entità eliminando l'associazione delle policy pertinente.
Se vuoi ridurre l'accesso per entità specifiche, aggiungi una condizione all'associazione della policy anziché eliminarla.
Se vuoi ridurre il numero di risorse a cui un'entità può accedere, ma non vuoi rimuovere nessuna policy sul confine di accesso dell'entità, puoi modificare le policy sul confine di accesso dell'entità a cui è soggetta l'entità. Per scoprire come modificare le policy sul confine di accesso dell'entità, consulta Modifica le policy sul confine di accesso dell'entità.
Testa l'eliminazione di una policy o di un'associazione di Principal Access Boundary
Prima di eliminare una policy o un'associazione di Principal Access Boundary, ti consigliamo di testare l'impatto della modifica sull'accesso delle entità. Puoi utilizzare Policy Simulator per simulare un'eliminazione e comprendere il suo potenziale impatto.
Per testare un'eliminazione, consulta le seguenti procedure nella documentazione di Policy Intelligence:
- Simula l'eliminazione delle regole del confine di accesso dell'entità
- Simula l'eliminazione di una policy di Principal Access Boundary
- Simula l'eliminazione di un'associazione per una policy di Principal Access Boundary
Per scoprire di più sul test delle policy sul confine di accesso dell'entità con Policy Simulator, consulta Policy Simulator per le policy sul confine di accesso dell'entità.
Rimuovi una policy sul confine di accesso dell'entità da un set di entità
Prima di rimuovere una policy di Principal Access Boundary da un set di entità, preparati alla rimozione della policy. Poi, rimuovi la policy eliminando l'associazione che la collega al set di entità.
Puoi eliminare un'associazione delle policy utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.
Console
Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.
Seleziona l'organizzazione proprietaria della policy sul confine di accesso dell'entità di cui vuoi eliminare l'associazione.
Fai clic sull'ID della policy sul confine di accesso dell'entità di cui vuoi eliminare le associazioni.
Fai clic sulla scheda Associazioni.
Trova l'ID dell'associazione che vuoi eliminare. Nella riga dell'associazione, fai clic su Azioni, quindi su Elimina associazione.
Nella finestra di dialogo di conferma, fai clic su Elimina.
gcloud
Il comando gcloud iam policy-bindings delete elimina un'associazione di policy.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
BINDING_ID: l'ID dell'associazione delle policy che vuoi eliminare, ad esempioexample-binding. -
RESOURCE_TYPE: il tipo di risorsa di Resource Manager (progetto, cartella o organizzazione) di cui l'associazione della policy è un elemento secondario. Utilizza il valoreproject,folderoorganization.Il tipo di risorsa dipende dall'entità impostata nell'associazione della policy. Per capire quale tipo di risorsa utilizzare, consulta Tipi di entità supportati.
-
RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione di cui l'associazione delle policy è un elemento secondario. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global
La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
Il metodo policyBindings.delete elimina un'associazione di policy.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
RESOURCE_TYPE: il tipo di risorsa di Resource Manager (progetto, cartella o organizzazione) di cui l'associazione della policy è un elemento secondario. Utilizza il valoreprojects,foldersoorganizations.Il tipo di risorsa dipende dall'entità impostata nell'associazione della policy. Per capire quale tipo di risorsa utilizzare, consulta Tipi di entità supportati.
-
RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione di cui l'associazione delle policy è un elemento secondario. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
BINDING_ID: l'ID dell'associazione delle policy che vuoi eliminare, ad esempioexample-binding.
Metodo HTTP e URL:
DELETE https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID
Per inviare la richiesta, espandi una di queste opzioni:
La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Elimina una policy sul confine di accesso dell'entità
Prima di eliminare una policy sul confine di accesso dell'entità, ti consigliamo di identificare ed eliminare tutte le associazioni delle policy sul confine di accesso dell'entità che fanno riferimento alla policy sul confine di accesso dell'entità.
Se elimini una policy sul confine di accesso dell'entità con associazioni di policy esistenti, queste verranno eliminate. Tuttavia, finché non vengono eliminati, le associazioni delle policy vengono comunque conteggiate ai fini del limite di 10 associazioni che possono fare riferimento a un singolo set di entità.
Puoi eliminare una policy dei confini di accesso dell'entità utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.
Console
Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.
Seleziona l'organizzazione proprietaria della policy dei confini di accesso dell'entità che vuoi eliminare.
Trova l'ID della policy che vuoi eliminare. Nella riga della policy, fai clic su Azioni, quindi su Elimina policy.
Nella finestra di dialogo di conferma, conferma che vuoi eliminare la policy:
- Per eliminare la policy solo se non ha associazioni, fai clic su Elimina.
- Per eliminare la policy e tutte le associazioni correlate, seleziona la casella di controllo Forza l'eliminazione della policy, quindi fai clic su Elimina.
gcloud
Il comando gcloud iam gcloud iam principal-access-boundary-policies delete elimina una policy di Principal Access Boundary e tutte le associazioni correlate.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
PAB_POLICY_ID: l'ID della policy Principal Access Boundary che vuoi eliminare, ad esempioexample-policy. ORG_ID: l'ID dell'organizzazione proprietaria della policy dei confini di accesso dell'entità. Gli ID organizzazione sono numerici, ad esempio123456789012.FORCE_FLAG: facoltativo. Per forzare il comando a eliminare una policy, anche se è presente un riferimento a questa policy in associazioni di policy esistenti, utilizza il flag--force. Se questo flag non è impostato e la policy è indicata in associazioni di policy esistenti, il comando non riesce.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID \ --organization=ORG_ID --location=global FORCE_FLAG
Windows (PowerShell)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ` --organization=ORG_ID --location=global FORCE_FLAG
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ^ --organization=ORG_ID --location=global FORCE_FLAG
La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete... Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted principalAccessBoundaryPolicy [example-policy].
REST
Il metodo principalAccessBoundaryPolicies.delete elimina una policy di Principal Access Boundary e tutte le associazioni correlate.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
ORG_ID: l'ID dell'organizzazione proprietaria della policy dei confini di accesso dell'entità. Gli ID organizzazione sono numerici, ad esempio123456789012.-
PAB_POLICY_ID: l'ID della policy Principal Access Boundary che vuoi eliminare, ad esempioexample-policy. -
FORCE_DELETE: (Facoltativo) Per forzare la richiesta di eliminazione della policy, anche se viene fatto riferimento alla policy nelle associazioni di policy esistenti, aggiungi il parametro di queryforce=true. Se questo parametro di query non è impostato e la policy è indicata in associazioni di policy esistenti, la richiesta non va a buon fine.
Metodo HTTP e URL:
DELETE https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?FORCE_DELETE
Per inviare la richiesta, espandi una di queste opzioni:
La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-policy",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Controlla lo stato di un'operazione a lunga esecuzione
Quando utilizzi l'API REST o le librerie client, qualsiasi metodo che modifica una policy o un'associazione restituisce un'operazione a lunga esecuzione (LRO). L'operazione a lunga esecuzione monitora lo stato della richiesta e indica se la modifica della policy o dell'associazione è stata completata.
REST
Il metodo operations.get restituisce lo stato di un'operazione a lunga esecuzione.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
OPERATION_NAME: il nome completo dell'operazione. Ricevi questo nome nella risposta alla tua richiesta originale.Il nome dell'operazione ha il seguente formato:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
Metodo HTTP e URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
Se il campo done dell'operazione non è presente, continua a monitorare lo stato recuperando ripetutamente l'operazione. Utilizza il backoff esponenziale troncato per introdurre un ritardo tra ogni richiesta. Quando il campo done è impostato su true, l'operazione è completata e puoi interrompere il recupero dell'operazione.
Passaggi successivi
- Creare e applicare le policy sul confine di accesso dell'entità
- Visualizza le policy sul confine di accesso dell'entità
- Modifica le policy sul confine di accesso dell'entità