Configura los Controles del servicio de VPC y Private Service Connect con zonas de pruebas

Controla la entrada privada y la salida de Internet de una zona de pruebas de Agent Platform con Private Service Connect (PSC-E/PSC-I). Estos controles hacen que la zona de pruebas cumpla con los Controles del servicio de VPC dentro o fuera de un perímetro.

Descripción general

Los Controles del servicio de VPC te permiten definir un perímetro de servicio que aísla los recursos de Google Cloud para mitigar el riesgo de robo de datos. La zona de pruebas de Gemini Enterprise Agent Platform les brinda a tus agentes un entorno de procesamiento seguro y aislado para ejecutar código no confiable, controlar un navegador web (uso de la computadora) o ejecutar una imagen de contenedor personalizada. La zona de pruebas expone un plano de datos interactivo y realiza llamadas salientes, por lo que se rige por dos controles de Private Service Connect: entrada privada (PSC-E) y control de salida (PSC-I).

Cuando ejecutas la zona de pruebas dentro de un perímetro, los siguientes elementos permanecen protegidos dentro de tu límite:

  • Los datos que tu agente lee o escribe durante una sesión de zona de pruebas (archivos en el disco de la zona de pruebas, estado en la memoria).
  • Instantáneas de la zona de pruebas que capturan el estado del disco y de la memoria, y se almacenan automáticamente en un bucket de Cloud Storage.
  • Las solicitudes y respuestas intercambiadas con el plano de datos de la zona de pruebas (por ejemplo, comandos de uso de la computadora y capturas de pantalla)
  • Imágenes de contenedor personalizadas extraídas de Artifact Registry.
  • Llamadas que la zona de pruebas realiza a las APIs de Google (por ejemplo, Cloud Storage o Agent Platform)

También puedes configurar el control de entrada y salida sin un perímetro de Controles del servicio de VPC, ya que PSC-E (entrada privada) y PSC-I (salida) son lo que hace que una zona de pruebas cumpla con los Controles del servicio de VPC. Para configurar la entrada y la salida sin un perímetro de Controles del servicio de VPC, ve a Controla la salida de la zona de pruebas con una interfaz de Private Service Connect (PSC-I).

Limitaciones y consideraciones

Ten en cuenta las siguientes limitaciones y límites de seguridad cuando configures los Controles del servicio de VPC y Private Service Connect para entornos de pruebas:

  • No hay una lista de entidades permitidas de dominios de zona de pruebas integrada: Las zonas de pruebas y los recursos de SandboxEnvironmentTemplate no tienen un campo de lista de entidades permitidas de dominios integrado. Habilitar internet_access: True en egress_control_config sin un network_attachment otorga acceso saliente sin restricciones a las direcciones IP públicas (0.0.0.0/0, sin incluir los rangos privados de RFC 1918 ni el rango de metadatos 169.254.0.0/16). Para restringir las conexiones salientes por nombre de dominio (FQDN), URL o dirección IP, debes conectar la salida de la zona de pruebas a tu VPC con una interfaz de Private Service Connect (network_attachment) y aplicar el filtrado en tu VPC con Cloud Next Generation Firewall (Cloud NGFW) o Secure Web Proxy (Secure Web Proxy).
  • Proyecto de consumidor único para la entrada privada: La entrada privada (PSC-E) se puede habilitar para un proyecto de consumidor como máximo, que debe ser el mismo proyecto de usuario en el que se ejecuta la zona de pruebas.
  • Resolución de DNS y antitunelización: Cuando la salida se conecta a tu VPC, solo se admite la resolución de nombres privados a través del intercambio de tráfico de Cloud DNS (dns_peering_configs); el reenvío de DNS público está inhabilitado para evitar el robo de datos a través de túneles de DNS.
  • Registros de auditoría de Cloud y la inspección de amenazas de red: Los registros de auditoría de Cloud registran las llamadas del ciclo de vida del plano de control y las RPC de ejecución del plano de datos (ExecuteSandboxEnvironment, BidiExecuteSandboxEnvironment y AuthorizeSandboxEnvironmentAccess), mientras que el registro de cargas útiles de solicitudes y respuestas no está disponible para los recursos protegidos por los Controles del servicio de VPC. Los procesos secundarios individuales y los sockets de red dentro del contenedor no se registran en los Registros de auditoría de Cloud. Para inspeccionar las conexiones salientes y detectar amenazas de red, habilita los registros de flujo de VPC, el registro de reglas de Cloud NGFW, el registro de consultas de Cloud DNS y los registros de Secure Web Proxy en tu VPC.
  • Identidad aislada en la zona de pruebas: El código dentro de la zona de pruebas se ejecuta con una identidad de usuario no privilegiada sin roles de Identity and Access Management (IAM) en tu proyecto, no hereda la identidad del agente ni la cuenta de servicio del agente superior, y no puede consultar el servidor de metadatos de Compute Engine (169.254.169.254:80) para obtener credenciales. Para obtener más detalles, consulta Límites de credenciales y de identidad de ejecución.
  • Niveles de acceso del perímetro: Se rechaza el acceso programático y a la consola desde fuera del perímetro, a menos que el emisor coincida con un nivel de acceso en el perímetro.

