在 GKE 上设置智能体出站流量治理

本文档介绍了如何配置 Agent Gateway for Google Kubernetes Engine (GKE),以管理和保护在 GKE 集群上运行的自管理 AI 智能体的出站(出站流量)流量。

如需建立完整的出站流量数据路径,您需要结合使用多个 Google Cloud 和 GKE 网络服务。此设置会通过安全正向代理路由代理流量,该代理会强制执行您的政策并清理内容。

如需保护出站代理流量,请完成以下步骤:

  1. 启用 GKE 环境代理。
  2. 创建 Secure Web Proxy。
  3. 配置 mTLS 身份验证。
  4. 创建出站流量 Agent Gateway。
  5. 在 GKE 中配置出站流量重定向。
  6. 配置授权和内容安全政策。

如需详细了解此架构,请参阅 GKE 上的 Agent Gateway 概览。

准备工作

在配置出站流量治理之前,请完成以下前提条件:

  1. 完成 GKE 上的 Agent Gateway 概览中的常见前提条件。
  2. 工作负载配置:向 Agent Registry 注册工作负载,并使用 SPIFFE 身份部署工作负载。将以下内容保存为 agent.yaml,并将其应用于您的集群:

    apiVersion: v1
    kind: ServiceAccount
    metadata:
      name: KSA_NAME
      namespace: NAMESPACE
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: AGENT_NAME
      namespace: NAMESPACE
      labels:
        # Identifies the workload as an AI agent
        registry.gke.io/functional-type: "AGENT"
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: AGENT_NAME
      template:
        metadata:
          labels:
            app: AGENT_NAME
          annotations:
            # Indicates that the agent uses Agent Identity
            iam.gke.io/spiffe-identity-type: "agent-identity"
            # To assign an agent identity and per-Pod credentials to a workload
            iam.gke.io/identity: "spiffe://TRUST_DOMAIN/*"
        spec:
          serviceAccountName: KSA_NAME
          containers:
          - name: curl
            image: curlimages/curl:8.10.1
            command: ["sleep", "infinity"]
    

    替换以下内容:

    • KSA_NAME:Kubernetes 服务账号的名称。
    • NAMESPACE:服务账号的命名空间。
    • AGENT_NAME:代理部署的名称。
    • AGENT_IMAGE:代理的容器映像。
    • CONTAINER_NAME:代理容器的名称。
    • ORG_ID:您的 Google Cloud 组织的 ID。

启用 GKE 环境代理

为了重定向来自智能体的流量,Agent Gateway 使用了无边车的 GKE 环境代理。

  1. 按照为 Ambient Networking 准备集群中的说明准备集群。

  2. 为代理工作负载创建命名空间:

    kubectl create namespace NAMESPACE
    

    将 NAMESPACE 替换为命名空间的名称,例如 agent-ns。

  3. 将 Ambient 标签添加到包含代理工作负载的命名空间:

    kubectl label namespace NAMESPACE networking.gke.io/dataplane-mode=ambient
    

    将 NAMESPACE 替换为代理命名空间的名称,例如 agent-ns。

创建 Secure Web Proxy

