Le Unified Access Policies (UAP) ti consentono di concedere e negare l'accesso alle risorseGoogle Cloud . A differenza delle policy di autorizzazione e di negazione, le UAP consentono di concedere e negare l'accesso nella stessa policy, consentendo una gestione semplificata delle policy. Le UAP sono anche riutilizzabili, il che significa che puoi applicare la stessa UAP a più risorse.
Come funzionano le policy Unified Access Policies
Per concedere o negare l'accesso in IAM, devi specificare chi deve essere autorizzato o meno a fare cosa su quale risorsa.
Nelle UAP, specifichi chi deve essere autorizzato o meno a fare cosa creando regole UAP. Ogni regola elenca un insieme di entità, un insieme di ruoli e autorizzazioni e un effetto. L'effetto (allow o deny) specifica se alle entità elencate vengono concessi i ruoli e le autorizzazioni della regola o se viene impedito loro di utilizzare le autorizzazioni della regola. Puoi avere fino a 100 regole in un singolo UAP.
Per specificare la risorsa per cui un UAP controlla l'accesso, utilizza un'associazione UAP per associare l'UAP a una risorsa. Puoi associare un singolo criterio di accesso utente (UAP) a un massimo di 5 risorse. A una singola risorsa possono essere associate fino a 5 policy.
Casi d'uso
In IAM, esistono diversi tipi di policy che puoi utilizzare per consentire e negare l'accesso:
- Per consentire l'accesso, puoi utilizzare le policy di autorizzazione o le regole di autorizzazione della piattaforma di accesso unificato.
- Per negare l'accesso, puoi utilizzare le policy di negazione o le regole di negazione della piattaforma di accesso unificato.
Se utilizzi già policy di autorizzazione o di negazione per controllare l'accesso, ti consigliamo di continuare a utilizzarle. Questi tipi di policy sono supportati anche in Policy Troubleshooter, che semplifica la comprensione della causa principale degli errori di accesso.
Utilizza gli UAP nelle seguenti circostanze:
- Stai configurando una nuova organizzazione e prevedi di utilizzare le policy di accesso degli utenti per controllare l'accesso in tutta l'organizzazione.
- Vuoi configurare un controllo granulare dell'accesso utilizzando le condizioni UAP.
Regole delle Unified Access Policies
Le policy di accesso unificato sono costituite da regole di autorizzazione e di negazione. Queste regole contengono i seguenti componenti:
Un effetto: indica se la regola concede o nega l'accesso. Le regole che concedono l'accesso sono chiamate regole di autorizzazione. Le regole che negano l'accesso sono chiamate regole di negazione.
Un insieme di entità: le entità, ad esempio utenti, gruppi o service account, che vuoi includere nella regola. Nelle regole di autorizzazione, a queste entità viene concesso l'accesso. Nelle regole di negazione, a queste entità viene negato l'accesso.
Un elenco di ruoli e autorizzazioni: i ruoli e le autorizzazioni che vuoi includere nella regola. Nelle regole di autorizzazione, queste autorizzazioni vengono concesse. Nelle regole di negazione, queste autorizzazioni vengono negate.
Facoltativo: un'espressione di condizione: un'espressione di condizione IAM che specifica le condizioni che devono essere vere affinché la regola venga applicata. Per saperne di più, consulta Condizioni nelle policy di accesso degli utenti in questa pagina.
Entità nelle regole delle Unified Access Policies
Per specificare le entità da includere nella regola, definisci quanto segue:
- Entità incluse: le entità che vuoi includere nella regola.
- Entità escluse: le entità che vuoi escludere dalla regola, anche se fanno parte di un gruppo nell'elenco delle entità incluse.
Con questi due elenchi, puoi specificare in modo conciso quali entità vuoi includere nella regola. Ad esempio, supponiamo che tu stia creando una regola di autorizzazione per concedere l'accesso agli utenti in example.com. Se vuoi concedere l'accesso a tutti i membri del gruppo all@example.com, ad eccezione dell'utente reduced-access@example.com, devi aggiungere all@example.com all'elenco delle entità incluse e reduced-access@example.com all'elenco delle entità escluse.
Ruoli e autorizzazioni nelle regole delle policy di accesso unificato
Per creare un elenco esatto delle autorizzazioni da includere nella regola, definisci quanto segue:
- Autorizzazioni incluse: le autorizzazioni che vuoi includere nella regola.
- Autorizzazioni escluse: le autorizzazioni che non vuoi includere nella regola, anche se si trovano in un ruolo o in un gruppo di autorizzazioni nell'elenco delle autorizzazioni incluse.
Per aggiungere autorizzazioni all'elenco delle autorizzazioni incluse o escluse, puoi fare riferimento a uno dei seguenti elementi:
Autorizzazioni: nomi delle singole autorizzazioni nel formato del nome di dominio completo (FQDN). Ad esempio,
cloudresourcemanager.googleapis.com/projects.get.Ruoli (solo regole di autorizzazione): nomi dei ruoli predefiniti, ad esempio
roles/logging.logsViewer. Se includi un nome di ruolo in una regola, la regola include tutte le autorizzazioni di quel ruolo. Per visualizzare tutte le autorizzazioni di un ruolo, consulta il riferimento per ruoli e autorizzazioni.Nel file JSON UAP, questi nomi sono sempre preceduti da
role:, ad esempiorole:roles/logging.logsViewer.I ruoli sono consentiti solo nelle regole di autorizzazione. I ruoli personalizzati non sono supportati in nessuna regola.
Gruppi di autorizzazioni: insiemi di autorizzazioni, ad esempio
aiplatform.googleapis.com/*.*. I gruppi di autorizzazioni sono insiemi di autorizzazioni che corrispondono a un pattern specificato. Esistono alcune limitazioni relative ai gruppi di autorizzazioni a cui puoi fare riferimento e alle autorizzazioni incluse in questi gruppi. Per maggiori informazioni, consulta Gruppi di autorizzazioni in questa pagina.
Gruppi di autorizzazioni
I gruppi di autorizzazioni sono insiemi di autorizzazioni che corrispondono a un pattern specificato. Puoi utilizzare un gruppo di autorizzazioni per concedere o negare insiemi di autorizzazioni correlate, ad esempio puoi negare tutte le autorizzazioni per un singolo servizio o concedere tutte le autorizzazioni che terminano con un determinato verbo.
I gruppi di autorizzazioni funzionano in modo diverso nelle regole di autorizzazione e di negazione. Le sezioni seguenti spiegano come utilizzare i gruppi di autorizzazioni in ogni tipo di regola.
Gruppi di autorizzazioni nelle regole di autorizzazione
Per identificare un gruppo di autorizzazioni in una regola di autorizzazione, sostituisci una o più sezioni di un nome di autorizzazione con un carattere jolly (*). Le autorizzazioni incluse in ogni gruppo dipendono dalla posizione del carattere jolly:
SERVICE_FQDN/RESOURCE.*: include tutte le autorizzazioni per la risorsa specificata.SERVICE_FQDN/*.*: include tutte le autorizzazioni per il servizio specificato.SERVICE_FQDN/*.VERB: include tutte le autorizzazioni per un servizio che terminano con il verbo specificato.*/*.VERB: include tutte le autorizzazioni che terminano con il verbo specificato.*: include tutte le autorizzazioni. Questo valore è consentito solo quando vengono elencate le autorizzazioni incluse, non quelle escluse.
I gruppi di autorizzazioni includono solo le autorizzazioni supportate nei ruoli personalizzati. Altre autorizzazioni non sono incluse, anche se corrispondono al formato specificato.
Per scoprire quali autorizzazioni sono supportate nei ruoli personalizzati, consulta Livelli di assistenza per le autorizzazioni nei ruoli personalizzati.
Le autorizzazioni elencate in quella pagina non utilizzano lo stesso formato delle autorizzazioni nei criteri di accesso degli utenti:
- I ruoli personalizzati utilizzano il formato
v1per i nomi delle autorizzazioni, ovveroSERVICE_ID.RESOURCE.VERB. - Le UAP utilizzano il formato del nome di dominio completo per i nomi delle autorizzazioni, ovvero
SERVICE_FQDN/RESOURCE.VERB.
Tuttavia, i valori di SERVICE_ID e SERVICE_FQDN sono in genere simili. Nella maggior parte dei casi, il valore di SERVICE_FQDN è il valore di SERVICE_ID dell'API v1, seguito da .googleapis.com. Ad esempio, l'autorizzazione per eliminare un ruolo può essere scritta
nei seguenti modi:
- Formato
v1:iam.roles.delete - Formato del nome di dominio completo:
iam.googleapis.com/roles.delete
Puoi utilizzare questa somiglianza per tradurre tra i due formati quando esamini i gruppi di autorizzazioni per le regole di autorizzazione.
Esistono alcune eccezioni a questa regola. Per visualizzare queste eccezioni, consulta
l'elenco delle autorizzazioni supportate nelle policy di negazione
e cerca IAM v1 API nel campo del filtro.
Gruppi di autorizzazioni nelle regole di negazione
Le regole di negazione supportano solo determinati gruppi di autorizzazioni. I gruppi di autorizzazioni supportati sono elencati in Autorizzazioni supportate nelle policy di negazione. Gli identificatori dei gruppi di autorizzazioni supportati sostituiscono una o più sezioni di un nome di autorizzazione con un carattere jolly (*). Le autorizzazioni incluse in ogni gruppo dipendono dalla posizione del carattere jolly:
SERVICE_FQDN/RESOURCE.*: nega tutte le autorizzazioni per la risorsa specificata.SERVICE_FQDN/*.*: nega tutte le autorizzazioni per il servizio specificato.SERVICE_FQDN/*.VERB: nega tutte le autorizzazioni per un servizio che terminano con il verbo specificato.
I gruppi di autorizzazioni includono tutte le autorizzazioni attuali e future che corrispondono al pattern specificato. Ad esempio, immagina di utilizzare il gruppo di autorizzazioni
example.googleapis.com/exampleResource.* per negare a un utente tutte le autorizzazioni per
il tipo di risorsa exampleResource. Se example.googleapis.com aggiunge una nuova autorizzazione per il tipo di risorsa exampleResource, ad esempio example.googleapis.com/exampleResource.newPermission, all'utente verrà automaticamente negata la nuova autorizzazione.
Puoi utilizzare i caratteri jolly solo nei gruppi di autorizzazioni supportati. L'utilizzo di caratteri jolly in altri nomi di autorizzazioni nelle regole di negazione non è supportato.
Crea policy di accesso unificato
Puoi creare UAP in un progetto, una cartella o un'organizzazione. La risorsa in cui crei l'UAP diventa la risorsa principale dell'UAP. Tuttavia, l'UAP non ha alcun effetto finché non lo applichi.
Il publisher principale della piattaforma di annunci utente viene visualizzato nel nome della piattaforma di annunci utente. I nomi delle policy hanno il formato
RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID,
dove i segnaposto rappresentano quanto segue:
RESOURCE_TYPE: il tipo di risorsa in cui è stato creato l'UAP. Questo valore èprojects,foldersoorganizations.RESOURCE_ID: l'ID della risorsa in cui è stato creato l'UAP.POLICY_ID: l'ID alfanumerico della piattaforma di attivazione utente.
Ad esempio, se crei un UAP example-policy nel progetto example-project, la risorsa principale dell'UAP è example-project e il nome dell'UAP è projects/example-project/locations/global/accessPolicies/example-policy.
Dove creare le policy di accesso unificato
La risorsa padre di un UAP non influisce sulle risorse a cui puoi applicare l'UAP. Tuttavia, influisce su chi ha l'autorizzazione per visualizzare e modificare l'UAP. Per garantire che gli utenti appropriati dispongano dell'autorizzazione per visualizzare e modificare le policy di accesso degli utenti appropriate, ti consigliamo di scegliere una risorsa principale che rifletta al meglio l'ambito della policy di accesso degli utenti.
Ad esempio, se vuoi applicare una policy di accesso utente alla tua organizzazione, ti consigliamo di crearla nell'organizzazione.
Applica le policy alle risorse
Per applicare una UAP, devi creare un binding. Ogni associazione specifica un UAP e una risorsa a cui associarlo. Dopo aver creato l'associazione, le regole della UAP diventano effettive per la risorsa e per tutti i suoi discendenti.
Ad esempio, immagina di avere un UAP,
compute-access-management. Questo
UAP concede il ruolo Compute Editor
(roles/compute.editor) al gruppo compute-users@example.com e nega le
autorizzazioni compute.googleapis.com/instances.* a tutti gli utenti, ad eccezione di
compute-users@example.com.
Senza associazioni, questa UAP non ha alcun effetto.
Vuoi che questa policy di accesso utente si applichi a tutte le risorse della tua organizzazione example.com, quindi crei un'associazione che collega la policy di accesso utente compute-access-management a example.com. Dopo aver creato l'associazione, la UAP ha i seguenti effetti:
- I membri di
compute-users@example.compossono utilizzare le autorizzazioni del ruolo Compute Editor per accedere alle risorse inexample.com. - A tutti gli utenti che non sono membri di
compute-users@example.comviene impedito di utilizzare le autorizzazioni relative alle istanze per accedere alle risorse inexample.com.
Risorse supportate
La tabella seguente elenca le risorse a cui puoi associare gli UAP. Ogni riga contiene quanto segue:
- Il tipo di risorsa
- Il formato degli ID per la risorsa
- La risorsa di Resource Manager (progetto, cartella o organizzazione) che è l'elemento principale delle associazioni per quel tipo di risorsa
| Risorsa | ID risorsa | Risorsa padre delle associazioni |
|---|---|---|
| Progetti di Resource Manager | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
Il progetto nell'associazione |
| Cartelle di Resource Manager | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
La cartella nell'associazione |
| Organizzazioni di Resource Manager | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
L'organizzazione nell'associazione |
| Applicazioni AI di Agent Registry | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
Il progetto padre dell'applicazione |
| Agent Gateway dell'API Network Services | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
Il progetto padre del gateway |
Disabilita la creazione di associazioni
Se vuoi disattivare la creazione di associazioni nella tua organizzazione, puoi applicare il vincolo della policy dell'organizzazione iam.managed.disableAccessPolicyBinding nella tua organizzazione. Questo vincolo impedisce alle entità della tua organizzazione di creare associazioni per gli indirizzi UAP.
Per scoprire come attivare o disattivare questo vincolo, consulta Utilizzo dei vincoli gestiti in una policy dell'organizzazione.
Ereditarietà delle policy
Se associ una policy di accesso utente a un progetto, una cartella o un'organizzazione, la policy viene ereditata tramite la gerarchia delle risorse.
La gerarchia delle risorse è costituita dall'organizzazione (radice) in alto, seguita dalle cartelle (facoltative) per il raggruppamento e poi dai progetti, che contengono risorse specifiche del servizio come le macchine virtuali di Compute Engine e i bucket Cloud Storage.
In questa gerarchia, i progetti, le cartelle e le organizzazioni sono risorse padre. In altre parole, sono risorse che contengono altre risorse:
- I progetti contengono risorse specifiche per i servizi.
- Le cartelle contengono altre cartelle, progetti e le risorse dei progetti.
- Le organizzazioni contengono cartelle, progetti e le risorse dei progetti.
Le risorse contenute in una risorsa padre sono i discendenti di quella risorsa.
Quando associ una policy di accesso utente a una risorsa padre, questa policy viene applicata alla risorsa padre e a tutti i discendenti della risorsa. In altre parole, la UAP viene ereditata dai discendenti della risorsa.
L'ereditarietà delle policy ti consente di applicare le policy a grandi insiemi di risorse con una singola associazione. Ad esempio, supponiamo che tu crei una policy di accesso utente che assegna a taylor@example.com il ruolo Amministratore Compute Engine (roles/compute.admin). La policy di accesso utente nega anche a noam@example.com l'autorizzazione compute.googleapis.com/instances.delete.
Vuoi che questa policy di accesso utente sia efficace per tutte le risorse della tua organizzazione, example.com. Per farlo, associa questa policy di accesso utente alla risorsa della tua organizzazione. Dopo aver associato la UAP all'organizzazione, la UAP viene ereditata da tutte le risorse dell'organizzazione.
L'associazione della piattaforma UAP all'organizzazione ha i seguenti effetti:
taylor@example.compuò utilizzare le autorizzazioni del ruolo Amministratore Compute Engine per accedere a qualsiasi risorsa inexample.com.noam@example.comnon può utilizzare l'autorizzazionecompute.googleapis.com/instances.deletesu nessuna risorsa inexample.com, anche se una policy di accesso utente su una risorsa discendente concede l'accesso.
Se vuoi che una policy di accesso uniforme si applichi a un numero inferiore di risorse, puoi associarla a un livello inferiore della gerarchia delle risorse, ad esempio a un progetto o a una risorsa specifica per un servizio supportato.
Associazioni tra organizzazioni
Non puoi creare un binding tra organizzazioni per un UAP. Un'associazione tra organizzazioni è un'associazione che associa un UAP di un'organizzazione a una risorsa di un'altra organizzazione.
IAM elimina periodicamente tutte le associazioni tra organizzazioni esistenti. Le associazioni tra organizzazioni possono verificarsi quando sposti un progetto da un'organizzazione a un'altra. Ad esempio, prendi in considerazione la seguente situazione:
- Hai un progetto,
example-project, nell'organizzazioneexample.com. - Crei un UAP nel progetto
example-projecte lo associ aexample-project. - Sposti
example-projectdaexample.comacymbalgroup.com.
In questo caso, lo spostamento del progetto crea un'associazione tra organizzazioni. Questo perché la UAP in example.com è associata a una risorsa 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 UAP associate alle risorse della loro organizzazione.
Associazioni per le policy di accesso unificato eliminate
In genere, devi eliminare le associazioni per un UAP prima di eliminarlo. I tentativi di eliminare una policy di accesso utente con associazioni esistenti generano un errore.
Tuttavia, se vuoi eliminare un criterio di accesso uniforme senza eliminare le associazioni esistenti, puoi forzare l'eliminazione del criterio.
L'eliminazione forzata di un UAP lo rimuove da tutte le risorse a cui è associato. Le associazioni che fanno riferimento alla UAP verranno eliminate. Tuttavia, finché non vengono eliminate, le associazioni vengono comunque conteggiate ai fini del limite del numero di associazioni che possono fare riferimento a una singola risorsa.
Condizioni nelle policy di accesso unificato
Le condizioni IAM consentono di definire e applicare forzatamente il controllo dell'accesso condizionale basato su attributi per le risorse Google Cloud . Nelle UAP, puoi aggiungere condizioni alle singole regole per controllare quando vengono applicate. Non puoi aggiungere condizioni alle associazioni UAP.
Le condizioni sono composte da un titolo, una descrizione e un'espressione booleana. Se l'espressione restituisce true per la richiesta, la regola viene applicata alla richiesta. Se restituisce false, la regola non viene applicata alla richiesta.
Servizi diversi offrono attributi e funzioni diversi che puoi utilizzare per scrivere espressioni di condizione. Quando aggiungi condizioni a una regola, devi sempre far precedere la condizione dal nome del servizio di cui utilizzi gli attributi e le funzioni. Puoi aggiungere più condizioni a una regola, ma una singola condizione non può combinare attributi di servizi diversi.
Ad esempio, se aggiungi una condizione che utilizza un attributo fornito da IAM, anteponi iam.googleapis.com alla condizione:
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
Per scoprire come creare regole UAP con condizioni, consulta Crea e applica le policy di accesso degli utenti.
Autorizzazioni applicabili per gli attributi delle condizioni
Alcuni attributi specifici del servizio si applicano solo alle richieste che coinvolgono determinate autorizzazioni. Ad esempio, l'attributo eventarc.googleapis.com message.id si applica solo alle richieste che richiedono l'autorizzazione eventarc.googleapis.com/messageBuses.publish.
Puoi utilizzare questi attributi solo nelle regole che includono l'autorizzazione applicabile. Se provi a utilizzare l'attributo in una regola senza l'autorizzazione applicabile, la creazione della UAP non andrà a buon fine.
Attributi di condizione supportati
Nelle regole UAP sono supportati i seguenti attributi:
| Servizio | Attributo | Autorizzazioni applicabili | Ulteriori informazioni |
|---|---|---|---|
iam.googleapis.com (anteprima) |
Tag di risorse | Qualsiasi | Attributo dei tag delle risorse |
eventarc.googleapis.com (anteprima) |
Messaggi | eventarc.googleapis.com/messageBuses.publish |
Attributi dei messaggi Eventarc |
iap.googleapis.com (GA) |
Destinazioni | iap.googleapis.com/resources.egressViaIAP |
Attributi delle destinazioni di Identity-Aware Proxy |
Passaggi successivi
- Scopri come creare e applicare le UAP.
- Scopri come visualizzare le policy di accesso utente esistenti.