Antes de comenzar

Antes de configurar los Controles del servicio de VPC o Private Service Connect para tus entornos de pruebas, completa los siguientes requisitos previos:

  • Crea o identifica el perímetro de servicio de los Controles del servicio de VPC que contiene tu proyecto. Para que los entornos de pruebas estén protegidos por el perímetro de los Controles del servicio de VPC, tu proyecto de Google Cloud debe estar en el perímetro antes de crear los entornos de pruebas.
  • Habilita la API de Agent Platform (aiplatform.googleapis.com) en tu proyecto.
  • Tener una red de VPC en la región en la que ejecutas las zonas de pruebas
  • Confirma que tienes los roles necesarios:

Agrega Agent Platform a tu perímetro de servicio

Agrega la API de Agent Platform a la lista de servicios restringidos en tu perímetro de Controles del servicio de VPC. Esto protege Agent Platform (incluido el plano de control de la zona de pruebas) y bloquea el acceso público a Internet a la API, a menos que el emisor tenga un nivel de acceso.

  1. Abre Controles del servicio de VPC en la consola de Google Cloud y edita tu perímetro.
  2. En Servicios restringidos, agrega la API de Agent Platform (aiplatform.googleapis.com).
  3. Asegúrate de que las dependencias que usa tu zona de pruebas estén en el mismo perímetro, por lo general, Cloud Storage (storage.googleapis.com) y Artifact Registry (artifactregistry.googleapis.com, para imágenes de contenedor personalizadas). El almacenamiento de instantáneas se administra automáticamente.
  4. Para restablecer el acceso de los usuarios de confianza fuera del perímetro (por ejemplo, tu red corporativa), adjunta un nivel de acceso al perímetro.

Opcional: Configura el acceso privado a las APIs de Google

Dentro del perímetro de los Controles del servicio de VPC, la zona de pruebas llega a las APIs de Google de forma privada a través de la dirección IP virtual (VIP) restringida. Desde tu propia VPC y redes locales, usa también la VIP restringida para que las solicitudes nunca atraviesen la Internet pública:

  • Enruta *.googleapis.com a la VIP restringida 199.36.153.4/30 y habilita el Acceso privado a Google en las subredes que llaman a las APIs de Google.
  • Crea zonas privadas de Cloud DNS para googleapis.com (y, si extraes imágenes, pkg.dev o gcr.io) que se resuelvan en la VIP restringida.

Controla la salida de la zona de pruebas con una interfaz de Private Service Connect (PSC-I)

Como las zonas de pruebas no incluyen un parámetro de configuración integrado de lista de dominios permitidos, usa una interfaz de Private Service Connect (PSC-I) cada vez que necesites incluir dominios salientes (FQDN) en la lista de entidades permitidas, filtrar URLs o permitir que la zona de pruebas acceda a servicios privados. PSC-I conecta toda la salida de la zona de pruebas a tu VPC para que puedas controlar y registrar ese tráfico con tus propios controles de seguridad de VPC, independientemente de si tu proyecto está dentro de un perímetro de Controles del servicio de VPC.

Cada recurso de este paso se crea en el proyecto de usuario que posee la zona de pruebas o en su proyecto host de VPC compartida. La salida se dirige a la única red de VPC y al adjunto de red que configuraste en la plantilla.

Crea el adjunto de red

Crea el adjunto de red para la zona de pruebas:

# 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

Haz referencia al archivo adjunto desde la plantilla de la zona de pruebas