如需强制执行安全政策并执行 Agent Gateway 护栏所需的 TLS 检查,您必须预配安全 Web 代理 (SWP) 以及必要的证书、证书授权机构 (CA) 池和网关安全政策。

  1. 创建代理专用子网。Secure Web Proxy 要求每个区域和 VPC 网络有一个活跃的代理专用子网。如果您的网络在您所在区域已有活跃的代理专用子网,则可以跳过此步骤。

    gcloud compute networks subnets create PROXY_SUBNET_NAME \
        --purpose=REGIONAL_MANAGED_PROXY \
        --role=ACTIVE \
        --region=REGION \
        --network=NETWORK \
        --range=10.10.0.0/24
    

    替换以下内容:

    • PROXY_SUBNET_NAME:子网的名称,例如 gateway-subnet。
    • REGION:子网的区域。
    • NETWORK:您的 VPC 网络的名称。
  2. 生成自签名证书和私钥:

    openssl req -x509 -newkey rsa:2048 -nodes \
        -keyout CERT_KEY_FILE.key \
        -out CERT_FILE.crt \
        -days CERT_VALIDITY_DAYS \
        -subj "/CN=SWP_HOSTNAME" \
        -addext "subjectAltName=DNS:SWP_HOSTNAME"
    

    替换以下内容:

    • CERT_KEY_FILE 和 CERT_FILE:私钥和证书的本地文件名,例如 swp。
    • CERT_VALIDITY_DAYS:证书的有效期,例如 365。
    • SWP_HOSTNAME:代理证书的主机名,例如 swp.example.internal。(代理不会通过此名称连接到代理,因此任何内部名称都可用于测试)。
  3. 将证书上传到与 SWP 位于同一区域的 Certificate Manager:

    gcloud certificate-manager certificates create CERTIFICATE_NAME \
        --location=REGION \
        --certificate-file=CERT_FILE.crt \
        --private-key-file=CERT_KEY_FILE.key
    

    替换以下内容:

    • CERTIFICATE_NAME:证书的名称,例如 swp-cert。
    • REGION:证书的区域。
    • CERT_FILE 和 CERT_KEY_FILE:您之前创建的证书和私钥的本地文件名。
  4. 创建 CA 池和根 CA:

    gcloud privateca pools create CA_POOL_NAME \
        --location=REGION \
        --tier=devops
    
    gcloud privateca roots create ROOT_CA_NAME \
        --pool=CA_POOL_NAME \
        --location=REGION \
        --subject="CN=CA_COMMON_NAME, O=ORGANIZATION" \
        --key-algorithm=rsa-pkcs1-4096-sha256 \
        --max-chain-length=1 \
        --auto-enable
    

    替换以下内容:

    • CA_POOL_NAME:CA 池的名称,例如 swp-ca-pool。
    • ROOT_CA_NAME:根 CA 的名称,例如 swp-root-ca。
    • CA_COMMON_NAME:CA 的通用名称,例如 swp-ca。
    • ORGANIZATION:组织的名称,例如 My Company。
  5. 允许网络安全服务代理从池中颁发证书:

    gcloud beta services identity create --service=networksecurity.googleapis.com
    
    gcloud privateca pools add-iam-policy-binding CA_POOL_NAME \
        --location=REGION \
        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-networksecurity." \
        --role=roles/privateca.certificateManager
    

    替换以下内容:

    • PROJECT_NUMBER:您的项目编号。将 PROJECT_NUMBER 替换为您的项目编号。
    • REGION:CA 池的区域。
    • CA_POOL_NAME:CA 池的名称。
  6. 导出 CA 证书。TrustConfig 会在后续步骤中使用此信息:

    gcloud privateca pools get-ca-certs CA_POOL_NAME \
        --location=REGION \
        --output-file=CA_CERT_FILE.pem
    

    替换以下内容:

    • CA_POOL_NAME:CA 池的名称。
    • REGION:CA 池的区域。
    • 将 CA_CERT_FILE 替换为证书的本地文件名,例如 swp-ca-cert。
  7. 创建 TLS 检查政策。

    1. 将以下内容保存为 tls-inspection.yaml:

      name: projects/PROJECT_ID/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME
      caPool: projects/PROJECT_NUMBER/locations/REGION/caPools/CA_POOL_NAME
      
    2. 导入政策:

      gcloud network-security tls-inspection-policies import TLS_INSPECTION_POLICY_NAME \
          --location=REGION \
          --source=tls-inspection.yaml
      

      替换以下内容:

      • TLS_INSPECTION_POLICY_NAME 替换为 TLS 检查政策的名称,例如 swp-tls-inspection。
      • REGION:政策的区域。
      • CA_POOL_NAME:CA 池的名称。
      • PROJECT_NUMBER:您的项目编号。
  8. 根据导出的 CA 证书生成 TrustConfig 并将其导入:

    { echo "trustStores:"; echo "- trustAnchors:"; echo "  - pemCertificate: |"; \
      sed 's/^/      /' CA_CERT_FILE.pem; } > trust-config.yaml
    
    gcloud certificate-manager trust-configs import TRUST_CONFIG_NAME \
        --location=REGION \
        --source=trust-config.yaml
    

    替换以下内容:

    • TRUST_CONFIG_NAME:信任配置的名称,例如 swp-trust-config。
    • REGION:信任配置所在的区域。
    • CA_CERT_FILE:您之前导出的 CA 证书的本地文件名。
  9. 创建网关安全政策和“全部允许”规则:

    1. 将该政策保存为 swp-policy.yaml:

      name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME
      description: POLICY_DESCRIPTION
      tlsInspectionPolicy: projects/PROJECT_NUMBER/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME
      
    2. 导入政策:

      gcloud network-security gateway-security-policies import POLICY_NAME \
          --location=REGION \
          --source=swp-policy.yaml
      
    3. 将规则保存为 rule.yaml:

      name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME/rules/RULE_NAME
      priority: RULE_PRIORITY
      enabled: true
      sessionMatcher: "SESSION_MATCHER"
      applicationMatcher: "APPLICATION_MATCHER"
      basicProfile: ALLOW
      tlsInspectionEnabled: true
      
    4. 导入规则:

      gcloud network-security gateway-security-policies rules import RULE_NAME \
          --gateway-security-policy=POLICY_NAME \
          --location=REGION \
          --source=rule.yaml
      
  10. 为 mTLS 创建服务器 TLS 政策。将以下内容保存为 server-tls.yaml:

    name: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME
    allowOpen: false
    mtlsPolicy:
      clientValidationMode: ALLOW_INVALID_OR_MISSING_CLIENT_CERT
      clientValidationTrustConfig: projects/PROJECT_NUMBER/locations/REGION/trustConfigs/TRUST_CONFIG_NAME
    

    导入政策:

    gcloud network-security server-tls-policies import SERVER_TLS_POLICY_NAME \
        --location=REGION \
        --source=server-tls.yaml
    

    替换以下内容:

    • SERVER_TLS_POLICY_NAME:政策的名称,例如 swp-server-tls。
    • TRUST_CONFIG_NAME:您之前创建的 TrustConfig 的名称(例如 swp-trust-config)。
  11. 创建 Secure Web Proxy。

    1. 将以下清单保存为 swp.yaml:

      name: projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME
      type: SECURE_WEB_GATEWAY
      addresses: ["IP_ADDRESS"]
      ports: [443, 80]
      certificateUrls: ["projects/PROJECT_ID/locations/REGION/certificates/CERTIFICATE_NAME"]
      serverTlsPolicy: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME
      gatewaySecurityPolicy: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME
      network: projects/PROJECT_ID/global/networks/NETWORK
      subnetwork: projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETWORK
      routingMode: EXPLICIT_ROUTING_MODE
      
    2. 导入代理:

      gcloud network-services gateways import SWP_NAME \
          --source=swp.yaml \
          --location=REGION
      

    替换以下内容:

    • IP_ADDRESS:代理的 IP 地址。
    • CERTIFICATE_NAME:您之前创建的 Certificate Manager 证书的名称(例如 swp-cert)。
    • NETWORK:VPC 网络的名称。
    • SUBNETWORK:子网的名称。
    • EXPLICIT_ROUTING_MODE:路由模式。对于 Agent Gateway,此字段必须为 EXPLICIT_ROUTING_MODE。
    • SERVER_TLS_POLICY_NAME:服务器 TLS 政策的名称。

