Configura i Controlli di servizio VPC e Private Service Connect con le sandbox

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 SandboxEnvironmentTemplate non hanno un campo della lista consentita di domini integrato. L'attivazione di internet_access: True su egress_control_config senza network_attachment concede 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 metadati 169.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, BidiExecuteSandboxEnvironment e AuthorizeSandboxEnvironmentAccess), 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:

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.

  1. Apri Controlli di servizio VPC nella console Google Cloud e modifica il perimetro.
  2. In Servizi limitati, aggiungi API Agent Platform (aiplatform.googleapis.com).
  3. 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.
  4. 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.com al VIP limitato 199.36.153.4/30 e 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_VPC
    
  • Secure 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: