Controlla il traffico in entrata privato e il traffico in uscita verso internet di una sandbox di Agent Platform con Private Service Connect (PSC-E/PSC-I). Questi controlli rendono la sandbox conforme ai Controlli di servizio VPC all'interno di un perimetro o senza un perimetro.
Panoramica
I Controlli di servizio VPC consentono di definire un perimetro di servizio che isola le risorse Google Cloud per mitigare il rischio di esfiltrazione di dati. La sandbox di Gemini Enterprise Agent Platform offre agli agenti un ambiente di computing sicuro e isolato per eseguire codice non attendibile, utilizzare un browser web (utilizzo del computer) o eseguire un'immagine container personalizzata. La sandbox espone un piano dati interattivo ed effettua chiamate in uscita, quindi è regolata da due controlli Private Service Connect: traffico in entrata privato (PSC-E) e controllo del traffico in uscita (PSC-I).
Quando esegui la sandbox all'interno di un perimetro, i seguenti elementi rimangono protetti all'interno del confine:
- Dati che l'agente legge o scrive durante una sessione della sandbox (file sul disco della sandbox, stato in memoria).
- Snapshot della sandbox che acquisiscono lo stato del disco e della memoria e vengono archiviati automaticamente in un bucket Cloud Storage.
- Richieste e risposte scambiate con il piano dati della sandbox (ad esempio, comandi di utilizzo del computer e screenshot).
- Immagini container personalizzate di cui è stato eseguito il pull da Artifact Registry.
- Chiamate effettuate dalla sandbox alle API di Google (ad esempio Cloud Storage o Agent Platform).
Puoi anche configurare il controllo del traffico in entrata e in uscita senza un perimetro dei Controlli di servizio VPC, poiché PSC-E (traffico in entrata privato) e PSC-I (traffico in uscita) sono ciò che rende una sandbox conforme ai Controlli di servizio VPC. Per configurare il traffico in entrata e in uscita senza un perimetro dei Controlli di servizio VPC, vai a Controlla il traffico in uscita dalla sandbox con un'interfaccia Private Service Connect (PSC-I).
Limitazioni e considerazioni
Tieni presenti le seguenti limitazioni e i seguenti confini di sicurezza quando configuri i Controlli di servizio VPC e Private Service Connect per le sandbox:
- Nessuna lista consentita di domini integrata per la sandbox: le sandbox e le risorse
SandboxEnvironmentTemplatenon hanno un campo della lista consentita di domini integrato. L'attivazione diinternet_access: Truesuegress_control_configsenzanetwork_attachmentconcede l'accesso in uscita senza limitazioni agli indirizzi IP pubblici (0.0.0.0/0, esclusi gli intervalli RFC 1918 privati e l'intervallo di metadati169.254.0.0/16). Per limitare le connessioni in uscita per nome di dominio (FQDN), URL o indirizzo IP, devi collegare il traffico in uscita della sandbox al tuo VPC con un'interfaccia Private Service Connect (network_attachment) e applicare il filtro nel tuo VPC utilizzando Cloud Next Generation Firewall (Cloud NGFW) o Secure Web Proxy (Secure Web Proxy). - Un singolo progetto consumer per l'accesso privato: l'accesso privato (PSC-E) può essere abilitato per un massimo di un progetto consumer, che deve essere lo stesso progetto utente in cui viene eseguita la sandbox.
- Risoluzione DNS e anti-tunneling: quando il traffico in uscita viene collegato al VPC, è supportata solo la risoluzione dei nomi privata tramite il peering Cloud DNS (
dns_peering_configs); il forwarding DNS pubblico è disabilitato per impedire l'esfiltrazione del tunnel DNS. - Cloud Audit Logs e ispezione delle minacce di rete: Cloud Audit Logs registra le chiamate del ciclo di vita del control plane e le RPC di esecuzione del piano dati (
ExecuteSandboxEnvironment,BidiExecuteSandboxEnvironmenteAuthorizeSandboxEnvironmentAccess), mentre il logging del payload di richiesta e risposta non è disponibile per le risorse protette dai Controlli di servizio VPC. I singoli processi secondari e i socket di rete all'interno del container non vengono registrati in Cloud Audit Logs. Per ispezionare le connessioni in uscita e rilevare le minacce di rete, abilita i log di flusso VPC, il logging delle regole di Cloud NGFW, il logging delle query DNS di Cloud DNS e i log di Secure Web Proxy nel tuo VPC. - Identità isolata in-sandbox: il codice all'interno della sandbox viene eseguito con un'identità tenant non privilegiata senza ruoli di Identity and Access Management (IAM) nel tuo progetto, non eredita l'identità dell'agente o il account di servizio dell'agente parent e non può eseguire query sul server dei metadati di Compute Engine (
169.254.169.254:80) per ottenere le credenziali. Per maggiori dettagli, consulta Identità di esecuzione e limiti delle credenziali. - Livelli di accesso al perimetro: l'accesso programmatico e alla console dall'esterno del perimetro viene negato, a meno che il chiamante non corrisponda a un livello di accesso sul perimetro.
Prima di iniziare
Prima di configurare i Controlli di servizio VPC o Private Service Connect per le sandbox, completa i seguenti prerequisiti:
- Crea o identifica il perimetro di servizio dei Controlli di servizio VPC che contiene il tuo progetto. Affinché le sandbox siano protette dal perimetro dei Controlli di servizio VPC, il tuo progetto Google Cloud deve trovarsi nel perimetro prima di creare le sandbox.
- Abilita l'API Agent Platform (
aiplatform.googleapis.com) nel tuo progetto. - Avere una rete VPC nella regione in cui esegui le sandbox.
- Verifica di disporre dei ruoli richiesti:
- Ruolo Amministratore Gestore contesto accesso per il perimetro
- Compute Network Admin (
roles/compute.networkAdmin) nel progetto proprietario del collegamento di rete.
Aggiungi Agent Platform al perimetro di servizio
Aggiungi l'API Agent Platform all'elenco dei servizi con limitazioni nel perimetro dei Controlli di servizio VPC. In questo modo, Agent Platform (incluso il control plane della sandbox) viene protetto e l'accesso a internet pubblico all'API viene bloccato, a meno che il chiamante non si trovi in un livello di accesso.
- Apri Controlli di servizio VPC nella console Google Cloud e modifica il perimetro.
- In Servizi limitati, aggiungi API Agent Platform (
aiplatform.googleapis.com). - Assicurati che le dipendenze utilizzate dalla sandbox si trovino nello stesso perimetro, in genere Cloud Storage (
storage.googleapis.com) e Artifact Registry (artifactregistry.googleapis.com, per le immagini container personalizzate). Lo spazio di archiviazione degli snapshot viene gestito automaticamente. - Per ripristinare l'accesso per gli utenti attendibili all'esterno del perimetro (ad esempio, la tua rete aziendale), collega un livello di accesso al perimetro.
(Facoltativo) Configura l'accesso privato alle API di Google
All'interno del perimetro dei Controlli di servizio VPC, la sandbox raggiunge le API di Google privatamente tramite l'indirizzo IP virtuale (VIP) limitato. Dalle tue reti VPC e on-premise, utilizza anche il VIP limitato in modo che le richieste non attraversino mai la rete internet pubblica:
- Instrada
*.googleapis.comal VIP limitato199.36.153.4/30e abilita l'accesso privato Google nelle subnet che chiamano le API di Google. - Crea zone private Cloud DNS per
googleapis.com(e, se esegui il pull delle immagini,pkg.dev/gcr.io) che si risolvono nel VIP limitato.
Controlla il traffico in uscita dalla sandbox con un'interfaccia Private Service Connect (PSC-I)
Poiché le sandbox non includono un'impostazione integrata per la lista consentita dei domini, utilizza un'interfaccia Private Service Connect (PSC-I) ogni volta che devi inserire nella lista consentita i domini in uscita (FQDN), filtrare gli URL o consentire alla sandbox di raggiungere i servizi privati. PSC-I collega tutto il traffico in uscita dalla sandbox al tuo VPC, in modo da poter gestire e registrare il traffico con i tuoi controlli di sicurezza VPC, indipendentemente dal fatto che il tuo progetto si trovi o meno all'interno di un perimetro dei Controlli di servizio VPC.
Ogni risorsa in questo passaggio viene creata nel progetto utente proprietario della sandbox o nel relativo progetto host del VPC condiviso. Il traffico in uscita viene indirizzato alla singola rete VPC e al collegamento di rete impostati nel template.
Crea il collegamento di rete
Crea il collegamento di rete per la sandbox:
# A dedicated subnet for the PSC interface (minimum /28)
gcloud compute networks subnets create sandbox-psc-subnet \
--network=YOUR_VPC \
--range=10.0.0.0/28 \
--region=REGION
# The network attachment the sandbox connects into
gcloud compute networks network-attachments create sandbox-egress-na \
--region=REGION \
--connection-preference=ACCEPT_AUTOMATIC \
--subnets=sandbox-psc-subnet
Fai riferimento all'allegato dal modello della sandbox
Imposta i campi del traffico in uscita su SandboxEnvironmentTemplate in modo che la sandbox instradi il traffico in uscita attraverso il VPC:
from vertexai import Client
client = Client(project="PROJECT_ID", location="REGION",
http_options={"api_version": "v1beta1"})
templates = client.agent_engines.sandboxes.templates
op = templates.create(
name=agent_instance_name,
display_name="cu-vpcsc-template",
config={
"custom_container_environment": {
"custom_container_spec": {"image_uri": "IMAGE_URI"},
"ports": [{"port": 8080, "protocol": "TCP"}],
},
"egress_control_config": {
"internet_access": True, # Enables outbound access from the sandbox. With VPC-SC, that traffic is bridged into your VPC.
"customer_vpc_network":
"projects/PROJECT_ID/global/networks/YOUR_VPC", # The VPC network in your project that egress is bridged into. Checked by VPC-SC at creation time.
"network_attachment":
"projects/PROJECT_ID/regions/REGION/networkAttachments/sandbox-egress-na", # The network attachment that accepts the sandbox's PSC interface.
},
},
)
L'interfaccia PSC crea il percorso privato nel VPC e la piattaforma indirizza automaticamente il traffico in uscita della sandbox verso questo percorso quando internet_access è abilitato.
Per configurare e gestire il percorso in uscita dal VPC, decidi se hai bisogno di un traffico in uscita solo privato o verso internet:
- Traffico in uscita verso internet: per il traffico in uscita verso internet, è necessario Cloud NAT, oltre al controllo della destinazione utilizzando le regole di Cloud Next Generation Firewall (Cloud NGFW) o Secure Web Proxy.
- Traffico in uscita solo privato (raggiungi i servizi nel tuo VPC o on-premise, senza internet): Cloud NAT non è richiesto. Hai solo bisogno di route, una regola firewall e il peering DNS.
Configura il traffico in uscita verso internet e gestisci le destinazioni
La sandbox entra nel VPC su un indirizzo interno (RFC 1918), quindi ha bisogno di Cloud NAT per accedere a internet. Prenota un IP in uscita statico se le tue destinazioni consentono l'accesso in base all'IP di origine.
# Reserve a static egress IP (optional, for destination-side allow-listing)
gcloud compute addresses create sandbox-egress-ip --region=REGION
# Cloud Router + NAT for the region, scoped to the PSC subnet
gcloud compute routers create sandbox-egress-router \
--network=YOUR_VPC --region=REGION
gcloud compute routers nats create sandbox-egress-nat \
--router=sandbox-egress-router --region=REGION \
--nat-external-ip-pool=sandbox-egress-ip \
--nat-custom-subnet-ip-ranges=sandbox-psc-subnet
Per limitare le destinazioni che la sandbox può raggiungere mentre il traffico transita nel VPC, scegli il livello di controllo di cui hai bisogno:
Cloud NGFW (a livello di rete): una policy del firewall di rete globale con regole di autorizzazione (sono supportati gli oggetti FQDN) e una regola di negazione predefinita per tutto il resto:
gcloud compute network-firewall-policies create sandbox-egress-policy --global # Allow only the destinations your agent needs (by FQDN) gcloud compute network-firewall-policies rules create 1000 \ --firewall-policy=sandbox-egress-policy --global-firewall-policy \ --direction=EGRESS --action=allow --layer4-configs=tcp:443 \ --dest-fqdns=api.partner.example.com # Default-deny the rest of egress gcloud compute network-firewall-policies rules create 65000 \ --firewall-policy=sandbox-egress-policy --global-firewall-policy \ --direction=EGRESS --action=deny --layer4-configs=all \ --dest-ip-ranges=0.0.0.0/0 gcloud compute network-firewall-policies associations create \ --firewall-policy=sandbox-egress-policy --global-firewall-policy \ --network=YOUR_VPCSecure Web Proxy (applicazione/L7): esegui il deployment di Secure Web Proxy come punto di ispezione in uscita nel VPC per la policy per URL con riconoscimento TLS e instrada il traffico in uscita della subnet PSC attraverso questo punto.
Configura per il traffico in uscita solo privato
Se la sandbox ha bisogno solo di servizi privati nel VPC o on-premise, assicurati che il VPC abbia una route verso la destinazione, consenti l'accesso con una regola firewall in uscita dalla subnet PSC (10.0.0.0/28) e risolvi il nome del servizio tramite il peering DNS.
Configura il peering DNS
Fornisci alla sandbox la risoluzione dei nomi tramite il VPC anziché i resolver pubblici (questo blocca anche l'esfiltrazione del tunnel DNS). Crea una zona privata Cloud DNS nel VPC con i record necessari alla sandbox, quindi configura il peering DNS in modo che la sandbox risolva i nomi di quella zona.
Concedi l'accesso all'agente di servizio (VPC condiviso)
Se il collegamento di rete si trova in un progetto (progetto A) diverso da quello in cui viene eseguita la sandbox (progetto B), concedi all'agente di servizio della piattaforma agente del progetto B il ruolo Utente di rete Compute nel progetto A:
# Agent Platform service agent of the project that runs the sandbox
service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com
# On the project that owns the network attachment
gcloud projects add-iam-policy-binding NETWORK_PROJECT_ID \
--member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com" \
--role="roles/compute.networkUser"
Sostituisci quanto segue:
PROJECT_NUMBER: il numero del progetto che esegue la sandbox.NETWORK_PROJECT_ID: l'ID del progetto proprietario del collegamento di rete.
Abilita il traffico privato in entrata con Private Service Connect (PSC-E)
I workload interattivi espongono un piano dati a cui un client deve connettersi. Raggiungi il piano dati tramite un endpoint Private Service Connect (PSC-E) privato nel tuo VPC anziché tramite l'internet pubblico.
Dichiara il progetto consumer consentito
Imposta la configurazione in entrata sul template con il progetto consumer autorizzato a connettersi. Solo lo stesso progetto utente in cui viene eseguita la sandbox può avere un traffico in entrata privato verso il VPC della sandbox.
Connettiti alla sandbox da un VPC nello stesso progetto:
config = {
# ...custom_container_environment, egress_control_config...
"ingress_control_config": {
"private_service_connect_config": {
# Must be the same project the sandbox runs in.
"enable_private_service_connect": True,
}
},
}
Crea l'endpoint PSC nel VPC
Dopo aver creato la sandbox, leggi il collegamento al servizio dalle informazioni di connessione:
# The sandbox returns a service attachment to connect to
service_attachment = sandbox.connection_info.service_attachment
Quindi, prenota un indirizzo IP interno e crea una regola di forwarding (endpoint PSC) nel VPC che ha come target il collegamento al servizio:
# Reserve an internal IP and create the PSC endpoint
gcloud compute addresses create sandbox-ingress-ip \
--region=REGION --subnet=YOUR_SUBNET
gcloud compute forwarding-rules create sandbox-ingress-ep \
--region=REGION \
--network=YOUR_VPC \
--address=sandbox-ingress-ip \
--target-service-attachment=SERVICE_ATTACHMENT_URI
I client nel VPC di quel progetto (o raggiungibili tramite questo) ora si connettono alla sandbox tramite l'IP privato dell'endpoint (ad esempio, un client che si connette tramite la porta WebSocket o CDP della sandbox).
Passaggi successivi
Per continuare a configurare e proteggere le sandbox, consulta le seguenti risorse:
- Leggi la panoramica della sandbox e Container personalizzati (BYOC).
- Scopri come funzionano le interfacce Private Service Connect con Agent Runtime.
- Consulta la Risoluzione dei problemi relativi ai Controlli di servizio VPC.
- Segui il codelab sull'interfaccia PSC di Agent Engine per una procedura dettagliata end-to-end sul traffico in uscita.