Panoramica delle policy di autorizzazione

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 policy ALLOW. Se esistono policy ALLOW, 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'azione ALLOW corrisponde alla richiesta. In Cloud Logging, questa azione viene registrata come denied_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 policy DENY. Se esistono policy DENY, ma non esiste una corrispondenza, la richiesta viene consentita. In altre parole, la richiesta è consentita se nessuna delle policy di autorizzazione configurate con un'azione DENY corrisponde alla richiesta. In Cloud Logging, questa azione viene registrata come allowed_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 policy ALLOW o CUSTOM.

    Puoi collegare un solo criterio DENY_BY_DEFAULT a una regola di forwarding o a una risorsa gateway. Non puoi configurare regole HTTP (httpRules) in una policy DENY_BY_DEFAULT perché questa policy si applica a tutto il traffico. Per gestire un traffico specifico, combina la policy DENY_BY_DEFAULT con policy ALLOW, DENY o CUSTOM separate 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:

  1. 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, ALLOW o DENY_BY_DEFAULT non 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 policy DENY.

  2. Policy DENY:

    • Se una richiesta corrisponde a una policy DENY, viene rifiutata immediatamente. Le policy ALLOW o DENY_BY_DEFAULT non vengono valutate.

    • Se una richiesta non corrisponde a nessuna policy DENY o se non è configurata una policy DENY, la valutazione passa alla fase della policy ALLOW.

  3. Policy ALLOW:

    • Se sono configurate una o più policy ALLOW e la richiesta corrisponde a una policy ALLOW, la richiesta viene consentita.

    • Se le policy ALLOW sono configurate, ma la richiesta non corrisponde a nessuna di queste, la richiesta viene rifiutata.

    • Se non è configurata alcuna policy ALLOW, la valutazione passa alla policy DENY_BY_DEFAULT. Tuttavia, se non è configurata alcuna policy DENY_BY_DEFAULT, la richiesta viene consentita per impostazione predefinita.

  4. Policy DENY_BY_DEFAULT:

    • Se è configurata una policy DENY_BY_DEFAULT, la richiesta viene rifiutata (a meno che non corrisponda a una policy ALLOW precedente o non sia stata consentita da una policy CUSTOM).

    • 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:

  1. Policy CUSTOM con profilo REQUEST_AUTHZ:

    • Se una richiesta corrisponde a una policy CUSTOM configurata con un profilo REQUEST_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, CUSTOM con un profilo CONTENT_AUTHZ e DENY_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 policy DENY.

  2. Policy DENY:

    • Se una richiesta corrisponde a una policy DENY, viene rifiutata immediatamente. Eventuali altre policy (ALLOW, CUSTOM con un profilo CONTENT_AUTHZ e DENY_BY_DEFAULT) non vengono valutate.

    • Se la richiesta non corrisponde a nessuna policy DENY o se non è configurata una policy DENY, la valutazione passa alla fase della policy ALLOW.

  3. Policy ALLOW:

    • Se sono configurate policy ALLOW e la richiesta corrisponde a una policy ALLOW, la richiesta procede alla valutazione CONTENT_AUTHZ.

    • Se le policy ALLOW sono configurate, ma la richiesta non corrisponde a nessuna di queste, la richiesta viene rifiutata immediatamente. Qualsiasi policy CUSTOM con un profilo CONTENT_AUTHZ e una policy DENY_BY_DEFAULT non viene valutata.

    • Se non è configurata alcuna policy ALLOW, la valutazione procede alla fase CONTENT_AUTHZ.

  4. Policy CUSTOM con profilo CONTENT_AUTHZ:

    • Se viene configurata una policy CUSTOM con un profilo CONTENT_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 fase DENY_BY_DEFAULT.

  5. 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 policy ALLOW o una policy CUSTOM valutata durante le fasi REQUEST_AUTHZ o CONTENT_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_SAN vede 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 controlla CLIENT_CERT_URI_SAN vede 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_SAN e i SAN URI del certificato superano il limite di dimensioni.
  • La policy viene convalidata in base a CLIENT_CERT_DNS_NAME_SAN e i SAN del nome DNS del certificato superano il limite di dimensioni.
  • La policy viene convalidata in base a CLIENT_CERT_COMMON_NAME e 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.

Passaggi successivi