配置 mTLS 身份验证

如需对 GKE 环境代理与 Secure Web Proxy 之间的流量进行身份验证,请配置双向 TLS (mTLS)。使用 Workload Identity Federation for GKE 时,您的 Workload Identity Federation for GKE 池已配置默认共享证书授权机构 (CA)。

如需验证此配置,请运行以下命令:

gcloud iam workload-identity-pools describe PROJECT_ID. \
    --location=global \
    --format="yaml(inlineCertificateIssuanceConfig)"

将 PROJECT_ID 替换为您的项目 ID。

在输出中,验证 useDefaultSharedCa 是否已设置为 true。预期输出结果类似如下所示:

inlineCertificateIssuanceConfig:
  keyAlgorithm: ECDSA_P256
  lifetime: 86400s
  rotationWindowPercentage: 50
  useDefaultSharedCa: true

如果 useDefaultSharedCa: true 缺失或设置为 false,请运行以下命令进行配置:

gcloud iam workload-identity-pools update PROJECT_ID. \
    --location=global \
    --use-default-shared-ca

创建出站流量 Agent Gateway

在 Agent Platform 中创建出站 Agent Gateway 资源,并将其连接到 Secure Web Proxy。

  1. 将以下清单保存为名为 agent-gateway.yaml 的文件:

    name: GATEWAY_NAME
    protocols:
    - MCP
    registries: ["//agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION"]
    selfManaged:
      resourceUris:
      - "projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME"
    

    替换以下内容:

    • 将 GATEWAY_NAME 替换为网关的名称,例如 my-agent-egress-gateway。
    • PROJECT_ID:您的 Google Cloud 项目 ID。
    • REGION:网关所在的区域。
    • SWP_NAME:Secure Web Proxy 的名称。
  2. 创建网关:

    gcloud beta network-services agent-gateways import GATEWAY_NAME \
        --source=agent-gateway.yaml \
        --location=REGION
    

    替换以下内容:

    • GATEWAY_NAME:Gateway 的名称,例如 my-agent-egress-gateway。
    • REGION:网关所在的区域。
  3. 如需验证 AgentGateway 资源是否已创建,请描述 Gateway:

    gcloud beta network-services agent-gateways describe GATEWAY_NAME \
        --location=REGION
    

    替换以下内容:

    • GATEWAY_NAME:Gateway 的名称,例如 my-agent-egress-gateway。
    • REGION:网关所在的区域。

