Le policy di autorizzazione ti consentono di stabilire controlli di accesso e di sanitizzazione dei contenuti durante l'elaborazione di richieste o risposte tramite diversi serviziGoogle Cloud , come i bilanciatori del carico delle applicazioni, Agent Gateway e Secure Web Proxy.
Per Agent Gateway e Secure Web Proxy, la policy di autorizzazione è collegata direttamente alla risorsa gateway di questi servizi. Per un bilanciatore del carico, la policy di autorizzazione è collegata alla risorsa della regola di forwarding del bilanciatore del carico.
Una policy di autorizzazione (risorsa AuthzPolicy), collegata alla regola di forwarding di un bilanciatore del carico, consente di specificare le condizioni che consentono, limitano o delegano l'autorizzazione delle richieste in base alla loro origine e alle operazioni previste. Le richieste che superano questi controlli vengono indirizzate al servizio di backend del bilanciatore del carico, mentre quelle che non li superano vengono rifiutate con una risposta di non autorizzazione.
Puoi configurare le policy di autorizzazione sulla regola di forwarding di tutti i bilanciatori del carico delle applicazioni con uno schema di bilanciamento del carico EXTERNAL_MANAGED o INTERNAL_MANAGED.
I seguenti bilanciatori del carico delle applicazioni supportano le policy di autorizzazione:
- Bilanciatori del carico delle applicazioni esterni regionali
- Bilanciatori del carico delle applicazioni interni regionali
Regole delle policy di autorizzazione
Una policy di autorizzazione è costituita da un elenco di regole HTTP da confrontare con la richiesta in arrivo.
Per una policy di autorizzazione con un'azione ALLOW o DENY, una regola HTTP (AuthzRule) definisce le condizioni che determinano se il traffico può passare attraverso il bilanciatore del carico. È necessaria almeno una regola HTTP.
Per una policy di autorizzazione con un'azione CUSTOM, una regola HTTP definisce le condizioni che determinano se il traffico viene delegato al provider personalizzato per l'autorizzazione. È richiesto un provider personalizzato, mentre le regole HTTP sono facoltative.
Una corrispondenza della policy si verifica quando almeno una regola HTTP corrisponde alla richiesta o quando non sono definite regole HTTP nella policy.
Una regola HTTP della policy di autorizzazione è costituita dai seguenti campi:
from: specifica l'identità del client consentito dalla regola. L'identità può essere derivata da un certificato client in una connessione mutual TLS o può essere l'identità ambientale associata all'istanza della macchina virtuale (VM) client, ad esempio da un account di servizio o da un tag sicuro.to: specifica le operazioni consentite dalla regola, ad esempio gli URL a cui è possibile accedere o i metodi HTTP consentiti.when: specifica vincoli aggiuntivi che devono essere soddisfatti. Per definire i vincoli, puoi utilizzare le espressioni Common Expression Language (CEL).
Azioni delle policy di autorizzazione
Durante la valutazione di una richiesta, una policy di autorizzazione specifica l'azione (AuthzAction) da applicare alla richiesta. Una policy di autorizzazione deve avere almeno un'azione, che può essere una delle seguenti:
ALLOW: consente alla richiesta di passare al backend se corrisponde a una delle regole specificate all'interno di una policyALLOW. Se esistono policyALLOW, ma non esiste una corrispondenza, la richiesta viene rifiutata. In altre parole, la richiesta viene rifiutata se nessuna delle policy di autorizzazione configurate con un'azioneALLOWcorrisponde alla richiesta. In Cloud Logging, questa azione viene registrata comedenied_as_no_allow_policies_matched_request.Per applicare un'azione
ALLOW, devi avere almeno una regola HTTP.DENY: nega la richiesta se corrisponde a una delle regole specificate all'interno di una policyDENY. Se esistono policyDENY, ma non esiste una corrispondenza, la richiesta viene consentita. In altre parole, la richiesta è consentita se nessuna delle policy di autorizzazione configurate con un'azioneDENYcorrisponde alla richiesta. In Cloud Logging, questa azione viene registrata comeallowed_as_no_deny_policies_matched_request.Per applicare un'azione
DENY, devi avere almeno una regola HTTP.CUSTOM: delega la decisione di autorizzazione a un provider di autorizzazione personalizzato, come IAP o le estensioni di servizio. Per saperne di più, consulta Delega le decisioni di autorizzazione.Se sono configurate regole HTTP per una policy
CUSTOM, la richiesta deve corrispondere alle regole HTTP per richiamare il provider personalizzato. Tuttavia, se non sono definite regole HTTP, la policy di autorizzazione delega sempre la decisione di autorizzazione a un provider di autorizzazione personalizzato. Per saperne di più, consulta gli esempi in Policy di autorizzazione per delegare le decisioni di autorizzazione.DENY_BY_DEFAULT: attiva una security posture deny-by-default. Blocca tutte le richieste, a meno che non siano esplicitamente consentite da una policyALLOWoCUSTOM.Puoi collegare un solo criterio
DENY_BY_DEFAULTa una regola di forwarding o a una risorsa gateway. Non puoi configurare regole HTTP (httpRules) in una policyDENY_BY_DEFAULTperché questa policy si applica a tutto il traffico. Per gestire un traffico specifico, combina la policyDENY_BY_DEFAULTcon policyALLOW,DENYoCUSTOMseparate e granulari.In Cloud Logging, questa azione viene registrata come
denied_by_default.
Ordine di valutazione delle policy di autorizzazione
Una policy di autorizzazione supporta le policy CUSTOM, DENY, ALLOW e DENY_BY_DEFAULT per controllo dell'accesso. Se su una risorsa non sono configurate policy di autorizzazione, le richieste sono consentite per impostazione predefinita.
Quando a una singola risorsa sono associate più policy di autorizzazione, il bilanciatore del carico le valuta nel seguente ordine:
Policy
CUSTOM:Se una richiesta corrisponde a una policy
CUSTOM, la richiesta viene delegata al provider di autorizzazione personalizzato.Se un provider personalizzato rifiuta la richiesta, questa viene rifiutata immediatamente. Le policy
DENY,ALLOWoDENY_BY_DEFAULTnon vengono valutate.Se un provider personalizzato consente la richiesta o se una richiesta non corrisponde a una policy
CUSTOM, la valutazione passa alla fase della policyDENY.
Policy
DENY:Se una richiesta corrisponde a una policy
DENY, viene rifiutata immediatamente. Le policyALLOWoDENY_BY_DEFAULTnon vengono valutate.Se una richiesta non corrisponde a nessuna policy
DENYo se non è configurata una policyDENY, la valutazione passa alla fase della policyALLOW.
Policy
ALLOW:Se sono configurate una o più policy
ALLOWe la richiesta corrisponde a una policyALLOW, la richiesta viene consentita.Se le policy
ALLOWsono configurate, ma la richiesta non corrisponde a nessuna di queste, la richiesta viene rifiutata.Se non è configurata alcuna policy
ALLOW, la valutazione passa alla policyDENY_BY_DEFAULT. Tuttavia, se non è configurata alcuna policyDENY_BY_DEFAULT, la richiesta viene consentita per impostazione predefinita.
Policy
DENY_BY_DEFAULT:Se è configurata una policy
DENY_BY_DEFAULT, la richiesta viene rifiutata (a meno che non corrisponda a una policyALLOWprecedente o non sia stata consentita da una policyCUSTOM).Se non è configurata alcuna policy
DENY_BY_DEFAULT, la richiesta viene consentita per impostazione predefinita.
Per i servizi di proxy Google Cloud che supportano i profili delle policy, l'ordine di valutazione delle policy di autorizzazione è il seguente:
Policy
CUSTOMcon profiloREQUEST_AUTHZ:Se una richiesta corrisponde a una policy
CUSTOMconfigurata con un profiloREQUEST_AUTHZ, le intestazioni della richiesta vengono inoltrate al provider di autorizzazione personalizzato.Se il provider personalizzato rifiuta la richiesta, questa viene rifiutata immediatamente. Le altre policy (
DENY,ALLOW,CUSTOMcon un profiloCONTENT_AUTHZeDENY_BY_DEFAULT) non vengono valutate.Se il provider personalizzato consente la richiesta o se la richiesta non corrisponde a nessuna policy
CUSTOM, la valutazione passa alla fase della policyDENY.
Policy
DENY:Se una richiesta corrisponde a una policy
DENY, viene rifiutata immediatamente. Eventuali altre policy (ALLOW,CUSTOMcon un profiloCONTENT_AUTHZeDENY_BY_DEFAULT) non vengono valutate.Se la richiesta non corrisponde a nessuna policy
DENYo se non è configurata una policyDENY, la valutazione passa alla fase della policyALLOW.
Policy
ALLOW:Se sono configurate policy
ALLOWe la richiesta corrisponde a una policyALLOW, la richiesta procede alla valutazioneCONTENT_AUTHZ.Se le policy
ALLOWsono configurate, ma la richiesta non corrisponde a nessuna di queste, la richiesta viene rifiutata immediatamente. Qualsiasi policyCUSTOMcon un profiloCONTENT_AUTHZe una policyDENY_BY_DEFAULTnon viene valutata.Se non è configurata alcuna policy
ALLOW, la valutazione procede alla faseCONTENT_AUTHZ.
Policy
CUSTOMcon profiloCONTENT_AUTHZ:Se viene configurata una policy
CUSTOMcon un profiloCONTENT_AUTHZ, il payload completo della richiesta viene valutato dal provider di autorizzazione dei contenuti.Se il fornitore rifiuta la richiesta, questa viene rifiutata immediatamente.
Se il provider consente la richiesta o se non è configurata alcuna estensione
CONTENT_AUTHZ, la valutazione procede alla faseDENY_BY_DEFAULT.
Policy
DENY_BY_DEFAULT:Se è configurata una policy
DENY_BY_DEFAULT, qualsiasi richiesta che raggiunge questo passaggio senza essere esplicitamente consentita da una policy precedente (una policyALLOWo una policyCUSTOMvalutata durante le fasiREQUEST_AUTHZoCONTENT_AUTHZ) viene rifiutata.Se non è configurata alcuna policy
DENY_BY_DEFAULT, la richiesta viene consentita per impostazione predefinita.
Profili delle policy nelle policy di autorizzazione
I profili delle policy nelle policy di autorizzazione sono supportati per i seguenti servizi Google Cloud :
- Bilanciatori del carico delle applicazioni esterni regionali
- Bilanciatori del carico delle applicazioni interni regionali
- Agent Gateway
- Secure Web Proxy
Un profilo delle policy (PolicyProfile) in una policy di autorizzazione è dei seguenti tipi:
- Profilo di autorizzazione della richiesta (
REQUEST_AUTHZ): si basa sulle informazioni contenute nelle intestazioni delle richieste HTTP per consentire o negare il traffico. - Profilo di autorizzazione dei contenuti (
CONTENT_AUTHZ): fornisce sicurezza e filtro basati sui contenuti per bloccare gli attacchi di prompt injection, prevenire le fughe di dati sensibili e filtrare i contenuti dannosi.
Puoi configurare una policy di autorizzazione con un profilo REQUEST_AUTHZ o un profilo CONTENT_AUTHZ, ma non con entrambi. Se non viene specificato un profilo delle policy, la policy di autorizzazione utilizza il profilo REQUEST_AUTHZ per impostazione predefinita.
Profilo di richiesta di autorizzazione
Le policy di autorizzazione che utilizzano il profilo delle policy REQUEST_AUTHZ possono valutare
le decisioni di accesso per il traffico in entrata direttamente o delegarle. Puoi delegare le decisioni di accesso a Identity-Aware Proxy o a un motore di autorizzazione personalizzato utilizzando un'estensione dell'autorizzazione.
Il profilo della policy REQUEST_AUTHZ agisce sulle informazioni contenute nelle intestazioni delle richieste HTTP per consentire o negare una richiesta.
Una policy di autorizzazione con il profilo della policy REQUEST_AUTHZ può avere un'azione ALLOW, DENY, CUSTOM o DENY_BY_DEFAULT applicata alla richiesta. Un'azione ALLOW o DENY indica che la decisione di accesso viene valutata direttamente, mentre un'azione CUSTOM indica che la decisione di accesso viene delegata. DENY_BY_DEFAULT significa che una richiesta viene negata per impostazione predefinita, a meno che non sia esplicitamente consentita da una policy ALLOW o CUSTOM.
Quando la decisione di accesso viene delegata, una policy di autorizzazione, configurata sulla regola di forwarding del bilanciatore del carico, punta a un'estensione di autorizzazione della richiesta eseguita su un servizio di backend del callout. Per ogni richiesta di autorizzazione, il bilanciatore del carico inoltra le intestazioni della richiesta all'estensione dell'autorizzazione utilizzando il protocollo ext_proc o ext_authz di Envoy. A seconda della risposta dell'estensione, il proxy del bilanciatore del carico inoltra la richiesta al servizio di backend o la rifiuta.
Se non viene specificato un profilo delle policy, la policy di autorizzazione utilizza il profilo di autorizzazione della richiesta (REQUEST_AUTHZ) per impostazione predefinita.
Profilo di autorizzazione dei contenuti
Le policy di autorizzazione che utilizzano il profilo delle policy CONTENT_AUTHZ possono essere utilizzate per eseguire un'ispezione approfondita dei payload dell'applicazione per consentire o negare le richieste o modificarle o modificarne le risposte, se necessario. Puoi delegare le decisioni di accesso a Model Armor o alla tua estensione di sanitizzazione dei contenuti.
Una policy di autorizzazione con il profilo della policy CONTENT_AUTHZ può avere solo un'azione CUSTOM applicata alla richiesta. Ciò significa che la richiesta non può essere valutata direttamente e deve essere delegata.
Una policy di autorizzazione, configurata sulla regola di forwarding del bilanciatore del carico, rimanda a un'estensione dell'autorizzazione dei contenuti.
Per ogni richiesta di autorizzazione, il bilanciatore del carico inoltra i contenuti completi della richiesta e della risposta, inclusi intestazioni, corpo e trailer, utilizzando il protocollo ext_proc di Envoy in modalità di streaming full duplex (FULL_DUPLEX_STREAMED), all'estensione dell'autorizzazione dei contenuti. A seconda della risposta dell'estensione, il proxy del bilanciatore del carico inoltra la richiesta alla destinazione o la rifiuta. La destinazione, nel caso di una richiesta, è il servizio di backend del bilanciatore del carico e, nel caso di una risposta, è il client.
Policy di autorizzazione basata sulle entità
Per identificare l'origine del traffico con un'elevata granularità, puoi configurare policy di autorizzazione basate su identità derivate dal certificato di un client. Questo metodo richiede l'abilitazione di mTLS frontend sul bilanciatore del carico e utilizza i seguenti attributi del certificato come selettore di entità per l'identificazione:
- SAN URI del certificato client (
CLIENT_CERT_URI_SAN) - SAN del nome DNS del certificato client (
CLIENT_CERT_DNS_NAME_SAN) - Nome comune (CN) del certificato client (
CLIENT_CERT_COMMON_NAME)
Se non viene specificato alcun selettore di entità per l'identificazione, CLIENT_CERT_URI_SAN
viene utilizzato come selettore di entità predefinito. Ciò significa che gli URI SAN del certificato client vengono valutati quando vengono prese decisioni di autorizzazione.
Affinché l'autorizzazione basata su entità funzioni, devono essere soddisfatte le seguenti condizioni:
mTLS frontend deve essere abilitato. Se mTLS frontend non è abilitato, il client non presenta un certificato. Di conseguenza, le regole basate sulle entità nella policy di autorizzazione non trovano informazioni sui certificati da valutare. Ad esempio, una regola che controlla
CLIENT_CERT_URI_SANvede un valore vuoto.Deve essere presente un certificato client valido. Anche con mTLS abilitato, un certificato client non viene utilizzato per l'autorizzazione se la connessione è stata stabilita con un certificato mancante o non valido. Questo scenario si verifica quando la modalità di convalida del client mTLS è impostata sulla modalità permissiva
ALLOW_INVALID_OR_MISSING_CLIENT_CERT. Anche in questo caso, le regole basate sulle entità nella policy di autorizzazione non trovano informazioni sui certificati da valutare. Ad esempio, una regola che controllaCLIENT_CERT_URI_SANvede un valore vuoto.
Impatto dei limiti di dimensione degli attributi
Le decisioni di autorizzazione sono sensibili alle dimensioni degli attributi del certificato client. Una richiesta viene rifiutata se un attributo supera il limite di dimensioni e la policy è configurata per convalidare l'attributo specifico.
Un rifiuto può verificarsi nelle seguenti condizioni:
- La policy viene convalidata in base a
CLIENT_CERT_URI_SANe i SAN URI del certificato superano il limite di dimensioni. - La policy viene convalidata in base a
CLIENT_CERT_DNS_NAME_SANe i SAN del nome DNS del certificato superano il limite di dimensioni. - La policy viene convalidata in base a
CLIENT_CERT_COMMON_NAMEe l'oggetto del certificato (che contiene il nome comune) supera il limite di dimensioni.
Se l'attributo di un certificato supera il limite di dimensioni, ma non è convalidato esplicitamente dal selettore di entità della policy, la richiesta viene comunque valutata in base alle regole di entità configurate. Ad esempio, se una policy è configurata per convalidare solo il CLIENT_CERT_DNS_NAME_SAN, una richiesta di un client con SAN URI di dimensioni eccessive non viene rifiutata per questo motivo. La policy procede alla valutazione della richiesta in base ai SAN del nome DNS.
Per un esempio di policy di autorizzazione basata sulle entità, consulta Policy di autorizzazione per negare le richieste.
Policy di autorizzazione basata su service account o tag sicuri
Una policy di autorizzazione basata su service account o tag sicuri è supportata per i seguenti bilanciatori del carico:
- Bilanciatori del carico delle applicazioni interni regionali
- Bilanciatori del carico delle applicazioni interni tra regioni
Le policy di autorizzazione, basate su service account e tag sicuri, ti consentono di applicare regole di sicurezza in base a chi o cosa invia il traffico, anziché solo all'indirizzo IP. Ciò comporta un passaggio dalle regole basate su IP ai controlli basati sull'identità utilizzando service account e tag sicuri per definire il perimetro di sicurezza. Ad esempio, puoi creare una policy di autorizzazione per:
nega a una VM di Compute Engine con un account di servizio specifico (
my-sa-123@PROJECT_ID.) di raggiungere il percorso/api/payments.consente alle VM di Compute Engine con un tag sicuro (coppia chiave-valore
environment: prod) di raggiungere il percorso/api/payments.
Puoi applicare policy di autorizzazione in base ai service account o ai tag sicuri collegati ai vari servizi Google Cloud . Qualsiasi traffico proveniente da questi servizi Google Cloud , collegati a un account di servizio specifico o a un tag sicuro, può essere consentito, negato o delegato per un'ulteriore valutazione.
La tabella seguente elenca i vari servizi Google Cloud che supportano l'utilizzo di service account e tag sicuri.
| ServizioGoogle Cloud | Assistenza per i service account | Assistenza di Tag protetti |
|---|---|---|
| Macchina virtuale (VM) di Compute Engine | ||
| Nodo Google Kubernetes Engine (GKE) | ||
| Container Google Kubernetes Engine (GKE) | 1 | 1 |
| Cloud VPN | 1 | 1 |
| Cloud Interconnect on-premise | 1 | 1 |
| Bilanciatore del carico delle applicazioni | 3 | 3 |
| Bilanciatore del carico di rete | 3 | 3 |
1 Non supportato da Google Cloud.
3 I service account e i tag non sono supportati quando i bilanciatori del carico delle applicazioni e i bilanciatori del carico di rete fungono da origini del traffico in un'architettura a livelli.
La tabella seguente elenca le diverse architetture Virtual Private Cloud (VPC) che supportano l'utilizzo di service account e tag.
| VPC | Architettura VPC | Assistenza |
|---|---|---|
| All'interno del VPC | Tra progetti (VPC condiviso) | |
| All'interno del VPC | Tra regioni | |
| VPC incrociato | Link di peering incrociato (VPC in peering) | |
| VPC incrociato | Cross Private Service Connect | |
| VPC incrociato | Spoke di Network Connectivity Center tra reti |
Per scoprire di più sulla configurazione di una policy di autorizzazione basata su service account e tag collegati a una risorsa Google Cloud , consulta Policy di autorizzazione basata su service account o tag.
Quote
Per informazioni sulle quote per le policy di autorizzazione, consulta Quote e limiti per le policy di autorizzazione.