Molte attività degli agenti comportano l'esecuzione di codice non attendibile, l'esecuzione di comandi, l'utilizzo di un browser web o l'interazione con ambienti esterni in modi che potrebbero comportare rischi per la sicurezza. Gemini Enterprise Agent Platform fornisce sandbox isolate per gestire questi workload in modo sicuro.
Le sandbox forniscono ambienti di esecuzione sicuri e isolati che vengono generati per eseguire attività specifiche per conto di un agente. Eseguendo queste operazioni in una sandbox, puoi proteggere la tua infrastruttura e i tuoi dati da azioni potenzialmente dannose o errate eseguite dall'agente. Le sandbox mitigano questi rischi:
- Isolamento: ogni sandbox è isolata dalle altre sandbox e dal sistema host. Le azioni intraprese da un agente in una sandbox non influiscono sugli altri agenti o utenti che condividono le stesse risorse di runtime.
- Sicurezza: le operazioni all'interno della sandbox sono limitate, impedendo l'accesso non autorizzato alle tue risorse. Tutti gli ambienti sandbox utilizzano il sandboxing dei container sicuro, fornendo un confine di sicurezza solido. Il codice dannoso non può accedere a dati sensibili o credenziali all'interno del runtime.
- Sicurezza: se un agente esegue un comando dannoso o un loop infinito, l'impatto è limitato alla sandbox. Ad esempio, un codice scritto male o dannoso potrebbe consumare tutta la CPU o la memoria disponibile.
Sandbox rispetto al runtime
L'Agent Runtime e una sandbox differiscono per scopo e utilizzo:
- Agent Runtime: questo è l'ambiente in cui vengono eseguite la logica principale, il processo decisionale e l'orchestrazione dell'agente. Si tratta di un ambiente attendibile che esegue il codice e gestisce il ciclo di vita dell'agente.
- Sandbox: si tratta di un ambiente ausiliario generato dall'agente o dalla piattaforma per eseguire attività specifiche, potenzialmente non sicure. Le sandbox possono essere di breve durata, basate su sessione o stateful per diversi giorni.
Ad esempio, se un agente deve calcolare una formula complessa generando ed eseguendo uno script Python personalizzato, deve eseguire lo script in una sandbox di esecuzione di codice, non nel proprio runtime. Inoltre, se l'agente utilizza una skill e uno script shell, deve eseguirli in un ambiente di cui è stato eseguito il provisioning specificamente per quella sessione, utilizzando l'accesso dell'utente finale.
Velocità di provisioning di TTL e Sandbox
Gli ambienti sandbox hanno le seguenti caratteristiche di durata (TTL) e provisioning:
- TTL: i TTL della sandbox variano da 7 giorni per un'immagine container personalizzata a 14 giorni per una sandbox di esecuzione di codice. In questo modo, puoi riprendere lo stato in un ambiente sandbox diversi giorni dopo per attività a lungo termine e ambienti shell ripristinabili.
- Provisioning: la creazione di una nuova sandbox richiede fino a 2 minuti per il provisioning delle risorse da un avvio a freddo, ma una volta eseguito il provisioning, le sandbox di solito si avviano in pochi secondi. Puoi visualizzare l'architettura sottostante nei seguenti progetti open source: AX e Substrate.
Funzionalità
Le sandbox offrono diverse funzionalità, come sandbox predefinite, container personalizzati, controlli di sicurezza aziendali e gestione del ciclo di vita:
- Esecuzione di codice: consente all'agente di generare ed eseguire codice in un ambiente sicuro. Questo è utile per calcoli matematici complessi, analisi dei dati e altre attività che richiedono calcoli.
- Utilizzo del computer: consente all'agente di interagire con un browser web per eseguire attività come la compilazione di moduli, la ricerca sul web o la navigazione in workflow complessi dell'interfaccia utente.
- Container personalizzati: puoi utilizzare i tuoi container per personalizzare l'ambiente di esecuzione con librerie, strumenti o configurazioni specifici. Utilizzalo per fornire all'agente un ambiente shell contenente i comandi e gli strumenti nell'immagine personalizzata.
- Controlli di servizio VPC: configura i perimetri di sicurezza per proteggere i dati sensibili e impedire l'uscita non autorizzata dagli ambienti sandbox.
- Chiavi di crittografia gestite dal cliente (CMEK): proteggi i dati at-rest della sandbox con chiavi di crittografia gestite in Cloud Key Management Service (Cloud KMS).
Confini di sicurezza, identità e osservabilità
Quando progetti agenti che eseguono codice o comandi non attendibili in una sandbox, tieni conto di come Agent Platform separa l'identità di esecuzione, il filtro del traffico in uscita dalla rete e l'audit logging tra Agent Runtime e il container della sandbox.
Identità di esecuzione e limiti delle credenziali
Il codice eseguito all'interno di una sandbox viene eseguito in un progetto tenant gestito da Google all'interno di un container isolato da gVisor e non eredita l'identità o le credenziali dell'agente parent. La tabella seguente riassume le identità coinvolte nelle operazioni della sandbox:
| Livello di identità | Entità | Ambito e autorizzazioni |
|---|---|---|
| Identità di Agent Runtime dell'agente parent | Identità agente (principal://agents.global.org-ORG_ID.system.id.goog/...) o il account di servizio personalizzato o predefinito collegato all'istanza ReasoningEngine |
Utilizzato dal codice di orchestrazione in esecuzione in Agent Runtime per chiamare le API Google Cloud e gestire o richiamare le sandbox. Non viene mai montato all'interno del container della sandbox. |
| Agente di servizio sandbox | service-PROJECT_NUMBER@gcp-sa-vertex-sandbox. |
Agente di servizio per progetto gestito da Google utilizzato dal control plane della sandbox per le attività dell'infrastruttura, come il pull di immagini container personalizzate da Artifact Registry o l'utilizzo di chiavi CMEK. Non sono mai accessibili al codice in esecuzione all'interno della sandbox. |
| Ambiente di esecuzione in-sandbox | Utente container senza privilegi (ad esempio appuser nelle sandbox della shell) supportato da un'identità tenant senza privilegi (sandbox-untrusted) senza ruoli Identity and Access Management (IAM) nel progetto |
Esegue il codice non attendibile all'interno del pod della sandbox. Non dispone di credenziali ambientali Google Cloud né di autorizzazioni per il tuo progetto o l'organizzazione principale ReasoningEngine. |
Tieni presente i seguenti limiti di credenziali e autenticazione quando esegui il codice all'interno di una sandbox:
- Nessun accesso ai token del server dei metadati o alle credenziali ambientali: il codice in sandbox non dispone di credenziali predefinite dell'applicazione (ADC) per il tuo progetto e non può eseguire query sul server dei metadati di Compute Engine (
169.254.169.254:80) per generare token di accesso OAuth 2.0, leggere chiavi dei account di servizio o ispezionare i metadati del progetto host. - Autenticazione del chiamante in entrata: l'agente o il client si autentica al control plane e al data plane della sandbox utilizzando IAM (autorizzazione
aiplatform.sandboxEnvironments.execute, inclusa in ruoli comeroles/aiplatform.user) o un token di accesso di breve durata generato dagenerate_access_tokenogenerate_browser_ws_headers. - Autenticazione delle chiamate in uscita dall'interno di una sandbox: poiché la sandbox non ha un'identità ambientale, qualsiasi chiamata API esterna effettuata direttamente dall'interno della sandbox deve utilizzare le credenziali fornite esplicitamente da te. Preferisci eseguire operazioni API Google Cloud autenticate nell'agente parent su Agent Runtime e passare solo i dati di input richiesti alla sandbox. Se il codice all'interno della sandbox deve chiamare direttamente un servizio esterno, inserisci token di breve durata e con ambito limitato per quella specifica esecuzione, anziché passare chiavi dei account di servizio di lunga durata.
Traffico in uscita dalla rete e inserimento dei domini nella lista consentita
Le sandbox non forniscono una proprietà di lista consentita dei domini integrata nella sandbox o nella risorsa SandboxEnvironmentTemplate. Il comportamento della rete in uscita dipende dal tipo di sandbox e dalle impostazioni egress_control_config nel template:
- Sandbox di esecuzione di codice: vengono eseguite senza accesso a internet in uscita o alla rete Virtual Private Cloud (VPC).
- Sandbox basate su modelli (Utilizzo del computer, Sandbox shell e Container personalizzati):
disattiva l'accesso a internet in uscita per impostazione predefinita (
internet_accessèFalse). - Traffico in uscita verso internet diretto (
internet_access: Truesenzanetwork_attachment): concede alla sandbox l'accesso in uscita senza limitazioni agli indirizzi IP pubblici (0.0.0.0/0), mentre le policy di rete bloccano l'accesso agli intervalli di indirizzi RFC 1918 privati (10.0.0.0/8,172.16.0.0/12,192.168.0.0/16) e all'intervallo di metadati link-local (169.254.0.0/16). Non puoi specificare un elenco di domini consentiti o negati direttamente inegress_control_config. - Lista consentita di domini e filtro in uscita con i controlli VPC:
per limitare una sandbox a domini (FQDN), URL o intervalli IP specifici,
configura
egress_control_config.network_attachmentsul template per collegare tutto il traffico in uscita della sandbox al tuo VPC tramite un'interfaccia Private Service Connect (Private Service Connect). Una volta che il traffico entra nel VPC, applica le liste consentite dei domini e le policy in uscita utilizzando:- Cloud Next Generation Firewall (Cloud NGFW): crea regole in uscita della policy del firewall di rete globale che consentano FQDN di destinazione o intervalli IP specifici e neghino tutto l'altro traffico in uscita (
0.0.0.0/0). - Secure Web Proxy (Secure Web Proxy): instrada il traffico in uscita dalla subnet Private Service Connect tramite Secure Web Proxy per l'ispezione TLS di livello 7 e l'inserimento nella lista consentita a livello di URL.
- Peering Cloud DNS: configura
dns_peering_configse le zone Cloud DNS private in modo che la sandbox risolva solo i nomi approvati tramite il VPC anziché i resolver DNS pubblici.
- Cloud Next Generation Firewall (Cloud NGFW): crea regole in uscita della policy del firewall di rete globale che consentano FQDN di destinazione o intervalli IP specifici e neghino tutto l'altro traffico in uscita (
Per istruzioni dettagliate sulla configurazione, consulta Configura i Controlli di servizio VPC e Private Service Connect con le sandbox.
Audit logging e rilevamento delle minacce
Il monitoraggio dell'osservabilità e della sicurezza per le sandbox comprende i piani di controllo e dei dati dell'API Agent Platform, l'agente parent su Agent Runtime e la tua rete VPC.
Copertura di Cloud Audit Logs
Agent Platform scrive le voci di Cloud Audit Logs con il nome del servizio aiplatform.googleapis.com e il tipo di risorsa monitorata audited_resource per le chiamate API effettuate alle risorse sandbox, ma non genera voci di log di controllo per i processi interni generati all'interno di un container. La tabella seguente riassume i dati registrati in ogni confine:
| Tipo di attività | Metodi o operazioni API | Categoria di log | Note |
|---|---|---|---|
| Mutazioni del ciclo di vita di sandbox e template | CreateSandboxEnvironment, DeleteSandboxEnvironment, SnapshotSandboxEnvironment, PauseSandboxEnvironment, ResumeSandboxEnvironment, CreateSandboxEnvironmentTemplate, UpdateSandboxEnvironmentTemplate, DeleteSandboxEnvironmentTemplate, DeleteSandboxEnvironmentSnapshot |
Attività di amministrazione (ADMIN_WRITE) |
Sempre attiva per impostazione predefinita. Registra l'identità del chiamante, il nome della risorsa e i metadati dell'operazione. |
| Letture dei metadati di sandbox e template | GetSandboxEnvironment, ListSandboxEnvironments, GetSandboxEnvironmentTemplate, ListSandboxEnvironmentTemplates, GetSandboxEnvironmentSnapshot, ListSandboxEnvironmentSnapshots |
Accesso ai dati (ADMIN_READ) |
Disattivata per impostazione predefinita. Abilita i log ADMIN_READ per aiplatform.googleapis.com per controllare chi ispeziona o elenca le sandbox. |
| Esecuzione dei comandi del piano dati e autorizzazione di accesso | ExecuteSandboxEnvironment, BidiExecuteSandboxEnvironment, AuthorizeSandboxEnvironmentAccess, ExecuteCode |
Accesso ai dati (DATA_WRITE) |
Disattivata per impostazione predefinita. Abilita i log DATA_WRITE per aiplatform.googleapis.com per controllare le RPC di esecuzione e la generazione di token. Per le risorse all'interno di un perimetro dei Controlli di servizio VPC, i payload di richiesta e risposta vengono omessi dagli audit log. |
| Processi secondari, scritture di file e frame di stream interattivi all'interno del container | Sottoprocessi generati da un comando shell, modifiche al file system e singoli frame inviati tramite una sessione WebSocket, Chrome DevTools Protocol (CDP) o PTY aperta | Non connesso a Cloud Audit Logs | Cloud Audit Logs registra la chiamata API iniziale (ExecuteSandboxEnvironment, BidiExecuteSandboxEnvironment o AuthorizeSandboxEnvironmentAccess), non le chiamate di sistema o i frame di stream in-guest successivi. |
Output stdout e stderr del container |
Stream di output standard ed errori dei comandi eseguiti all'interno della sandbox | Restituito nella risposta dell'API di esecuzione | La raccolta automatica di Cloud Logging (ad esempio reasoning_engine_stdout) si applica solo al runtime ReasoningEngine principale e non raccoglie i log dalle risorse secondarie della sandbox. Registra gli output comando dell'agente parent in Agent Runtime o consulta Gestisci le sandbox. |
Rilevamento e monitoraggio delle minacce
Le sandbox applicano il contenimento di runtime utilizzando l'isolamento del kernel gVisor nei progetti tenant gestiti da Google e non eseguono un agente di rilevamento delle intrusioni host in-guest integrato o uno scanner di vulnerabilità automatico pre-deployment. Per monitorare l'attività della sandbox e rilevare le minacce, combina i seguenti controlli:
- Abilita i log di controllo dell'accesso ai dati: abilita
ADMIN_READeDATA_WRITECloud Audit Logs suaiplatform.googleapis.comper rilevare la creazione non autorizzata di sandbox, la generazione di token di accesso (AuthorizeSandboxEnvironmentAccess) o le richieste di esecuzione. - Monitora il comportamento dell'agente parent: attiva il rilevamento anomalie degli agenti per analizzare tracce, chiamate di strumenti e pattern di esecuzione negli agenti Agent Runtime.
- Ispeziona il traffico in uscita dalla rete nel VPC: collega il traffico in uscita dalla sandbox al VPC utilizzando un'interfaccia Private Service Connect e abilita i log di flusso VPC sulla subnet Private Service Connect, il logging delle regole di Cloud NGFW, i log di accesso di Secure Web Proxy e il logging delle query DNS di Cloud DNS per rilevare connessioni in uscita anomale o tentativi di esfiltrazione di dati.
- Analizza le immagini container personalizzate prima del deployment: quando utilizzi container personalizzati (BYOC), abilita l'analisi delle vulnerabilità in Artifact Registry per identificare i pacchetti vulnerabili prima di fare riferimento all'URI dell'immagine in un
SandboxEnvironmentTemplate.