Establece los campos de salida en SandboxEnvironmentTemplate para que la zona de pruebas enrute la salida a través de tu 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.
        },
    },
)

La interfaz de PSC compila la ruta de acceso privada a tu VPC, y la plataforma dirige automáticamente la salida de la zona de pruebas a ella cuando se habilita internet_access.

Para configurar y controlar la ruta de salida de tu VPC, decide si necesitas una salida a Internet o solo privada:

  • Salida de Internet: Para la salida de Internet, se requiere Cloud NAT, además del control de destino con reglas de Cloud Next Generation Firewall (Cloud NGFW) o Secure Web Proxy.
  • Salida solo privada (accede a los servicios de tu VPC o de forma local, sin Internet): No se requiere Cloud NAT. Solo necesitas rutas, una regla de firewall y un intercambio de tráfico de DNS.

Configura la salida de Internet y controla los destinos

La zona de pruebas ingresa a tu VPC en una dirección interna (RFC 1918), por lo que necesita Cloud NAT para llegar a Internet. Reserva una IP de salida estática si tus destinos permiten la lista de IPs de origen.

# 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

Para restringir los destinos a los que puede llegar la zona de pruebas a medida que su tráfico transita por tu VPC, elige el nivel de control que necesitas:

  • Cloud NGFW (nivel de red): una política de firewall de red global con reglas de permiso (se admiten objetos FQDN) y una denegación predeterminada para todo lo demás:

    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 (aplicación/L7): Implementa Secure Web Proxy como el punto de inspección de salida en tu VPC para la política por URL compatible con TLS y enruta la salida de la subred de PSC a través de él.

Configura la salida solo privada

Si la zona de pruebas solo necesita servicios privados en tu VPC o de forma local, asegúrate de que tu VPC tenga una ruta al destino, permítela con una regla de firewall de salida de la subred de PSC (10.0.0.0/28) y resuelve el nombre del servicio a través del intercambio de tráfico de DNS.

Configura el intercambio de tráfico de DNS

Proporcionar la resolución de nombres de la zona de pruebas a través de tu VPC en lugar de agentes de resolución públicos (esto también bloquea el robo de datos de túneles de DNS) Crea una zona privada de Cloud DNS en tu VPC con los registros que necesita la zona de pruebas y, luego, configura el intercambio de tráfico de DNS para que la zona de pruebas resuelva los nombres de esa zona.

Otorga acceso al agente de servicio (VPC compartida)

Si el adjunto de red se encuentra en un proyecto (proyecto A) independiente del proyecto en el que se ejecuta la zona de pruebas (proyecto B), otorga al agente de servicio de la plataforma de agentes del proyecto B el rol de usuario de red de Compute en el proyecto 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"

Reemplaza lo siguiente:

  • PROJECT_NUMBER: Es el número del proyecto que ejecuta la zona de pruebas.
  • NETWORK_PROJECT_ID: Es el ID del proyecto que posee el adjunto de red.

Habilita la entrada privada con Private Service Connect (PSC-E)

Las cargas de trabajo interactivas exponen un plano de datos al que se debe conectar un cliente. Accede a ese plano de datos a través de un extremo privado de Private Service Connect (PSC-E) en tu VPC en lugar de hacerlo a través de la Internet pública.

Declara el proyecto de consumidor permitido

Establece la configuración de entrada en la plantilla con el proyecto de consumidor que tiene permiso para conectarse. Solo el mismo proyecto de usuario en el que se ejecuta la zona de pruebas puede tener entrada privada a la VPC de la zona de pruebas.

Conéctate a la zona de pruebas desde una VPC en ese mismo proyecto:

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 el extremo de PSC en tu VPC

Después de crear la zona de pruebas, lee el adjunto de servicio desde su información de conexión:

# The sandbox returns a service attachment to connect to
service_attachment = sandbox.connection_info.service_attachment

Luego, reserva una dirección IP interna y crea una regla de reenvío (extremo de PSC) en tu VPC que se oriente al adjunto de servicio:

# 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

Los clientes en la VPC de ese proyecto (o a los que se puede acceder a través de ella) ahora se conectan a la zona de pruebas a través de la IP privada del extremo (por ejemplo, un cliente que se conecta a través del puerto de WebSocket o CDP de la zona de pruebas).

¿Qué sigue?

Para seguir configurando y protegiendo tus entornos de pruebas, consulta los siguientes recursos: