Contrôlez l'entrée privée et la sortie Internet d'un bac à sable Agent Platform avec Private Service Connect (PSC-E/PSC-I). Ces contrôles rendent le bac à sable conforme à VPC Service Controls à l'intérieur d'un périmètre ou sans périmètre.
Présentation
VPC Service Controls vous permet de définir un périmètre de service qui isole les ressources Google Cloud afin de limiter le risque d'exfiltration de données. Le bac à sable Gemini Enterprise Agent Platform offre à vos agents un environnement de calcul sécurisé et isolé pour exécuter du code non approuvé, piloter un navigateur Web (utilisation de l'ordinateur) ou exécuter une image de conteneur personnalisée. Le bac à sable expose un plan de données interactif et effectue des appels sortants. Il est donc régi par deux contrôles Private Service Connect : l'entrée privée (PSC-E) et le contrôle de sortie (PSC-I).
Lorsque vous exécutez le bac à sable dans un périmètre, les éléments suivants restent protégés dans votre limite :
- Données que votre agent lit ou écrit pendant une session de bac à sable (fichiers sur le disque du bac à sable, état en mémoire).
- Instantanés de bac à sable qui capturent l'état du disque et de la mémoire, et sont stockés automatiquement dans un bucket Cloud Storage.
- Les requêtes et les réponses échangées avec le plan de données du bac à sable (par exemple, les commandes d'utilisation de l'ordinateur et les captures d'écran).
- Images de conteneurs personnalisées extraites d'Artifact Registry.
- Appels que le bac à sable effectue vers les API Google (par exemple, Cloud Storage ou Agent Platform).
Vous pouvez également configurer le contrôle des entrées et des sorties sans périmètre VPC Service Controls, car ce sont PSC-E (entrée privée) et PSC-I (sortie) qui rendent un bac à sable compatible avec VPC Service Controls. Pour configurer l'entrée et la sortie sans périmètre VPC Service Controls, passez à Contrôler la sortie du bac à sable avec une interface Private Service Connect (PSC-I).
Limites et points à noter
Gardez à l'esprit les limites et les limites de sécurité suivantes lorsque vous configurez VPC Service Controls et Private Service Connect pour les bacs à sable :
- Pas de liste d'autorisation de domaine de bac à sable intégrée : les bacs à sable et les ressources
SandboxEnvironmentTemplatene disposent pas d'un champ de liste d'autorisation de domaine intégré. L'activation deinternet_access: Truesuregress_control_configsansnetwork_attachmentaccorde un accès sortant illimité aux adresses IP publiques (0.0.0.0/0, à l'exclusion des plages RFC 1918 privées et de la plage de métadonnées169.254.0.0/16). Pour limiter les connexions sortantes par nom de domaine complet (FQDN), URL ou adresse IP, vous devez relier la sortie du bac à sable à votre VPC à l'aide d'une interface Private Service Connect (network_attachment) et appliquer le filtrage dans votre VPC à l'aide de Cloud Next Generation Firewall (Cloud NGFW) ou de Secure Web Proxy. - Projet client unique pour l'entrée privée : l'entrée privée (PSC-E) peut être activée pour un projet client au maximum, qui doit être le même projet utilisateur que celui dans lequel le bac à sable s'exécute.
- Résolution DNS et anti-tunneling : lorsque la sortie est pontée dans votre VPC, seule la résolution de noms privée via l'appairage Cloud DNS (
dns_peering_configs) est acceptée. Le transfert DNS public est désactivé pour empêcher l'exfiltration par tunnel DNS. - Cloud Audit Logs et inspection des menaces réseau : Cloud Audit Logs enregistre les appels de cycle de vie du plan de contrôle et les RPC d'exécution du plan de données (
ExecuteSandboxEnvironment,BidiExecuteSandboxEnvironmentetAuthorizeSandboxEnvironmentAccess), tandis que la journalisation des charges utiles de requête et de réponse n'est pas disponible pour les ressources protégées par VPC Service Controls. Les processus enfants individuels et les sockets réseau à l'intérieur du conteneur ne sont pas consignés dans Cloud Audit Logs. Pour inspecter les connexions sortantes et détecter les menaces réseau, activez les journaux de flux VPC, la journalisation des règles Cloud NGFW, la journalisation des requêtes Cloud DNS et les journaux Secure Web Proxy dans votre VPC. - Identité isolée dans le bac à sable : le code à l'intérieur du bac à sable s'exécute sous une identité de locataire non privilégiée sans rôle IAM (Identity and Access Management) sur votre projet. Il n'hérite pas de l'identité d'agent ni du compte de service de l'agent parent, et ne peut pas interroger le serveur de métadonnées Compute Engine (
169.254.169.254:80) pour obtenir des identifiants. Pour en savoir plus, consultez Identité d'exécution et limites des identifiants. - Niveaux d'accès au périmètre : l'accès programmatique et à la console depuis l'extérieur du périmètre est refusé, sauf si l'appelant correspond à un niveau d'accès au périmètre.
Avant de commencer
Avant de configurer VPC Service Controls ou Private Service Connect pour vos bacs à sable, remplissez les conditions préalables suivantes :
- Créez ou identifiez le périmètre de service VPC Service Controls qui contient votre projet. Pour que les bacs à sable soient sécurisés par le périmètre VPC Service Controls, votre projet Google Cloud doit se trouver dans le périmètre avant de créer les bacs à sable.
- Activez l'API Agent Platform (
aiplatform.googleapis.com) dans votre projet. - Vous devez disposer d'un réseau VPC dans la région où vous exécutez les bacs à sable.
- Vérifiez que vous disposez des rôles requis :
- Rôle Administrateur Access Context Manager pour le périmètre
- Administrateur de réseaux Compute (
roles/compute.networkAdmin) dans le projet propriétaire du rattachement de réseau.
Ajouter Agent Platform à votre périmètre de service
Ajoutez l'API Agent Platform à la liste des services restreints de votre périmètre VPC Service Controls. Cela protège Agent Platform (y compris le plan de contrôle du bac à sable) et bloque l'accès à Internet public à l'API, sauf si l'appelant dispose d'un niveau d'accès.
- Ouvrez VPC Service Controls dans la console Google Cloud et modifiez votre périmètre.
- Sous Services restreints, ajoutez l'API Agent Platform (
aiplatform.googleapis.com). - Assurez-vous que les dépendances utilisées par votre bac à sable se trouvent dans le même périmètre, généralement Cloud Storage (
storage.googleapis.com) et Artifact Registry (artifactregistry.googleapis.com, pour les images de conteneurs personnalisées). Le stockage des instantanés est géré automatiquement pour vous. - Pour restaurer l'accès des utilisateurs de confiance situés en dehors du périmètre (par exemple, votre réseau d'entreprise), associez un niveau d'accès au périmètre.
Facultatif : Configurer l'accès privé aux API Google
Dans le périmètre VPC Service Controls, le bac à sable accède aux API Google de manière privée via l'adresse IP virtuelle (VIP) restreinte. Depuis votre propre VPC et vos réseaux sur site, utilisez également l'adresse IP virtuelle restreinte afin que les requêtes ne transitent jamais par l'Internet public :
- Acheminez
*.googleapis.comvers l'adresse IP virtuelle restreinte199.36.153.4/30et activez l'accès privé à Google sur les sous-réseaux qui appellent les API Google. - Créez des zones privées Cloud DNS pour
googleapis.com(et, si vous extrayez des images,pkg.dev/gcr.io) qui se résolvent en VIP restreinte.
Contrôler la sortie du bac à sable avec une interface Private Service Connect (PSC-I)
Comme les bacs à sable n'incluent pas de paramètre de liste d'autorisation de domaine intégré, utilisez une interface Private Service Connect (PSC-I) chaque fois que vous devez autoriser des domaines sortants (FQDN), filtrer des URL ou permettre au bac à sable d'accéder à des services privés. PSC-I relie toutes les sorties du bac à sable à votre VPC afin que vous puissiez gérer et consigner ce trafic avec vos propres contrôles de sécurité VPC, que votre projet se trouve ou non dans un périmètre VPC Service Controls.
Chaque ressource de cette étape est créée dans le projet utilisateur propriétaire du bac à sable ou dans son projet hôte de VPC partagé. La sortie est dirigée vers le réseau VPC et le rattachement de réseau uniques que vous avez définis dans le modèle.
Créer le rattachement de réseau
Créez le rattachement de réseau pour le bac à sable :
# 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
Référencer la pièce jointe à partir du modèle de bac à sable
Définissez les champs de sortie sur SandboxEnvironmentTemplate afin que le bac à sable achemine la sortie via votre 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'interface PSC crée le chemin d'accès privé vers votre VPC, et la plate-forme dirige automatiquement la sortie du bac à sable vers ce chemin d'accès lorsque internet_access est activé.
Pour configurer et gérer le chemin de sortie de votre VPC, déterminez si vous avez besoin d'une sortie Internet ou d'une sortie privée uniquement :
- Sortie Internet : pour la sortie Internet, Cloud NAT est requis, ainsi qu'un contrôle de destination à l'aide de règles Cloud Next Generation Firewall (Cloud NGFW) ou de Secure Web Proxy.
- Sortie privée uniquement (accès aux services de votre VPC ou sur site, pas d'Internet) : Cloud NAT n'est pas requis. Vous n'avez besoin que de routes, d'une règle de pare-feu et d'un appairage DNS.
Configurer la sortie Internet et régir les destinations
Le bac à sable entre dans votre VPC sur une adresse interne (RFC 1918). Il a donc besoin de Cloud NAT pour accéder à Internet. Réservez une adresse IP de sortie statique si vos destinations autorisent l'accès par adresse IP source.
# 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
Pour limiter les destinations que le bac à sable peut atteindre lorsque son trafic transite par votre VPC, choisissez le niveau de contrôle dont vous avez besoin :
Cloud NGFW (au niveau du réseau) : une stratégie de pare-feu réseau globale avec des règles d'autorisation (les objets FQDN sont acceptés) et un refus par défaut pour tout le reste :
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 (application/L7) : déployez Secure Web Proxy en tant que point d'inspection de sortie dans votre VPC pour une règle par URL compatible avec TLS, et acheminez la sortie du sous-réseau PSC via ce proxy.
Configurer pour une sortie privée uniquement
Si le bac à sable n'a besoin que de services privés dans votre VPC ou sur site, assurez-vous que votre VPC dispose d'une route vers la destination, autorisez-le avec une règle de pare-feu de sortie depuis le sous-réseau PSC (10.0.0.0/28) et résolvez le nom du service via l'appairage DNS.
Configurer l'appairage DNS
Donnez à la résolution de noms du bac à sable l'accès à votre VPC au lieu de résolveurs publics (cela bloque également l'exfiltration par tunnel DNS). Créez une zone privée Cloud DNS dans votre VPC avec les enregistrements dont le bac à sable a besoin, puis configurez l'appairage DNS pour que le bac à sable résolve les noms de cette zone.
Accorder l'accès à l'agent de service (VPC partagé)
Si le rattachement de réseau se trouve dans un projet distinct (projet A) de celui où le bac à sable est exécuté (projet B), attribuez à l'agent de service Agent Platform du projet B le rôle d'utilisateur de réseau Compute sur le projet 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"
Remplacez les éléments suivants :
PROJECT_NUMBER: numéro du projet qui exécute le bac à sable.NETWORK_PROJECT_ID: ID du projet propriétaire du rattachement de réseau.
Activer l'entrée privée avec Private Service Connect (PSC-E)
Les charges de travail interactives exposent un plan de données auquel un client doit se connecter. Accédez à ce plan de données via un point de terminaison Private Service Connect (PSC-E) privé dans votre VPC plutôt que via l'Internet public.
Déclarer le projet client autorisé
Définissez la configuration d'entrée sur le modèle avec le projet client autorisé à se connecter. Seul le projet utilisateur dans lequel le bac à sable s'exécute peut disposer d'un accès privé au VPC du bac à sable.
Connectez-vous au bac à sable à partir d'un VPC de ce même projet :
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,
}
},
}
Créer le point de terminaison PSC dans votre VPC
Une fois le bac à sable créé, lisez le rattachement de service à partir de ses informations de connexion :
# The sandbox returns a service attachment to connect to
service_attachment = sandbox.connection_info.service_attachment
Ensuite, réservez une adresse IP interne et créez une règle de transfert (point de terminaison PSC) dans votre VPC qui cible le rattachement de service :
# 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
Les clients du VPC de ce projet (ou accessibles via celui-ci) se connectent désormais au bac à sable via l'adresse IP privée du point de terminaison (par exemple, un client se connectant via le port WebSocket ou CDP du bac à sable).
Étapes suivantes
Pour continuer à configurer et à sécuriser vos bacs à sable, consultez les ressources suivantes :
- Consultez la présentation du bac à sable et la page Conteneurs personnalisés (BYOC).
- Découvrez comment les interfaces Private Service Connect fonctionnent avec Agent Runtime.
- Consultez Résoudre les problèmes liés à VPC Service Controls.
- Suivez l'atelier de programmation sur l'interface PSC Agent Engine pour découvrir la procédure de sortie de bout en bout.