在 GKE 中配置出站流量重定向

如需将出站智能体流量路由到 Secure Web Proxy,请为 GKE 环境代理定义代理的位置。

  1. 将以下清单保存为名为 swp-backend.yaml 的文件。您必须在代理工作负载所在的命名空间中创建 GCPBackend 资源。

    如果 Secure Web Proxy 与集群位于同一 VPC 中,请使用网关 URI:

    apiVersion: networking.gke.io/v1
    kind: GCPBackend
    metadata:
      name: swp-backend
      namespace: NAMESPACE
    spec:
      serviceUris:
      - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME"
    

    或者,如果您的代理位于其他 VPC 中并使用 Private Service Connect,请使用服务连接 URI:

    apiVersion: networking.gke.io/v1
    kind: GCPBackend
    metadata:
      name: swp-backend
      namespace: NAMESPACE
    spec:
      serviceUris:
      - "//compute.googleapis.com/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME"
    

    替换以下内容:

    • NAMESPACE:代理工作负载的命名空间。
    • PROJECT_ID:您的 Google Cloud 项目 ID。
    • REGION:代理或服务连接的区域。
    • SWP_NAME:代理的名称(适用于同一 VPC 设置)。
    • ATTACHMENT_NAME:Private Service Connect 服务连接的名称(适用于跨 VPC 设置)。
  2. 将清单应用到您的集群:

    kubectl apply -f swp-backend.yaml
    
  3. 获取集群的 Service IPv4 CIDR 范围:

    gcloud container clusters describe CLUSTER_NAME \
        --location=LOCATION \
        --format="value(ipAllocationPolicy.servicesIpv4Cidr)"
    

    替换以下内容:

    • CLUSTER_NAME:GKE 集群的名称。
    • LOCATION:集群的位置。
  4. 将以下清单保存为名为 egress-policy.yaml 的文件:

    apiVersion: networking.gke.io/v1
    kind: GCPEgressPolicy
    metadata:
      name: prod-egress-policy
      namespace: NAMESPACE
    spec:
      to:
        excludeCIDRRanges:
          - SERVICE_CIDR
          - VPC_CIDR
      proxyRef:
        group: networking.gke.io
        kind: GCPBackend
        name: swp-backend
    

    替换以下内容:

    • SERVICE_CIDR:上一步中的集群 Service CIDR,例如 34.118.224.0/20。
    • VPC_CIDR:不应通过代理的其他内部范围,例如 10.0.0.0/8。

    如需防止内部流量(例如与 Kubernetes 控制平面的通信)通过代理进行路由,请使用 excludeCIDRRanges 字段。

  5. 将清单应用到您的集群:

    kubectl apply -f egress-policy.yaml
    

    GKE Ambient 数据平面现在会将出站流量从代理命名空间路由到 Secure Web Proxy,以便强制执行政策。

(可选)部署测试客户端

