Questa pagina spiega come negare l'accesso alle entità impedendo loro di utilizzare autorizzazioni Identity and Access Management (IAM) specifiche.
In IAM, neghi l'accesso con le policy di negazione. Ogni policy di negazione è collegata a un'organizzazione, una cartella o un progetto Cloud de Confiance by S3NS . Una policy di negazione contiene regole di negazione, che identificano le entità ed elencano le autorizzazioni che le entità non possono utilizzare.
Le policy di negazione sono separate dalle policy di autorizzazione, note anche come policy IAM. Una policy di autorizzazione fornisce l'accesso alle risorse concedendo ruoli IAM alle entità.
Puoi gestire le policy di negazione con la console Cloud de Confiance , Google Cloud CLI o l'API REST IAM v2.
Prima di iniziare
Abilita l'API IAM, se non è già abilitata.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione
serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.Configurare l'autenticazione.
Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:
Console
Quando utilizzi la console Cloud de Confiance per accedere ai servizi e alle API Cloud de Confiance by S3NS , non devi configurare l'autenticazione.
gcloud
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initTerraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Cloud de Confiance .
Vai
Per utilizzare gli esempi di Go in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Cloud de Confiance .
Java
Per utilizzare gli esempi di Java in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Cloud de Confiance .
Node.js
Per utilizzare gli esempi di Node.js in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Cloud de Confiance .
Python
Per utilizzare gli esempi di Python in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Cloud de Confiance .
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, quindi accedi a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Cloud de Confiance .
-
Leggi la panoramica delle policy di negazione.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire le policy di negazione, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'organizzazione:
-
Per visualizzare le policy di negazione:
Deny Reviewer (
roles/iam.denyReviewer) -
Per visualizzare, creare, aggiornare ed eliminare le policy di negazione:
Deny Admin (
roles/iam.denyAdmin)
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 gestire le policy di negazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per gestire le policy di negazione sono necessarie le seguenti autorizzazioni:
-
Per visualizzare le policy di negazione:
-
iam.denypolicies.get -
iam.denypolicies.list
-
-
Per creare, aggiornare ed eliminare le policy di negazione:
-
iam.denypolicies.create -
iam.denypolicies.delete -
iam.denypolicies.get -
iam.denypolicies.update
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Identifica le autorizzazioni da negare
Prima di creare una policy di negazione, devi decidere quali autorizzazioni vuoi negare e a quali entità devono essere negate queste autorizzazioni.
Solo alcune autorizzazioni possono essere negate. Per un elenco delle autorizzazioni che puoi negare, consulta Autorizzazioni supportate nelle policy di negazione.
In alcuni casi, puoi anche utilizzare i gruppi di autorizzazioni per negare insiemi di autorizzazioni. Per saperne di più, consulta Gruppi di autorizzazioni.
Puoi gestire le policy di negazione con l'API REST v2, che richiede un formato speciale per i nomi delle autorizzazioni. Ad esempio, l'autorizzazione per creare un ruolo personalizzato IAM è denominata come segue:
v1API:iam.roles.createv2API:iam.googleapis.com/roles.create
Crea una policy di negazione
Puoi aggiungere policy di negazione a organizzazioni, cartelle e progetti. Ogni risorsa può avere fino a 500 policy di rifiuto.
Le policy di negazione contengono regole di negazione, che specificano quanto segue:
- Le autorizzazioni da negare.
- Le entità a cui sono negate queste autorizzazioni.
(Facoltativo) Entità esenti dal rifiuto delle autorizzazioni.
Ad esempio, puoi negare un'autorizzazione a un gruppo, ma esentare utenti specifici che appartengono a quel gruppo.
(Facoltativo) Un'espressione di condizione che specifica quando le entità non possono utilizzare le autorizzazioni. Nelle policy di negazione, le espressioni delle condizioni possono utilizzare solo funzioni per i tag delle risorse; altre funzioni e operatori non sono supportati.
Ogni risorsa può avere fino a 500 regole di negazione in tutte le policy di negazione associate.
Le policy di negazione vengono ereditate tramite la gerarchia delle risorse. Ad esempio, se neghi un'autorizzazione a livello di organizzazione, questa verrà negata anche alle cartelle e ai progetti all'interno dell'organizzazione, nonché alle risorse specifiche del servizio all'interno di ogni progetto.
Le policy di negazione hanno la precedenza sulle policy di autorizzazione. Se a un'entità viene concesso un ruolo che contiene un'autorizzazione specifica, ma una policy di negazione indica che l'entità non può utilizzare l'autorizzazione, l'entità non può utilizzare l'autorizzazione.
Console
Nella console Cloud de Confiance , vai alla scheda Nega nella pagina IAM.
Seleziona un progetto, una cartella o un'organizzazione.
Fai clic su Crea policy di negazione.
Nella sezione Nome policy, definisci l'ID della policy eseguendo una delle seguenti operazioni:
- Nel campo Nome visualizzato, inserisci un nome visualizzato per la policy. La compilazione di questo campo compila automaticamente il campo ID. Se vuoi modificare l'ID della policy, aggiorna il testo nel campo ID.
- Nel campo ID, inserisci un ID per la policy.
Nella sezione Regole di negazione, definisci le regole di negazione della policy. Ogni policy di negazione deve avere almeno una regola di negazione. Per aggiungere altre regole di negazione, fai clic su Aggiungi regola di negazione.
Per ogni regola di negazione, segui questi passaggi:
- Nel campo Entità negate, aggiungi una o più entità a cui vuoi impedire di utilizzare le autorizzazioni specificate. L'entità può essere uno dei tipi di entità negli identificatori delle entità per le policy di negazione, ad eccezione delle entità i cui ID iniziano con
deleted:. (Facoltativo) Nel campo Entità di eccezione, aggiungi le entità che vuoi che possano utilizzare le autorizzazioni specificate, anche se sono incluse nella sezione Entità negate. Ad esempio, puoi utilizzare questo campo per creare un'eccezione per utenti specifici che appartengono a un gruppo negato.
Nella sezione Autorizzazioni negate, aggiungi le autorizzazioni che vuoi negare. Le autorizzazioni devono essere supportate nelle policy di negazione.
In alcuni casi, puoi anche utilizzare i gruppi di autorizzazioni per negare insiemi di autorizzazioni. Per saperne di più, consulta Gruppi di autorizzazioni.
(Facoltativo) Aggiungi autorizzazioni di eccezione. Le autorizzazioni di eccezione sono autorizzazioni che non vuoi che vengano negate da questa regola di negazione, anche se sono incluse nell'elenco delle autorizzazioni negate. Ad esempio, puoi utilizzare questo campo per creare eccezioni per autorizzazioni specifiche in un gruppo di autorizzazioni.
Per aggiungere autorizzazioni di eccezione, fai clic su Autorizzazioni di eccezione, poi su Aggiungi un'altra autorizzazione e inserisci l'autorizzazione nel campo Autorizzazione 1. Continua ad aggiungere autorizzazioni finché non hai aggiunto tutte quelle che vuoi esentare dalla policy di negazione.
(Facoltativo) Aggiungi una condizione di negazione per specificare quando le entità non possono utilizzare l'autorizzazione. Per aggiungere una condizione di negazione, fai clic su Aggiungi condizione di negazione, quindi definisci i seguenti campi:
- Titolo: facoltativo. Un breve riepilogo dello scopo della condizione.
- Descrizione: facoltativa. Una descrizione più lunga della condizione.
Espressione di condizione: puoi aggiungere un'espressione di condizione utilizzando il Generatore di condizioni o l'Editor condizioni. Il generatore di condizioni fornisce un'interfaccia interattiva per selezionare il tipo di condizione, l'operatore e altri dettagli applicabili all'espressione. L'editor delle condizioni fornisce un'interfaccia basata su testo per inserire manualmente un'espressione utilizzando la sintassi Common Expression Language (CEL).
Le condizioni di negazione devono essere basate sui tag delle risorse. Altre funzioni e operatori non sono supportati.
- Nel campo Entità negate, aggiungi una o più entità a cui vuoi impedire di utilizzare le autorizzazioni specificate. L'entità può essere uno dei tipi di entità negli identificatori delle entità per le policy di negazione, ad eccezione delle entità i cui ID iniziano con
Fai clic su Crea.
gcloud
Per creare una policy di negazione per una risorsa, inizia creando un file JSON che contiene la policy. Una policy di negazione utilizza il seguente formato:
{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": DENY_RULE_1 }, { "denyRule": DENY_RULE_2 }, { "denyRule": DENY_RULE_N } ] }
Fornisci i seguenti valori:
POLICY_NAME: il nome visualizzato della policy di negazione.-
DENY_RULE_1,DENY_RULE_2,...DENY_RULE_N: le regole di negazione nella policy. Ogni regola di negazione può contenere questi campi:-
deniedPermissions: un elenco di autorizzazioni che le entità specificate non possono utilizzare. Le autorizzazioni devono essere supportate nelle policy di negazione.In alcuni casi, puoi anche utilizzare i gruppi di autorizzazioni per negare insiemi di autorizzazioni. Per saperne di più, consulta Gruppi di autorizzazioni.
-
exceptionPermissions: un elenco di autorizzazioni che le entità specificate possono utilizzare, anche se sono incluse indeniedPermissions. Ad esempio, puoi utilizzare questo campo per creare eccezioni per autorizzazioni specifiche in un gruppo di autorizzazioni. -
deniedPrincipals: un elenco di entità che non possono utilizzare le autorizzazioni specificate. Per scoprire come formattare gli identificatori delle entità, consulta Identificatori delle entità per le policy di negazione. -
exceptionPrincipals: (Facoltativo) Un elenco di entità che possono utilizzare le autorizzazioni specificate, anche se sono incluse indeniedPrincipals. Ad esempio, puoi utilizzare questo campo per creare un'eccezione per utenti specifici che appartengono a un gruppo negato. Per scoprire come formattare gli identificatori delle entità, consulta Identificatori delle entità per le policy di negazione. -
denialCondition: (Facoltativo) Un'espressione della condizione che specifica quando le entità non possono utilizzare le autorizzazioni. Contiene i seguenti campi:-
expression: un'espressione di condizione che utilizza la sintassi Common Expression Language (CEL). L'espressione deve utilizzare le funzioni CEL per la valutazione dei tag delle risorse. Altre funzioni e operatori non sono supportati. -
title: (Facoltativo) Un breve riepilogo dello scopo della condizione. -
description: (Facoltativo) Una descrizione più lunga della condizione.
-
Per esempi di regole di negazione, consulta Casi d'uso comuni.
-
Ad esempio, la seguente policy di negazione contiene una regola di negazione, che nega un'autorizzazione a Lucian:
{
"displayName": "My deny policy.",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create"
]
}
}
]
}
Quindi, esegui il comando gcloud iam policies create:
gcloud iam policies create POLICY_ID \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies \ --policy-file=POLICY_FILE
Fornisci i seguenti valori:
-
POLICY_ID: l'identificatore della policy di negazione. -
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. -
POLICY_FILE: il percorso del file JSON che contiene la policy di negazione.
In caso di esito positivo, questo comando non restituisce alcun output. Per stampare una risposta dettagliata, utilizza il flag --format=json.
Ad esempio, il seguente comando crea una policy di negazione denominata my-deny-policy per il progetto my-project, utilizzando un file denominato policy.json:
gcloud iam policies create my-deny-policy \
--attachment-point=cloudresourcemanager.googleapis.com/projects/my-project \
--kind=denypolicies \
--policy-file=policy.json
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del fornitore Terraform.
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.createPolicy crea una policy di negazione per una risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. POLICY_ID: un identificatore per la policy di negazione.POLICY_NAME: il nome visualizzato della policy di negazione.-
DENY_RULE_1,DENY_RULE_2,...DENY_RULE_N: le regole di negazione nella policy. Ogni regola di negazione può contenere questi campi:-
deniedPermissions: un elenco di autorizzazioni che le entità specificate non possono utilizzare. Le autorizzazioni devono essere supportate nelle policy di negazione.In alcuni casi, puoi anche utilizzare i gruppi di autorizzazioni per negare insiemi di autorizzazioni. Per saperne di più, consulta Gruppi di autorizzazioni.
-
exceptionPermissions: un elenco di autorizzazioni che le entità specificate possono utilizzare, anche se sono incluse indeniedPermissions. Ad esempio, puoi utilizzare questo campo per creare eccezioni per autorizzazioni specifiche in un gruppo di autorizzazioni. -
deniedPrincipals: un elenco di entità che non possono utilizzare le autorizzazioni specificate. Per scoprire come formattare gli identificatori delle entità, consulta Identificatori delle entità per le policy di negazione. -
exceptionPrincipals: (Facoltativo) Un elenco di entità che possono utilizzare le autorizzazioni specificate, anche se sono incluse indeniedPrincipals. Ad esempio, puoi utilizzare questo campo per creare un'eccezione per utenti specifici che appartengono a un gruppo negato. Per scoprire come formattare gli identificatori delle entità, consulta Identificatori delle entità per le policy di negazione. -
denialCondition: (Facoltativo) Un'espressione della condizione che specifica quando le entità non possono utilizzare le autorizzazioni. Contiene i seguenti campi:-
expression: un'espressione di condizione che utilizza la sintassi Common Expression Language (CEL). L'espressione deve utilizzare le funzioni CEL per la valutazione dei tag delle risorse. Altre funzioni e operatori non sono supportati. -
title: (Facoltativo) Un breve riepilogo dello scopo della condizione. -
description: (Facoltativo) Una descrizione più lunga della condizione.
-
Per esempi di regole di negazione, consulta Casi d'uso comuni.
-
Metodo HTTP e URL:
POST https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies?policyId=POLICY_ID
Corpo JSON della richiesta:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": DENY_RULE_1
},
{
"denyRule": DENY_RULE_2
},
{
"denyRule": DENY_RULE_N
}
]
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2022-06-28T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=",
"createTime": "2022-06-28T19:06:12.455151Z",
"updateTime": "2022-06-28T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create"
]
}
}
]
}
}
La risposta identifica un'operazione a lunga esecuzione. Puoi monitorare lo stato dell'operazione a lunga esecuzione per scoprire quando è stata completata. Per maggiori dettagli, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
Elenca le policy di negazione
Una risorsa può avere più policy di rifiuto. Puoi elencare tutte le policy di negazione associate a una risorsa, quindi visualizzare ogni policy di negazione per vedere le regole di negazione in ogni policy.
Console
Nella console Cloud de Confiance , vai alla scheda Nega nella pagina IAM.
Seleziona un progetto, una cartella o un'organizzazione.
La console Cloud de Confiance elenca tutte le policy di negazione applicabili al progetto, alla cartella o all'organizzazione. Sono incluse le policy di negazione ereditate da altre risorse. Per saperne di più sull'ereditarietà delle policy di negazione, consulta Ereditarietà delle policy di negazione.
gcloud
Per elencare le policy di negazione per una risorsa, esegui il comando gcloud iam policies list:
gcloud iam policies list \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies \ --format=json
Fornisci il seguente valore:
-
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco.
Ad esempio, il seguente comando elenca le policy di negazione associate a un'organizzazione il cui ID numerico è 123456789012:
gcloud iam policies list \
--attachment-point=cloudresourcemanager.googleapis.com/organizations/123456789012 \
--kind=denypolicies \
--format=json
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.listPolicies elenca le policy di negazione per una risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco.
Metodo HTTP e URL:
GET https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"policies": [
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1067607927478/denypolicies/test-policy",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"createTime": "2022-06-28T19:06:12.455151Z",
"updateTime": "2022-06-28T22:26:21.968687Z"
},
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1067607927478/denypolicies/test-policy-2",
"uid": "8465d710-ea20-0a08-d92c-b2a3ebf766ab",
"kind": "DenyPolicy",
"displayName": "My second deny policy.",
"createTime": "2022-06-05T19:21:53.595455Z",
"updateTime": "2022-06-05T19:21:53.595455Z"
},
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1067607927478/denypolicies/test-policy-3",
"uid": "ee9f7c2f-7e8c-b05c-d4e5-e03bfb2954e0",
"kind": "DenyPolicy",
"displayName": "My third deny policy.",
"createTime": "2022-06-05T19:22:26.770543Z",
"updateTime": "2022-06-05T19:22:26.770543Z"
}
]
}
Visualizza una policy di negazione
Puoi visualizzare una policy di negazione per vedere le regole di negazione che contiene, incluse le autorizzazioni negate e le entità che non possono utilizzarle.
Console
Nella console Cloud de Confiance , vai alla scheda Nega nella pagina IAM.
Seleziona un progetto, una cartella o un'organizzazione.
Nella colonna ID policy, fai clic sull'ID della policy che vuoi visualizzare.
La console Cloud de Confiance mostra i dettagli della policy di rifiuto, tra cui l'ID della policy, la data di creazione della policy e le regole di rifiuto nella policy di rifiuto.
gcloud
Per ottenere la policy di negazione per una risorsa, esegui il comando gcloud iam policies get:
gcloud iam policies get POLICY_ID \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies \ --format=json
Fornisci i seguenti valori:
-
POLICY_ID: l'identificatore della policy di negazione. -
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco.
Ad esempio, il seguente comando recupera la policy di negazione denominata my-deny-policy per il progetto my-project e la salva in un file denominato policy.json:
gcloud iam policies get my-deny-policy \
--attachment-point=cloudresourcemanager.googleapis.com/projects/my-project \
--kind=denypolicies \
--format=json \
> ./policy.json
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.get recupera una policy di negazione per una risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. POLICY_ID: un identificatore per la policy di negazione.
Metodo HTTP e URL:
GET https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies/POLICY_ID
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=",
"createTime": "2022-06-05T19:22:26.770543Z",
"updateTime": "2022-06-05T19:22:26.770543Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create"
]
}
}
]
}
Aggiorna una policy di negazione
Dopo aver creato una policy di negazione, puoi aggiornare le regole di negazione che contiene, nonché il nome visualizzato.
Puoi aggiornare una policy di negazione utilizzando la console Cloud de Confiance o uno dei seguenti metodi programmatici:
- gcloud CLI
- L'API REST
- Librerie client IAM
Aggiorna una policy di negazione utilizzando la console Cloud de Confiance
Nella console Cloud de Confiance , vai alla scheda Nega nella pagina IAM.
Seleziona un progetto, una cartella o un'organizzazione.
Nella colonna ID policy, fai clic sull'ID della policy che vuoi modificare.
Fai clic su Modifica.
Aggiorna la policy di negazione:
- Per modificare il nome visualizzato della policy, modifica il campo Nome visualizzato.
- Per modificare una regola di negazione esistente, fai clic sulla regola, quindi modifica le entità, le entità esenti, le autorizzazioni negate, le autorizzazioni esenti o la condizione di negazione della regola.
- Per rimuovere una regola di negazione, individua la regola di negazione che vuoi eliminare, quindi fai clic su Elimina nella riga corrispondente.
- Per aggiungere una regola di negazione, fai clic su Aggiungi regola di negazione, quindi crea una regola di negazione come faresti per creare una policy di negazione.
Al termine dell'aggiornamento della policy di negazione, fai clic su Salva.
Aggiorna una policy di negazione in modo programmatico
Per aggiornare una policy di negazione utilizzando gcloud CLI, l'API REST o le librerie client IAM, utilizza il pattern read-modify-write:
- Leggi la versione attuale delle norme.
- Modifica le informazioni nella policy in base alle tue esigenze.
- Scrivi la policy aggiornata.
Leggi la policy di negazione
gcloud
Per ottenere la policy di negazione per una risorsa, esegui il comando gcloud iam policies get:
gcloud iam policies get POLICY_ID \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies \ --format=json
Fornisci i seguenti valori:
-
POLICY_ID: l'identificatore della policy di negazione. -
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco.
Ad esempio, il seguente comando recupera la policy di negazione denominata my-deny-policy per il progetto my-project e la salva in un file denominato policy.json:
gcloud iam policies get my-deny-policy \
--attachment-point=cloudresourcemanager.googleapis.com/projects/my-project \
--kind=denypolicies \
--format=json \
> ./policy.json
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.get recupera una policy di negazione per una risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. POLICY_ID: un identificatore per la policy di negazione.
Metodo HTTP e URL:
GET https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies/POLICY_ID
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=",
"createTime": "2022-06-05T19:22:26.770543Z",
"updateTime": "2022-06-05T19:22:26.770543Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create"
]
}
}
]
}
Modifica la policy di negazione
Per modificare la policy di negazione, apporta modifiche alla copia della policy che hai letto in precedenza da IAM. Puoi aggiornare il nome visualizzato o aggiungere, modificare o rimuovere le regole di negazione. Le modifiche non diventano effettive finché non scrivi la policy aggiornata.
Ad esempio, potresti aggiungere un'autorizzazione a una regola di negazione esistente:
{ "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy", "uid": "6665c437-a3b2-a018-6934-54dd16d3426e", "kind": "DenyPolicy", "displayName": "My deny policy.", "etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=", "createTime": "2021-10-05T19:22:26.770543Z", "updateTime": "2021-10-05T19:22:26.770543Z", "rules": [ { "denyRule": { "deniedPrincipals": [ "principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com" ], "deniedPermissions": [ "iam.googleapis.com/roles.create", "iam.googleapis.com/roles.delete" ] } } ] }
Scrivi la policy di negazione aggiornata
Dopo aver modificato la policy di negazione localmente, devi scriverla in IAM.
Ogni policy di negazione contiene un campo etag che identifica la versione della policy.
La etag cambia ogni volta che aggiorni la policy. Quando scrivi la policy aggiornata, il valore etag nella richiesta deve corrispondere al valore etag corrente archiviato in IAM. Se i valori non corrispondono, la richiesta non va a buon fine. Questa funzionalità aiuta a evitare che le modifiche simultanee si sovrascrivano a vicenda.
gcloud
Per aggiornare la policy di negazione per una risorsa, esegui il comando gcloud iam policies update:
gcloud iam policies update POLICY_ID \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies \ --policy-file=POLICY_FILE
Fornisci i seguenti valori:
-
POLICY_ID: l'identificatore della policy di negazione. -
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. -
POLICY_FILE: il percorso del file JSON che contiene la policy di negazione.
In caso di esito positivo, questo comando non restituisce alcun output. Per stampare una risposta dettagliata, utilizza il flag --format=json.
Ad esempio, il seguente comando aggiorna una policy di negazione denominata my-deny-policy per il progetto my-project, utilizzando un file denominato policy.json:
gcloud iam policies update my-deny-policy \
--attachment-point=cloudresourcemanager.googleapis.com/projects/my-project \
--kind=denypolicies \
--policy-file=policy.json
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.update aggiorna una policy di negazione.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. POLICY_ID: un identificatore per la policy di negazione.-
POLICY: la policy di negazione aggiornata.Ad esempio, per aggiungere un'autorizzazione alla policy mostrata nel passaggio precedente, sostituisci
POLICYcon quanto segue:{ "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy", "uid": "6665c437-a3b2-a018-6934-54dd16d3426e", "kind": "DenyPolicy", "displayName": "My deny policy.", "etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=", "createTime": "2022-06-05T19:22:26.770543Z", "updateTime": "2022-06-05T19:22:26.770543Z", "rules": [ { "denyRule": { "deniedPrincipals": [ "principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com" ], "deniedPermissions": [ "iam.googleapis.com/roles.create", "iam.googleapis.com/roles.delete" ] } } ] }
Metodo HTTP e URL:
PUT https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies/POLICY_ID
Corpo JSON della richiesta:
POLICY
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy/operations/8b2d0ab2daf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2021-10-05T22:26:21.968687Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"etag": "MTgxNTIxNDE3NTYxNjQxODYxMTI=",
"createTime": "2022-06-05T19:22:26.770543Z",
"updateTime": "2022-06-05T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create",
"iam.googleapis.com/roles.delete"
]
}
}
]
}
}
La risposta identifica un'operazione a lunga esecuzione. Puoi monitorare lo stato dell'operazione a lunga esecuzione per scoprire quando è stata completata. Per maggiori dettagli, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
Elimina una policy di negazione
Se non vuoi più applicare le regole di una policy di negazione, puoi eliminarla.
Facoltativamente, puoi specificare l'etag per la versione della policy che stai eliminando. Se specifichi etag, deve corrispondere all'attuale etag archiviato da IAM. Se i valori non corrispondono, la richiesta non va a buon fine. Puoi utilizzare questa funzionalità per assicurarti di eliminare la policy prevista, anziché una versione aggiornata della stessa.
Se ometti etag dalla richiesta, IAM elimina la policy incondizionatamente.
Console
Nella console Cloud de Confiance , vai alla scheda Nega nella pagina IAM.
Seleziona un progetto, una cartella o un'organizzazione.
Nella colonna ID policy, fai clic sull'ID della policy che vuoi eliminare.
Fai clic su Elimina. Nella finestra di dialogo di conferma, fai clic su Conferma.
gcloud
Per eliminare una policy di negazione da una risorsa, esegui il comando gcloud iam policies delete:
gcloud iam policies delete POLICY_ID \ --attachment-point=ATTACHMENT_POINT \ --kind=denypolicies
Fornisci i seguenti valori:
-
POLICY_ID: l'identificatore della policy di negazione. -
ATTACHMENT_POINT: un identificatore della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco.
Facoltativamente, puoi aggiungere il flag --etag=ETAG. Sostituisci ETAG con il valore etag corrente per la policy di negazione.
In caso di esito positivo, questo comando non restituisce alcun output. Per stampare una risposta dettagliata, utilizza il flag --format=json.
Ad esempio, il seguente comando elimina una policy di negazione denominata my-deny-policy dal progetto my-project:
gcloud iam policies delete my-deny-policy \
--attachment-point=cloudresourcemanager.googleapis.com/projects/my-project \
--kind=denypolicies
Go
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Go.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Java.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Node.js.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per IAM, consulta Librerie client IAM. Per saperne di più, consulta la documentazione di riferimento dell'API IAM Python.
Per eseguire l'autenticazione in IAM, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Prima di iniziare.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
REST
Il metodo policies.delete elimina una policy di negazione da una risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. POLICY_ID: un identificatore per la policy di negazione.-
ETAG: (Facoltativo) Un identificatore della versione della policy. Se presente, questo valore deve corrispondere al valoreetagcorrente della policy.
Metodo HTTP e URL:
DELETE https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/denypolicies/POLICY_ID?etag=ETAG
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy/operations/8223fe308bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2021-10-05T19:45:00.133311Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy",
"kind": "DenyPolicy",
"displayName": "My deny policy.",
"etag": "MTc3NDU4MjM4OTY0MzU5MjQ5OTI=",
"createTime": "2022-06-28T19:06:12.455151Z",
"updateTime": "2022-07-05T19:45:00.133311Z",
"deleteTime": "2022-07-05T19:45:00.133311Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/lucian@example.com"
],
"deniedPermissions": [
"iam.googleapis.com/roles.create"
]
}
}
]
}
}
La risposta identifica un'operazione a lunga esecuzione. Puoi monitorare lo stato dell'operazione a lunga esecuzione per scoprire quando è stata completata. Per maggiori dettagli, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.
Controlla lo stato di un'operazione a lunga esecuzione
Quando utilizzi l'API REST o le librerie client, qualsiasi metodo che modifica una policy di negazione restituisce un'operazione a lunga esecuzione (LRO). L'operazione a lunga esecuzione monitora lo stato della richiesta e indica se la modifica della policy è stata completata.
Go
Gli esempi di codice in questa pagina mostrano come attendere il completamento di un'operazione a lunga esecuzione e poi accedere al risultato.
Java
Gli esempi di codice in questa pagina mostrano come attendere il completamento di un'operazione a lunga esecuzione e poi accedere al risultato.
Node.js
Gli esempi di codice in questa pagina mostrano come attendere il completamento di un'operazione a lunga esecuzione e poi accedere al risultato.
Python
Gli esempi di codice in questa pagina mostrano come attendere il completamento di un'operazione a lunga esecuzione e poi accedere al risultato.
REST
Il metodo policies.operations.get restituisce lo stato di un'operazione a lunga esecuzione.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
-
ENCODED_ATTACHMENT_POINT: un identificatore con codifica URL della risorsa a cui è collegata la policy di negazione. Per scoprire come formattare questo valore, consulta Punto di attacco. -
OPERATION_ID: l'identificatore dell'operazione. Ricevi questo identificatore nella risposta alla richiesta originale, come parte del nome dell'operazione. Utilizza il valore esadecimale alla fine del nome dell'operazione. Ad esempio,89cb3e508bf1ff01.
Metodo HTTP e URL:
GET https://iam.googleapis.com/v2/policies/ENCODED_ATTACHMENT_POINT/operations/OPERATION_ID
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F1234567890123/denypolicies/my-policy/operations/89cb3e508bf1ff01",
"done": true
}
Se il campo done dell'operazione non è presente, continua a monitorarne lo stato recuperando l'operazione ripetutamente. 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
- Identifica le autorizzazioni supportate nelle policy di negazione.
- Scopri il formato degli identificatori delle entità nelle policy di negazione.
- Scopri come risolvere i problemi di accesso con le policy di negazione.
- Scopri di più su come negare l'accesso alle entità.