Questa pagina illustra le regole di traffico in entrata e in uscita per i Controlli di servizio VPC. I Controlli di servizio VPC utilizzano le regole in entrata e in uscita per consentire l'accesso da e verso e client protetti dai perimetri di servizio.
I blocchi di regole ingress e egress specificano la direzione dell'accesso consentito a e da diverse identità e risorse. Le regole di ingresso e di uscita possono sostituire e semplificare i casi d'uso che in precedenza richiedevano uno o più ponti di perimetro.
Per scoprire come applicare i criteri di traffico in entrata e in uscita al tuo perimetro di servizio, consulta Configurazione dei criteri di traffico in entrata e in uscita.
Puoi configurare gruppi di identità e identità di terze parti (anteprima) nelle regole di entrata e di uscita. Per un di esempio, vedi Esempio di utilizzo di gruppi di identità e identità di terze parti in entrata e in uscita .
Per un elenco di casi d'uso e esempi di scambio di dati protetti, vedi Protezione dello scambio di dati con le regole per il traffico in entrata e in uscita.
Per un elenco di casi d'uso ed esempi di accesso sensibile al contesto, vedi Accesso sensibile al contesto con le regole in entrata.
Vantaggi delle regole in entrata e in uscita
- Le regole di ingresso e di uscita ti consentono di scambiare dati in modo privato ed efficiente all'interno e tra le organizzazioni utilizzando le API di servizi Google Cloud.
- Le regole in entrata e in uscita consentono di concedere l'accesso a Google Cloud
risorse in un perimetro basato sul contesto della richiesta API:
- Limita le identità o i tipi di identità che possono essere utilizzati per una determinata origine rete, indirizzo IP o dispositivo.
- Limita le API e i metodi di Google Cloud a cui è possibile accedere in base alla rete di origine, all'indirizzo IP, al dispositivo e al tipo di identità.
- Ridurre al minimo il rischio di esfiltrazione vincolando l'esatto servizio, metodi Progetti, reti VPC e identità Google Cloud utilizzati per eseguire lo scambio di dati.
- Concedi l'accesso di sola lettura a set di dati e immagini esterni non gestiti da te.
- Assicurati che i client in segmenti con meno privilegi non abbiano accesso alle risorse Google Cloud in segmenti con più privilegi, consentendo al contempo l'accesso nell'altra direzione.
- Semplifica le configurazioni che in precedenza hanno richiesto uno o più bridge perimetri.
Definizione di traffico in entrata e in uscita
Le definizioni di traffico in entrata e in uscita sono indipendenti dall'operazione richiamati sulla risorsa. Pertanto, le definizioni si riferiscono alla direzione e non verso lo spostamento dei dati.
In entrata:si riferisce a qualsiasi accesso da parte di un client API dall'esterno del servizio dalle risorse all'interno di un perimetro di servizio. Esempio:
- Un client Cloud Storage esterno a una chiamata del perimetro di servizio Operazioni di lettura, scrittura o copia di Cloud Storage su un ambiente risorsa all'interno del perimetro.
Egress si riferisce a qualsiasi accesso che interessa risorse o client API all'interno del perimetro di servizio e le risorse al di fuori di un perimetro di servizio. Esempi:
- Un client Compute Engine all'interno di un perimetro di servizio che chiama
Operazione
create
di Compute Engine in cui la risorsa immagine si trova all'esterno perimetrale. - Un client Cloud Storage, all'interno o all'esterno del perimetro, che chiama un comando
copy
in cui un bucket si trova all'interno del perimetro e l'altro al di fuori.
- Un client Compute Engine all'interno di un perimetro di servizio che chiama
Operazione
Modello dei criteri
Una regola per il traffico in entrata o in uscita è costituita da blocchi from
e to
in cui:
from
fa riferimento agli attributi del client API.to
fa riferimento agli attributi dei servizi e delle risorse Google Cloud.
A un perimetro di servizio possono essere associate più regole per il traffico in entrata e in uscita. Una chiamata al servizio Google Cloud è consentita o negata in base alla seguente semantica:
- Una richiesta da un client esterno al perimetro a una risorsa Google Cloud all'interno del perimetro è consentita se le condizioni della regola di ingresso necessaria sono soddisfatte.
- Richiesta di un client all'interno del perimetro a una risorsa Google Cloud fuori dal perimetro è consentita se le condizioni del traffico in uscita siano soddisfatte.
- Una chiamata API che coinvolge una risorsa Google Cloud all'interno del perimetro e una risorsa Google Cloud all'esterno del perimetro è consentita se esiste una regola di ingresso soddisfatta dal client (se il client non si trova all'interno del perimetro) e una regola di uscita soddisfatta dalla risorsa esterna.
Esempi di richieste API consentite dalle regole di ingresso
- Un client Cloud Storage esterno al perimetro che scarica oggetti da un
Bucket Cloud Storage all'interno del perimetro alla macchina locale (ad esempio
usando il comando
gcloud storage cp
). - Un client BigQuery all'esterno del perimetro che utilizza un job BigQuery
in un progetto all'interno del perimetro per eseguire query su un set di dati BigQuery
il perimetro (ad esempio usando il comando
bq query
). - Una VM Compute Engine in una rete VPC esterna al perimetro scrive in un bucket Cloud Storage all'interno del perimetro.
Esempi di richieste API consentite dalle regole in uscita
- Un client Cloud Storage all'interno del perimetro che copia oggetti tra un
il bucket Cloud Storage all'esterno del perimetro e un bucket all'interno
(ad esempio usando il comando
gcloud storage cp
).
- Un client BigQuery all'interno del perimetro che utilizza un job BigQuery
in un progetto esterno al perimetro per eseguire query su un set di dati BigQuery
il perimetro (ad esempio usando il comando
bq query
).
Esempi di richieste API consentite dalla combinazione di regole di ingresso e di uscita
- Un client Cloud Storage fuori dal perimetro che copia oggetti tra un
il bucket Cloud Storage all'esterno del perimetro e un bucket all'interno
(ad esempio usando il comando
gcloud storage cp
). - Un client BigQuery all'esterno del perimetro che utilizza un job BigQuery
in un progetto esterno al perimetro per eseguire query su un set di dati BigQuery
il perimetro (ad esempio usando il comando
bq query
). - Un client Compute Engine esterno al perimetro che crea un disco Compute Engine esterno al perimetro utilizzando una chiave Cloud KMS all'interno del perimetro.
Negli esempi di BigQuery e Compute Engine, una regola in entrata non è perché il job BigQuery o il disco Compute Engine sono fuori dal perimetro. È necessaria una regola in uscita per consentire una richiesta API prevede una risorsa Google Cloud all'interno del perimetro (il set di dati BigQuery o la chiave Cloud KMS) e una risorsa esterna il perimetro (il job BigQuery o il Compute Engine ).
Richieste API che coinvolgono più perimetri di servizio
Quando le risorse a cui si accede e/o il client API appartengono a perimetri di servizio diversi, i criteri di tutti i perimetri coinvolti devono consentire la richiesta dell'API. Ad esempio, considera un client e un bucket Cloud Storage a
all'interno di una
il perimetro di servizio A
e un bucket b
all'interno di un perimetro di servizio B
. In questo esempio, per
al client Cloud Storage di copiare oggetti dal bucket a
al bucket b
e
dal bucket b
al bucket a
, sono necessarie le seguenti regole in entrata e in uscita:
- una regola in uscita nel perimetro
A
per consentire l'accesso a Cloud Storage bucketb
, - una regola in uscita nel perimetro
B
per consentire l'accesso a Cloud Storage bucketa
, - una regola di ingresso nel perimetro
B
per consentire l'accesso al client Cloud Storage esterno al perimetroB
.
Riferimento alle regole in entrata
Le regole di ingresso possono essere configurate utilizzando la console Google Cloud, un file JSON o un file YAML. L'esempio seguente utilizza il formato .yaml
:
- ingressFrom: identityType: ANY_IDENTITY | ANY_USER_ACCOUNT | ANY_SERVICE_ACCOUNT *OR* identities: - PRINCIPAL_IDENTIFIER sources: - resource: RESOURCE *OR* - accessLevel: ACCESS_LEVEL ingressTo: operations: - serviceName: SERVICE methodSelectors: - method: METHOD *OR* - permission: PERMISSION resources: - projects/PROJECT
- ingressFrom:
- (Obbligatorio) Avvia il bloccofrom
che elenca gli elenchi consentiti di origini e identità esterne al perimetro.identityType:
: (è necessario utilizzare questo attributo o l'attributoidentities
) Questo attributo definisce i tipi di identità che possono essere utilizzati dall'sources
specificato (origine della rete). Valori accettati:ANY_IDENTITY
,ANY_USER_ACCOUNT
eANY_SERVICE_ACCOUNT
.ANY_IDENTITY
consente tutti le identità di altro tipo.ANY_USER_ACCOUNT
consente tutti gli utenti umani.ANY_SERVICE_ACCOUNT
consente tutti gli account di servizio.identities:
- (È necessario utilizzare questo attributo o l'attributoidentityType
) questo attributo crea un elenco di account di servizio, account utente, gruppi Google o che possono accedere alle risorse nel perimetro.PRINCIPAL_IDENTIFIER
: specifica un account utente, un account di servizio, un gruppo Google o un'identità di terze parti a cui vuoi fornire l'accesso alle risorse nel perimetro. Utilizza il formato specificato in IAMv1
identificatori entità API. Ad esempio, utilizzagroup:GROUP_NAME@googlegroups.com
per specificare un gruppo Google.Controlli di servizio VPC supporta solo le identità
v1
che iniziano conuser
,serviceAccount
,group
(anteprima), eprincipal
(Anteprima) in IAMv1
identificatori entità API.sources:
- (Obbligatorio) Questo attributo si riferisce a un elenco di origini della rete. Ogni valore nell'elenco è un livello di accesso o un progetto Google Cloud. Se imposti l'attributoaccessLevel
su"*"
, il criterio in entrata consente da qualsiasi origine di rete. Se imposti questo attributo su un progetto Google Cloud, il criterio di ingresso consente l'accesso da una rete VPC appartenente al progetto.Questo valore potrebbe essere rimosso quando il progetto associato viene eliminato definitivamente. Tuttavia, la rimozione di questo valore non causa un errore. Controlla sempre se questo valore esiste durante la risoluzione di eventuali problemi.
- resource:
- (utilizza questo attributo o l'attributoaccessLevel
) Specifica un progetto o una rete VPC dall'esterno del perimetro a cui vuoi fornire l'accesso. Per specificare un progetto, utilizza il formato seguente:projects/PROJECT_NUMBER
. Per specificare una rete VPC, utilizza il formato seguente://compute.googleapis.com/projects/PROJECT_ID/global/networks/NETWORK_NAME
.- accessLevel:
: (è necessario utilizzare questo attributo o l'attributoresource
) specifica il livello di accesso dall'esterno del perimetro a cui viene concesso l'accesso. Se imposti l'attributoaccessLevel
su"*"
, il criterio di ingresso consente l'accesso da qualsiasi origine di rete.ingressTo:
- (Obbligatorio) Avvia il bloccoto
che elenca le operazioni di servizio consentite sulle risorse Google Cloud specificate all'interno del perimetro.operations:
- (Obbligatorio) Contrassegna l'inizio dell'elenco di elementi accessibili servizi e azioni/metodi con cui un client soddisfa il bloccofrom
a cui è consentito l'accesso.- serviceName:
- (Obbligatorio) Questo campo può essere un nome di servizio valido o essere impostato a"*"
per consentire l'accesso a tutti i servizi. Ad esempio,bigquery.googleapis.com
è unserviceName
valido. Per un elenco dei servizi disponibili, consulta Prodotti supportati.methodSelectors:
- (Obbligatorio seserviceName
non è"*"
) L'inizio di un elenco di metodi a cui un client soddisfa le condizioni di bloccofrom
autorizzati ad accedere. Per un elenco di metodi e autorizzazioni limitati per vedi Limitazioni relative ai metodi di servizio supportati.- method:
- (È necessario utilizzare questo attributo o l'attributopermission
) Questo campo può essere un metodo di servizio valido oppure puoi impostarlo su"*"
per consentire l'accesso a tutti del servizio specificato.- permission:
: (è obbligatorio utilizzare questo attributo o l'attributomethod
) questo campo deve essere un'autorizzazione di servizio valida. L'accesso alle risorse all'interno del perimetro è consentito per le operazioni che richiedono l'autorizzazione.Quando una richiesta a una risorsa richiede più autorizzazioni, devi specificare tutte le autorizzazioni richieste nella stessa operazione affinché la regola di ingresso funzioni. Ad esempio, se una richiesta a una risorsa BigQuery richiede le autorizzazioni
bigquery.jobs.create
ebigquery.tables.create
, devi specificare entrambe queste autorizzazioni nella stessa operazione. Inoltre, se specifichi le autorizzazioni più volte per la stessa risorsa utilizzando la console Google Cloud, le autorizzazioni non vengono create nella stessa operazione. Per evitare questo problema, specifica tutte le autorizzazioni contemporaneamente per la risorsa.resources:
- (Obbligatorio) Questo attributo specifica l'elenco di Risorse Google Cloud nel perimetro di servizio che il client ha a cui può accedere il perimetro. Questo campo può essere impostato su"*"
per consentire l'accesso in entrata a qualsiasi risorsa Google Cloud all'interno del perimetro.
Per creare una regola in entrata funzionale, devi specificare i seguenti attributi:
sources
. Devi specificare unaccessLevel
o unresource
(progetto Google Cloud o rete VPC) o impostare l'attributoaccessLevel
su"*"
.
- Attributo
identityType
oidentities
- Attributo
resources
- Attributo
serviceName
Una volta completata la configurazione del file di criteri di ingresso, consulta Aggiornare i criteri di ingresso e di uscita per istruzioni su come applicare il file di criteri di ingresso al perimetro del servizio.
Riferimento alle regole in uscita
Le regole di uscita possono essere configurate utilizzando la console Google Cloud, un file JSON o un file YAML. L'esempio seguente utilizza il formato .yaml
:
- egressTo: operations: - serviceName: SERVICE_NAME methodSelectors: - method: METHOD *OR* - permission: PERMISSION resources: - projects/PROJECT *OR* externalResources: - EXTERNAL_RESOURCE_PATH egressFrom: identityType: ANY_IDENTITY | ANY_USER_ACCOUNT | ANY_SERVICE_ACCOUNT *OR* identities: - PRINCIPAL_IDENTIFIER
- egressTo:
- (Obbligatorio) Avvia il bloccoto
che elenca i servizi consentiti operazioni sulle risorse Google Cloud in progetti specificati al di fuori perimetrale.operations:
- (Obbligatorio) Indica l'inizio dell'elenco di servizi e azioni/metodi accessibili a cui un client che soddisfa le condizioni del bloccofrom
può accedere.- serviceName:
- (Obbligatorio) Questo campo può essere un nome di servizio valido o essere impostato a"*"
per consentire l'accesso a tutti i servizi. Per un elenco dei servizi disponibili, consulta la sezione Prodotti supportati.methodSelectors:
- (obbligatorio seserviceName
non è"*"
) L'inizio di un elenco di metodi a cui un client che soddisfa le condizioni di bloccofrom
è autorizzato ad accedere. Per un elenco di metodi e autorizzazioni limitati per vedi Limitazioni relative ai metodi di servizio supportati.- method:
- È necessario utilizzare questo attributo o l'attributopermission
. Questo campo può essere un metodo di servizio valido oppure può essere impostato su"*"
per consentire l'accesso a tutti i metodi del servizio specificato.- permission:
- È necessario utilizzare questo attributo o l'attributomethod
. Questo campo deve essere un'autorizzazione di servizio valida. L'accesso alle risorse specificate al di fuori del perimetro è consentito per le operazioni che richiedono questa autorizzazione.Quando una richiesta a una risorsa richiede più autorizzazioni, devi specificare tutte le autorizzazioni richieste nella stessa operazione affinché la regola di uscita funzioni. Ad esempio, se una richiesta a una risorsa BigQuery richiede le autorizzazioni
bigquery.jobs.create
ebigquery.tables.create
, devi specificare entrambe queste autorizzazioni nella stessa operazione. Inoltre, se specifichi le autorizzazioni più volte per la stessa risorsa utilizzando Console Google Cloud, le autorizzazioni non vengono create con la stessa operazione. A evitare questo problema, specifica contemporaneamente tutte le autorizzazioni per la risorsa.resources:
: questo attributo è un elenco di risorse Google Cloud specificate dai relativi progetti a cui possono accedere i client all'interno di un perimetro. Puoi impostare questo campo su"*"
per consentire l'accesso in uscita a qualsiasi risorsa Google Cloud.externalResources:
- Questo attributo viene utilizzato solo per specificare le risorse BigQuery Omni. Questo attributo è un elenco di risorse esterne supportate da BigQuery Omni a cui possono accedere i client all'interno di un perimetro. Puoi specificare solo risorse Amazon S3 o Archiviazione BLOB di Azure. Per Amazon S3, il formato supportato ès3://BUCKET_NAME
. Per Azure Storage, il formato supportato èazure://myaccount.blob.core.windows.net/CONTAINER_NAME
.egressFrom:
- (Obbligatorio) Avvia il bloccofrom
che elenca le origini e le identità consentite all'interno del perimetro.identityType:
: deve essere utilizzato questo attributo o l'attributoidentities
. Questo attributo definisce i tipi di identità che possono essere utilizzati per accedere alle risorse specificate al di fuori del perimetro. Valori accettati:ANY_IDENTITY
,ANY_USER_ACCOUNT
,ANY_SERVICE_ACCOUNT
.ANY_IDENTITY
consente tutte le identità.ANY_USER_ACCOUNT
consente tutti gli utenti umani.ANY_SERVICE_ACCOUNT
consente tutti gli account di servizio.identities:
: deve essere utilizzato questo attributo o l'attributoidentityType
. Questo attributo avvia un elenco di account di servizio, account utente, gruppi Google o identità di terze parti che possono accedere alle risorse specificate al di fuori del perimetro.PRINCIPAL_IDENTIFIER
: specifica un account utente, un account di servizio, un gruppo Google o un'identità di terze parti che può accedere alle risorse specificate al di fuori del perimetro. Utilizza il formato specificato in IAMv1
identificatori entità API. Ad esempio, utilizza il formatogroup:GROUP_NAME@googlegroups.com
per specificare un gruppo Google.I Controlli di servizio VPC supportano solo le identità
v1
che iniziano con i prefissiuser
,serviceAccount
,group
(anteprima) eprincipal
(anteprima) negli identificatori principali dell'API IAMv1
.
Una volta completata la configurazione del file dei criteri di uscita, consulta Aggiornare i criteri di ingresso e di uscita per istruzioni su come applicare il file dei criteri di uscita al perimetro del servizio.
Utilizzo della modalità dry run per testare i criteri in entrata/in uscita
Quando non vuoi concedere l'accesso a tutti i metodi di un servizio, a volte può essere difficile determinare l'elenco preciso dei metodi da consentire. Questo può accadere perché un determinato metodo per un servizio può causare l'attivazione di un metodo diverso in un servizio Google Cloud separato. Ad esempio, BigQuery carica da un bucket Cloud Storage per eseguire una query.
Per determinare il set di metodi corretto da consentire, puoi utilizzare il Controlli di servizio VPC Modalità dry run. Per farlo, abilita prima un perimetro in modalità di prova simulata senza criteri di entrata o di uscita e raccogli l'elenco dei metodi invocati dal log di controllo. Poi, aggiungere progressivamente questi metodi ai criteri di ingresso/uscita in modalità di prova simulata fino a quando tutte le violazioni non sono state eliminate. A questo punto, la configurazione può essere spostata dalla modalità di prova alla modalità applicata.
Funzionalità non supportate
Le seguenti funzionalità non sono attualmente supportate per le regole di ingresso e di uscita:
- Identificazione delle risorse Google Cloud tramite etichette anziché per progetti.
- Non tutti i servizi supportano le regole di ingresso/uscita per metodo. Vedi Limitazioni relative ai metodi di servizio supportati.
- I tipi di identità
ANY_SERVICE_ACCOUNT
eANY_USER_ACCOUNT
non possono essere utilizzati per consentire le seguenti operazioni:- Tutte le operazioni di Container Registry.
- Tutte le operazioni del servizio notebooks.googleapis.com.
- Operazioni di Cloud Storage che utilizzano URL firmati.
- Con le funzioni Cloud Run, puoi eseguire il deployment di una funzione Cloud dalla macchina locale.
- Esporta i log da un sink Cloud Logging a una risorsa Cloud Storage.
- Tutte le operazioni dell'interfaccia utente web di Apache Airflow in Cloud Composer.
Limitazioni
Per informazioni sui limiti di ingresso e uscita, consulta Quote e limiti.
Passaggi successivi
- Completa questo codelab per scoprire come correggere le violazioni del traffico in entrata e in uscita.