如需验证出站流量政策是否正常运行,您可以部署一个具有已注册 SPIFFE 身份的测试代理(正控制)和一个没有身份的普通客户端(负控制)。

  1. 将以下清单保存为 agents.yaml:

    apiVersion: v1
    kind: ServiceAccount
    metadata:
      name: agent-sa
      namespace: NAMESPACE
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: test-agent
      namespace: NAMESPACE
      labels:
        registry.gke.io/functional-type: "AGENT"
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: test-agent
      template:
        metadata:
          labels:
            app: test-agent
          annotations:
            iam.gke.io/spiffe-identity-type: "agent-identity"
            iam.gke.io/identity: "spiffe://agents.global.org-ORG_ID.system.id.goog/*"
        spec:
          serviceAccountName: agent-sa
          containers:
          - name: curl
            image: curlimages/curl:8.10.1
            command: ["sleep", "infinity"]
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: plain-client
      namespace: NAMESPACE
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: plain-client
      template:
        metadata:
          labels:
            app: plain-client
        spec:
          containers:
          - name: curl
            image: curlimages/curl:8.10.1
            command: ["sleep", "infinity"]
    

    替换以下内容:

    • NAMESPACE:您的代理命名空间。
    • ORG_ID:您的 Google Cloud 组织的 ID。
  2. 应用部署并等待其就绪:

    kubectl apply -f agents.yaml
    kubectl rollout status deploy/test-agent deploy/plain-client -n NAMESPACE
    
  3. 将 Secure Web Proxy CA 证书复制到两个 Pod 中,以便它们在测试期间通过代理安全连接:

    B64=$(base64 -w0 CA_CERT_FILE.pem)
    
    for p in test-agent plain-client; do
      kubectl exec -i -n NAMESPACE deploy/"$p" -- sh -c "cat > /tmp/swp-ca.pem" < CA_CERT_FILE.pem
    done
    

    将 CA_CERT_FILE 替换为您在 Secure Web Proxy 设置期间导出的 CA 证书的本地名称。

配置授权和内容安全政策

如需强制执行访问权限控制并清理内容,请将出站流量转发到扩展服务(例如 Identity-Aware Proxy (IAP) 或 Model Armor),然后再将其发送到目的地。

然后,您可以将授权委托给 IAP 或自定义授权引擎,并将内容清理委托给 Model Armor。

将授权委托给 IAP

如需使用 IAP 为出站请求授权,请将扩展程序绑定到网关。

  1. 将以下匹配条件保存为名为 match.yaml 的文件,以定义哪些流量路由到 IAP。例如,如需在测试期间评估流向 example.com 的流量,请执行以下操作:

    name: ext-binding
    producerExtension: iap.googleapis.com
    target:
      resources:
      - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/GATEWAY_NAME"
    matchConditions:
    # invoke IAP for traffic to example.com for testing
    - to:
        destination:
          hosts:
          - exact: "example.com"
    
  2. 导入扩展程序绑定:

    gcloud beta service-extensions extension-bindings import my-iap-binding \
        --source=match.yaml \
        --location=REGION
    

    将 REGION 替换为扩展程序绑定的区域。

  3. 如需验证 IAP 响应,请运行以下测试命令:

    echo -n "no identity -> example.com: "; kubectl exec -n NAMESPACE deploy/plain-client -- curl -s -o /tmp/b -w "%{http_code} " --cacert /tmp/swp-ca.pem https://example.com/; kubectl exec -n NAMESPACE deploy/plain-client -- head -c 120 /tmp/b; echo
    echo -n "agent       -> example.com: "; kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /tmp/b -w "%{http_code} " --cacert /tmp/swp-ca.pem https://example.com/; kubectl exec -n NAMESPACE deploy/test-agent -- head -c 120 /tmp/b; echo
    echo -n "agent       -> www.google.com (no IAP match): "; kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /dev/null -w "%{http_code}\n" --cacert /tmp/swp-ca.pem https://www.google.com/
    

    预期输出:

    • 无身份 → example.com:401,正文…错误代码 1200(无令牌)
    • agent → example.com:200(示例网域 HTML)。绑定 IAP 后,您可能会在 IAP 传播期间先看到 403“出站流量请求未经授权”错误,持续约 1-2 分钟。
    • 代理 → www.google.com:200(绑定不匹配,因此跳过 IAP)

将内容安全防护工作委托给 Model Armor

为了防范出站流量中的提示注入和敏感数据泄露,您可以将 Google Cloud Model Armor 绑定到出站网关。

  1. 向 Agent Gateway 服务账号或 Service Extensions 服务账号授予所需角色。

    gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT" \
        --role="roles/modelarmor.calloutUser"
    
    gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT" \
        --role="roles/serviceusage.serviceUsageConsumer"
    
    gcloud projects add-iam-policy-binding MODEL_ARMOR_PROJECT_ID \
        --member="serviceAccount:SERVICE_ACCOUNT" \
        --role="roles/modelarmor.user"
    

    替换以下内容:

    • MODEL_ARMOR_PROJECT_ID:Model Armor 所在项目的 ID。
    • SERVICE_ACCOUNT:网关的服务账号。
  2. 创建 Model Armor 模板,以过滤敏感数据和提示词注入攻击。我们的后续验证步骤依赖于此配置:

    gcloud model-armor templates create TEMPLATE_NAME \
        --location=REGION \
        --basic-config-filter-enforcement=enabled \
        --pi-and-jailbreak-filter-settings-enforcement=enabled \
        --pi-and-jailbreak-filter-settings-confidence-level=MEDIUM_AND_ABOVE
    

    将 TEMPLATE_NAME 替换为模板的名称,例如 safety-template。

  3. 如需获取新模板的完整资源路径(扩展程序绑定步骤需要用到),请运行以下命令:

    gcloud model-armor templates describe TEMPLATE_NAME \
        --location=REGION \
        --format="value(name)"
    

    将 REGION 替换为模板所在的区域。

  4. 将以下匹配条件保存为名为 model-armor-match.yaml 的文件,以便在测试期间评估流向 www.google.com 的流量:

    - to:
        destination:
          hosts:
          - exact: "www.google.com"
    
  5. 将 Model Armor 绑定到您的网关:

    gcloud beta service-extensions extension-bindings create my-model-armor-binding \
        --location=REGION \
        --producer-extension="modelarmor.REGION.rep.googleapis.com" \
        --target-resources="//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/GATEWAY_NAME" \
        --fail-open \
        --match-conditions=model-armor-match.yaml \
        --producer-metadata=model_armor_settings='[{"request_template_id":"projects/TEMPLATE_PROJECT_ID/locations/REGION/templates/REQUEST_TEMPLATE","response_template_id":"projects/TEMPLATE_PROJECT_ID/locations/REGION/templates/RESPONSE_TEMPLATE"}]'
    

    替换以下内容:

    • REGION:Agent Gateway 所在的区域。绑定和 Model Armor 提供方扩展程序必须使用同一区域,并且 Model Armor 必须在该区域中可用。不接受其他区域和全球 modelarmor.googleapis.com 端点。
    • PROJECT_ID:您的 Google Cloud 项目 ID。
    • GATEWAY_NAME:Agent Gateway 的名称。
    • TEMPLATE_PROJECT_ID、REQUEST_TEMPLATE 和 RESPONSE_TEMPLATE:Model Armor 模板的详细信息。模板必须在 REGION 中创建。如果该区域中不存在模板,则匹配的请求会失败,并显示 HTTP 404“未找到”错误。

    注意:默认情况下,绑定会失败关闭(如果 Model Armor 不可用,请求会被屏蔽)。--fail-open 标志允许在无法访问扩展程序时传输流量。

  6. 如需验证 Model Armor 是否在过滤请求,请运行以下测试命令:

    SENS='{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy-html","arguments":{"value":"<html> card 4111111111111111</html>"}}}'
    BEN='{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy-html","arguments":{"value":"Hello, how are you?"}}}'
    
    kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -w " HTTP=%{http_code}\n" --cacert /tmp/swp-ca.pem -X POST -H 'Content-Type: application/json' -d "$SENS" "https://www.google.com/"
    kubectl exec -n NAMESPACE deploy/test-agent -- curl -s -o /dev/null -w "HTTP=%{http_code}\n" --cacert /tmp/swp-ca.pem -X POST -H 'Content-Type: application/json' -d "$BEN" "https://www.google.com/"
    

    预期输出:

    • sensitive: 403 {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"Traffic blocked by MA security policy."}],"isError":true}}
    • benign: 405(来源;它到达了 www.google.com)

将授权委托给自定义扩展程序

除了 IAP 之外,您还可以使用自定义扩展程序来委托授权决策。如需了解详情,请参阅提供方:构建和发布扩展程序,以创建适当的 ProducerExtension 和 ExtensionBinding。

问题排查

如果您遇到连接问题,请验证以下配置:

  • API:验证项目中是否已启用所有必需的 API。
  • 命名空间标签:验证您的代理命名空间是否具有 networking.gke.io/dataplane-mode=ambient 标签。
  • 自定义资源:验证 GCPBackend 和 GCPEgressPolicy 自定义资源是否已成功应用,且与智能体位于同一命名空间中。

后续步骤