에이전트 게이트웨이 설정

에이전트 워크플로 전반에서 액세스 제어와 보안 연결을 중앙 집중화하려면 인그레스 또는 이그레스 트래픽을 관리하는 Agent Gateway 리소스를 설정하면 됩니다.

게이트웨이를 설정하기 전에 Agent Gateway 개요에서 개념적 기본 사항과 핵심 구성요소를 검토하세요.

필수 권한

Agent Gateway를 만들고 관리하려면 다음 권한이 필요합니다. 커스텀 역할 또는 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수 있습니다.

필수 권한

  • agentregistry.agents.list
  • agentregistry.endpoints.list
  • agentregistry.mcpServers.list
  • compute.networkAttachments.create
  • compute.networkAttachments.delete
  • compute.networkAttachments.get
  • compute.networkAttachments.list
  • compute.networkAttachments.update
  • compute.regionOperations.get
  • compute.regions.list
  • modelarmor.templates.list
  • networksecurity.authzPolicies.create
  • networksecurity.authzPolicies.delete
  • networksecurity.authzPolicies.get
  • networksecurity.authzPolicies.list
  • networksecurity.operations.get
  • networkservices.agentConnectivityTemplates.create
  • networkservices.agentConnectivityTemplates.delete
  • networkservices.agentConnectivityTemplates.get
  • networkservices.agentConnectivityTemplates.list
  • networkservices.agentConnectivityTemplates.update
  • networkservices.agentGateways.create
  • networkservices.agentGateways.delete
  • networkservices.agentGateways.get
  • networkservices.agentGateways.list
  • networkservices.agentGateways.update
  • networkservices.agentGateways.use
  • networkservices.authzExtensions.create
  • networkservices.authzExtensions.delete
  • networkservices.authzExtensions.get
  • networkservices.authzExtensions.list
  • networkservices.authzExtensions.update
  • networkservices.authzExtensions.use
  • networkservices.operations.get
  • certificatemanager.trustconfigs.create
  • certificatemanager.trustconfigs.get
  • certificatemanager.trustconfigs.list
  • certificatemanager.trustconfigs.use

필수 API

Agent Gateway를 배포하는 Cloud de Confiance 프로젝트에서 다음과 같은 최소 필수 API를 사용 설정합니다.

  • Compute Engine API (compute.googleapis.com): 핵심 네트워킹 인프라, 서브넷, 라우팅, Private Service Connect (PSC) 네트워크 연결을 제공합니다.
  • 네트워크 보안 API (networksecurity.googleapis.com): 게이트웨이 트래픽에 대한 승인 정책 (authzPolicies)을 만들고 시행합니다.
  • Network Services API (networkservices.googleapis.com): Agent Gateway 리소스 (agentGateways), 연결 템플릿 (agentConnectivityTemplates), 승인 확장 프로그램(authzExtensions)을 관리합니다.
  • Identity and Access Management API (iam.googleapis.com): 에이전트 ID의 서비스 계정과 IAM 통합 액세스 정책 (UAP)을 관리합니다.
  • Identity-Aware Proxy API (iap.googleapis.com): 에이전트, 엔드포인트, 서버 트래픽을 인증하고 확인합니다.
  • Agent Registry API (agentregistry.googleapis.com): 게이트웨이에서 관리하는 에이전트, MCP 서버, 도구 엔드포인트를 등록하고 관리합니다.

최소 필수 API를 사용 설정하려면 다음 명령어를 실행합니다.

gcloud services enable \
    compute.googleapis.com \
    networksecurity.googleapis.com \
    networkservices.googleapis.com \
    iam.googleapis.com \
    iap.googleapis.com \
    agentregistry.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID를 Agent Gateway를 배포하는 프로젝트 ID로 바꿉니다.

Agent Gateway와 함께 사용하는 기능, 모니터링 가능성 도구, Agent Runtime에 따라 선택적 API를 사용 설정해야 할 수도 있습니다.

기능별 선택적 API

  • 비공개 VPC 연결 및 TLS:
    • Cloud DNS API (dns.googleapis.com): 비공개 도메인 확인을 위해 Cloud DNS 피어링으로 VPC 연결을 구성하는 경우에만 필요합니다.
    • Certificate Manager API (certificatemanager.googleapis.com): 비공개 CA 또는 자체 서명 인증서를 사용하는 비공개 백엔드에 연결할 때 커스텀 TLS 신뢰 앵커(TrustConfig)를 구성하는 경우에만 필요합니다.
  • AI 안전 및 콘텐츠 필터링:
    • Model Armor API (modelarmor.googleapis.com): 프롬프트 인젝션, 유해한 콘텐츠, 민감한 정보를 검사하고 필터링하기 위해 Model Armor 가드레일을 사용 설정하는 경우에만 필요합니다.
  • 모니터링 가능성 및 감사:
    • Cloud Logging API (logging.googleapis.com): 게이트웨이 액세스 로그, 보안 감사 로그, 테스트 실행 정책 평가 이벤트를 캡처합니다.
    • Cloud Monitoring API (monitoring.googleapis.com): 게이트웨이 상태, 지연 시간, 처리량, 오류율을 추적하고 운영 알림을 구성합니다.
    • Observability API (observability.googleapis.com): 에이전트 및 게이트웨이 활동에 대한 통합 모니터링 가능성 및 운영 대시보드를 제공합니다.
    • Telemetry API (telemetry.googleapis.com): 플랫폼 구성요소 전반에서 런타임 원격 분석 및 성능 측정항목을 수집하고 스트리밍합니다.
    • Cloud Trace API (cloudtrace.googleapis.com): 에이전트와 백엔드 간의 멀티홉 요청을 검사하는 분산 추적을 제공합니다.
  • Agent Runtime 및 시맨틱 거버넌스:
    • Vertex AI API (aiplatform.googleapis.com): Agent Runtime 에이전트를 호스팅하거나 시맨틱 거버넌스 정책을 사용하는 프로젝트에 필요합니다.
    • Discovery Engine API (discoveryengine.googleapis.com): Gemini Enterprise 앱 및 에이전트를 호스팅하는 프로젝트에 필요합니다.
    • Agent Identity API (agentidentity.googleapis.com): 에이전트 아이덴티티 인증 관리자로 아웃바운드 사용자 인증 정보를 관리하거나 Cloud de Confiance 콘솔에서 에이전트 아이덴티티 인증 제공업체를 보는 경우에만 필요합니다.

Agent Gateway 배포 계획

이 섹션을 사용하여 Agent Gateway 배포를 계획하고 거버넌스 아키텍처 요구사항을 이해하세요. 새 대상을 등록하거나, 새 액세스 제어 정책을 추가하거나, 에이전트를 더 배포할 때 이 단계를 다시 수행할 수 있습니다.

배포 모드 선택

Agent Gateway는 두 가지 배포 모드를 지원합니다.

  • 클라이언트에서 에이전트로 (인그레스): 클라이언트에서 Cloud de Confiance에서 실행되는 에이전트로의 통신을 보호합니다.
  • 에이전트에서 모든 위치로 (이그레스): 에이전트에서 외부 대상, 공개 API, MCP 서버로의 통신을 보호합니다.

런타임, 프로젝트, 배포 리전 선택

Agent Gateway는 Gemini Enterprise 및 Runtime에서 실행되는 에이전트의 트래픽을 제어합니다.

  • Agent Runtime: Agent Gateway는 Agent-to-Anywhere (이그레스) 및 Client-to-Agent (인그레스) 모드를 모두 지원합니다. Agent-to-Anywhere 모드에서 에이전트는 게이트웨이와 동일한 프로젝트에 있거나 다른 프로젝트에 있을 수 있습니다. 클라이언트-에이전트 모드에서 에이전트는 게이트웨이와 동일한 프로젝트에 있어야 합니다. 두 모드 모두에서 에이전트는 게이트웨이와 동일한 리전에 있어야 합니다.

  • Gemini Enterprise: Agent Gateway는 Agent-to-Anywhere (이그레스) 모드만 지원합니다. Gemini Enterprise를 사용하면 각 게이트웨이가 배포된 프로젝트 및 리전의 범위 내에서만 에이전트형 상호작용을 제어합니다.

Gemini Enterprise와 런타임 전반에서 에이전트를 관리하려면 단일 Agent Gateway 인스턴스를 사용하면 됩니다. 또는 Gemini Enterprise 및 런타임에 독립적인 Agent Gateway 인스턴스를 배포할 수도 있습니다.

샘플 배포 패턴

다음은 고려할 수 있는 몇 가지 샘플 배포 패턴입니다.

런타임 에이전트의 프로젝트 간 거버넌스

이 배포 패턴에서는 전용 거버넌스 프로젝트에 Agent-to-Anywhere (이그레스) Agent Gateway를 배포합니다. 런타임 에이전트는 게이트웨이와 동일한 리전의 별도 프로젝트에 배포되며 조직 내 모든 폴더에 속할 수 있습니다.

프로젝트 간 이그레스 거버넌스를 설정하려면 다음 리소스를 구성합니다.

중앙 거버넌스 프로젝트에서 다음을 수행합니다.

  • Agent Gateway를 만듭니다. 게이트웨이가 Agent Registry 인스턴스와 연결되어 있는지 확인합니다.
  • 게이트웨이에 연결된 에이전트 레지스트리를 사용하여 도구, 서버 또는 엔드포인트와 함께 교차 프로젝트 에이전트를 등록합니다.
  • 이러한 프로젝트의 에이전트가 거버넌스 프로젝트의 게이트웨이에 바인딩할 수 있도록 에이전트가 기반으로 하는 각 프로젝트의 런타임 서비스 에이전트에 교차 프로젝트 IAM 권한을 부여합니다. 예시는 Agent Gateway를 통해 런타임 트래픽 라우팅을 참조하세요.
  • IAP 정책, 보안 주체 액세스 경계, SPIFFE 호환 워크로드 아이덴티티를 구성하여 승인된 엔드포인트로의 이그레스 트래픽을 제어하고 보호합니다.
  • 이그레스에 사용할 Model Armor 템플릿을 만듭니다.
  • VPC 네트워크로 이그레스하려면 거버넌스 프로젝트에서 PSC 네트워크 연결, 비공개 CA의 커스텀 TLS 신뢰 앵커 (tlsConfig), DNS 피어링 구성을 만들면 됩니다.

Agent Runtime 프로젝트에서 다음을 수행합니다.

  • 에이전트를 배포하고 거버넌스 프로젝트의 중앙 게이트웨이에 바인딩합니다.

교차 프로젝트 거버넌스는 Agent-to-Anywhere (이그레스) 게이트웨이가 있는 런타임에만 지원되며 Gemini Enterprise는 지원되지 않습니다.

Gemini Enterprise 및 Runtime 에이전트의 공유 거버넌스

이 배포 패턴에서는 Gemini Enterprise 앱과 Runtime 에이전트의 모든 트래픽이 단일 Agent Gateway를 통해 라우팅됩니다.

다음은 샘플 배포입니다.

  • Gemini Enterprise 앱은 global 배포로 배포됩니다.
  • 런타임 에이전트는 Gemini Enterprise 배포에 해당하는 단일 리전(us-central1) 내에 배포됩니다.
  • Agent Gateway는 동일한 리전(us-central1)에 배포됩니다.
  • global 및 us-central1 Agent Registry 인스턴스 모두 Agent Gateway와 연결할 수 있습니다. 에이전트와 대상은 게이트웨이와 연결된 Agent Registry 인스턴스에 등록되어야 합니다.
Gemini Enterprise 및 Runtime 에이전트의 독립적인 거버넌스

이 배포 패턴에서는 각 리전에 에이전트 트래픽을 모니터링하고 제어하는 전용 Agent Gateway가 있어 리전 격리를 보장합니다.

  • Gemini Enterprise 앱은 전역 또는 멀티 리전 배포 (global, us 또는 eu)로 배포됩니다.
  • 런타임 에이전트는 필요한 각 리전에 배포됩니다.
  • Agent Gateway 인스턴스는 에이전트와 앱이 있는 각 리전에 배포됩니다.
  • 각 게이트웨이와 연결된 Agent Registry 인스턴스에 에이전트와 대상을 등록해야 합니다.

에이전트 ID 설정

Agent Gateway에서 관리하는 모든 에이전트에는 고유한 에이전트 ID (SPIFFE ID)가 필요합니다. IAM 액세스 정책은 이 워크로드 아이덴티티에 따라 달라지므로 식별되지 않은 에이전트의 트래픽은 기본적으로 차단됩니다.

런타임에 에이전트를 배포하거나 기존 에이전트 워크로드에 할당할 때 에이전트 ID를 프로비저닝할 수 있습니다. 자세한 내용은 런타임에서 에이전트 ID 사용을 참조하세요.

에이전트 및 대상 리소스 등록

보안 통신을 사용 설정하려면 에이전트 레지스트리 인스턴스를 식별하고 게이트웨이가 제어할 리소스를 등록해야 합니다.

  1. 사용할 에이전트 레지스트리 인스턴스를 식별합니다. Agent Gateway는 최대 2개의 레지스트리(전역 레지스트리 1개와 리전 또는 멀티 리전 레지스트리 1개)와 연결할 수 있습니다.

    • Agent Runtime 에이전트는 리전별 리소스이며 일반적으로 배포 리전과 일치하는 리전별 레지스트리에 등록됩니다. 교차 프로젝트 에이전트는 Agent Gateway가 배포된 중앙 거버넌스 프로젝트와 연결된 레지스트리에 등록되어야 합니다.
    • Gemini Enterprise 에이전트는 전역 또는 멀티 리전 리소스이며 전역 또는 멀티 리전 레지스트리 (예: global, us 또는 eu)에 등록됩니다.

    Agent Gateway와 연결하는 레지스트리 인스턴스가 에이전트, 엔드포인트, 서버가 등록된 인스턴스인지 확인합니다.

  2. Agent Registry에 에이전트를 등록합니다. 아직 에이전트를 만들지 않았으면 나중에 이 단계를 완료해야 합니다. 자세한 내용은 에이전트 등록을 참조하세요.

  3. 권장사항: 에이전트가 호출할 모든 도구, MCP 서버, API 엔드포인트 (필수 플랫폼 API 포함)를 식별하고 등록합니다. 에이전트가 대상에 액세스하려면 항상 에이전트 ID에 iap.resources.egressViaIAP 권한을 부여하는 IAM 액세스 정책이 필요합니다. 세분화된 리소스별 정책과 도구 수준 제어를 적용할 수 있도록 에이전트 레지스트리에 리소스를 등록하는 것이 좋습니다. 등록되지 않은 대상의 경우 등록되지 않은 엔드포인트에 대한 정책을 구성하여 에이전트에 이 권한을 부여해야 합니다.

    게이트웨이와 다른 프로젝트에 있는 대상은 게이트웨이 프로젝트의 에이전트 레지스트리에 등록해야 합니다. 이러한 대상은 Agent-to-Anywhere 모드의 런타임 에이전트에만 유효합니다.

    자세한 내용은 다음 가이드를 참고하세요.

액세스 제어 정책 구성

모든 Agent Gateway에는 연결된 승인 정책이 필요합니다.

IAM (에이전트에서 모든 위치로 모드만 해당)

Agent Registry에 등록한 각 대상 리소스에 대해 에이전트 ID 주 구성원에 iap.resources.egressViaIAP 권한을 할당하는 IAM 정책을 구성합니다.

기본적으로 Agent Gateway는 IAM 액세스 정책이 에이전트 ID에 iap.resources.egressViaIAP 권한을 부여하여 대상 리소스에 대한 에이전트 액세스를 명시적으로 승인하지 않는 한 모든 트래픽을 차단합니다.

에이전트 레지스트리에 대상을 등록하면 정책 범위를 특정 리소스로 지정하고 세분화된 도구 제어를 적용할 수 있으므로 권장됩니다. 대상이 에이전트 레지스트리에 등록되지 않은 경우 등록되지 않은 엔드포인트에 대한 정책을 구성하여 에이전트에 iap.resources.egressViaIAP 권한을 부여해야 합니다.

레지스트리는 전역, 멀티 리전 또는 리전일 수 있으므로 레지스트리 전체 바인딩이 Agent Gateway에 구성된 레지스트리 인스턴스와 일치하는지 확인합니다.

자세한 내용은 IAM 에이전트 정책 만들기를 참조하세요.

트래픽을 차단하지 않고 구성을 검증하려면 처음에는 테스트 실행 모드로 IAP를 배포하는 것이 좋습니다.

Model Armor

(선택사항) 배포에 프롬프트 인젝션 공격, 탈옥, 유해한 콘텐츠 또는 민감한 정보 유출에 대한 보호가 필요한 경우 Model Armor 가드레일 통합을 계획하고 필요한 안전 필터로 템플릿을 만들어야 합니다.

자세한 내용은 다음 문서를 참조하세요.

시맨틱 거버넌스 정책

(선택사항) 에이전트에 자연어 기반 컨텍스트 인식 제어를 추가하여 유해한 도구 조합으로부터 보호할 수 있습니다.

트래픽을 차단하지 않고 구성을 검증할 수 있도록 시뮬레이션 모드에서 시맨틱 거버넌스 정책을 배포하는 것으로 시작하는 것이 좋습니다. 자세한 내용은 시맨틱 거버넌스 정책 구성을 참조하세요.

커스텀 승인 엔진

(선택사항) 서비스 확장 프로그램을 사용하여 커스텀 승인 엔진 또는 서드 파티 시스템에 승인을 위임하려면 게이트웨이를 배포할 때 커스텀 승인 엔진을 사용할 수 있는지 확인해야 합니다.

Model Armor, 시맨틱 거버넌스 정책, 기타 커스텀 승인 엔진은 초기 Agent Gateway 설정 중에 사용 설정하거나 배포 후 증분 보안 정책 업데이트로 연결할 수 있습니다.

에이전트에서 모든 위치로 (이그레스) 모드에서 Agent Gateway 구성

Agent-to-Anywhere (이그레스) 모드에서 Agent Gateway를 설정할 때 관리되는 트래픽이 대상 엔드포인트 및 도구에 도달하는 방식을 구성할 수 있습니다. 네트워킹 및 보안 요구사항에 따라 다음 배포 옵션 중에서 선택합니다.

  • 인터넷 이그레스: 게이트웨이는 인터넷을 통해 공개적으로 액세스 가능한 엔드포인트 및 API로 에이전트 트래픽을 안전하게 라우팅합니다. 인터넷 이그레스로 Agent Gateway를 구성하려면 이 페이지의 안내를 따르세요.

  • VPC 네트워크 이그레스: 게이트웨이는 Private Service Connect 네트워크 연결을 사용하여 에이전트 트래픽을 VPC 네트워크로 비공개로 라우팅합니다. VPC 네트워크를 통해 모든 트래픽을 라우팅(ALL_TRAFFIC)하거나 비공개 IP 주소 범위로 향하는 트래픽만 라우팅(PRIVATE_RANGES_ONLY)하도록 선택할 수 있습니다.

    VPC 이그레스로 Agent Gateway를 구성하려면 Agent Gateway에 VPC 연결 설정의 안내를 따라야 합니다.

다음 단계에 따라 Agent-to-Anywhere 통신을 위한 Agent Gateway 리소스를 만듭니다.

Cloud de Confiance 콘솔

  1. Cloud de Confiance 콘솔에서 Agent Gateway 페이지로 이동합니다.

    게이트웨이로 이동

  2. 게이트웨이 추가를 클릭합니다.
  3. 이름을 입력합니다.
  4. 리전 목록에서 리전을 선택합니다.
  5. 배포 모드에서 Google 관리가 선택되어 있는지 확인합니다.
  6. 에이전트 레지스트리의 경우 목록에서 레지스트리를 하나 이상 선택합니다. 레지스트리 2개를 선택하려면 하나는 전역 레지스트리여야 하고 다른 하나는 리전 또는 멀티 리전 레지스트리여야 합니다.배포에 선택할 레지스트리에 대한 안내는 Agent Gateway 배포 계획을 참조하세요.
  7. 제어되는 액세스 경로 목록에서 에이전트에서 어디로든 (에이전트 이그레스)를 선택합니다.

  8. 액세스 승인 섹션에서 IAP가 트래픽을 처리하는 방법을 선택합니다.

    • 게이트웨이가 모든 트래픽을 허용하고 감사 로그만 생성하는 테스트 실행 모드로 게이트웨이를 배포하려면 감사 전용을 선택합니다. 테스트 실행 모드에서는 IAM 정책이 IAP에 의해 적용되지 않습니다. 확신이 생기면 테스트 실행 모드를 사용 중지하여 IAM 정책을 적용할 수 있습니다.
    • 명시적인 Allow IAM 정책이 없는 요청을 차단하려면 정책 시행을 선택합니다. 이 옵션은 프로덕션 환경에 권장됩니다.
    • 정책 모델에서 통합 액세스 정책을 선택합니다.

  9. (선택사항) AI 보안 섹션에서 추가 보안을 구성합니다.

    1. Model Armor로 AI 모델 상호작용을 보호하려면 Model Armor 사용 설정을 사용 설정합니다.
    2. 목록에서 게이트웨이에 대한 수신 요청에 적용되는 템플릿을 선택합니다.

    3. 응답에 다른 템플릿을 사용하려면 요청 및 응답에 동일한 템플릿 사용을 선택 해제하고 목록에서 템플릿을 선택합니다.

  10. 게이트웨이 추가를 클릭합니다.

gcloud

YAML을 사용하여 선언적으로 Agent Gateway를 정의합니다.

  1. 리소스를 정의하고 구성을 YAML 파일에 저장합니다. 이 예시에서는 my-agent-gateway-egress.yaml를 사용합니다.

    name: AGENT_GATEWAY_NAME
protocols:
  - MCP
googleManaged:
  governedAccessPath: AGENT_TO_ANYWHERE
registries:
  - AGENT_REGISTRY_URI_1
  - OPTIONAL_AGENT_REGISTRY_URI_2

    다음을 바꿉니다.

    • AGENT_GATEWAY_NAME: Agent Gateway 리소스의 이름입니다.

    • AGENT_REGISTRY_URI_1 및 OPTIONAL_AGENT_REGISTRY_URI_2: 게이트웨이와 연결할 Agent Registry 인스턴스의 경로입니다. Agent Gateway에 대해 최대 2개의 레지스트리를 구성할 수 있습니다. 두 개의 레지스트리를 구성할 때 하나는 전역 레지스트리여야 하고 다른 하나는 리전 또는 멀티 리전 레지스트리일 수 있습니다. 배포에 선택할 레지스트리에 대한 안내는 Agent Gateway 배포 계획을 참조하세요. 레지스트리 경로는 다음과 같은 형식이어야 합니다.

      • 리전 레지스트리: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION
      • 전역 레지스트리: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/global
      • 멀티 리전 레지스트리: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/MULTI_REGION

  2. 다음 명령어를 실행하여 YAML 사양을 기반으로 Agent Gateway 리소스를 만듭니다.

    gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \
 --source="my-agent-gateway-egress.yaml" \
 --location=LOCATION

    LOCATION을 Agent Gateway 리소스를 만들려는 위치로 바꿉니다. 예를 들면 us-central1입니다.

    Gemini Enterprise의 경우 멀티 리전 설정에 해당하는 리전에 Agent Gateway를 배포해야 합니다. 지원되는 위치 매핑은 Agent Gateway를 통해 Gemini Enterprise 트래픽 라우팅을 참조하세요.

  3. Agent Gateway를 통과하는 트래픽에 중앙 집중식 액세스 제어 및 거버넌스 정책을 적용하는 승인 정책을 만듭니다. 다음 단계에서는 IAP를 사용하는 승인 정책을 구성하는 방법을 보여줍니다.

    1. IAP를 가리키는 승인 확장 프로그램을 구성합니다. YAML 파일(예: iap-request-authz-extension.yaml)에 확장 프로그램을 정의합니다. 제공된 샘플 값을 사용합니다.

      cat >iap-request-authz-extension.yaml <<EOF
name: AUTHORIZATION_EXTENSION_NAME
service: iap.googleapis.com
failOpen: false
timeout: 1s
metadata:
  iapPolicyVersion: "V2"
EOF

      승인 정책을 시행하지 않고 테스트하기 위해 드라이 런 감사 전용 모드로 확장 프로그램을 배포하려면 metadata 블록 내에 iamEnforcementMode 필드를 지정하면 됩니다. 이렇게 하면 정책을 확인하고 구성 오류로 인한 트래픽 중단 위험을 최소화할 수 있습니다.

      cat >iap-request-authz-extension.yaml <<EOF
name: AUTHORIZATION_EXTENSION_NAME
service: iap.googleapis.com
failOpen: false
timeout: 1s
metadata:
  iapPolicyVersion: "V2"
  iamEnforcementMode: "DRY_RUN"
EOF

      정책 시행을 시작할 준비가 되면 metadata 블록에서 iamEnforcementMode: "DRY_RUN" 필드를 삭제합니다.

    2. YAML 구성 파일을 승인 확장 프로그램으로 가져옵니다.

      gcloud beta service-extensions authz-extensions import AUTHORIZATION_EXTENSION_NAME \
  --source=iap-request-authz-extension.yaml \
  --location=LOCATION

      AUTHORIZATION_EXTENSION_NAME을 승인 확장 프로그램의 이름(예: my-iap-request-authz-ext)으로 바꿉니다.

    3. iap-request-authz-policy.yaml과 같은 YAML 파일에서 승인 정책을 정의하여 확장 프로그램을 게이트웨이와 연결합니다.

      cat >iap-request-authz-policy.yaml <<EOF
name: AUTHORIZATION_POLICY_NAME
target:
  resources:
    - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME"
policyProfile: REQUEST_AUTHZ
action: CUSTOM
customProvider:
  authzExtension:
    resources:
      - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/AUTHORIZATION_EXTENSION_NAME"
EOF

      다음을 바꿉니다.

      • AUTHORIZATION_POLICY_NAME: 승인 정책의 이름입니다(예: my-iap-request-authz-policy).
      • PROJECT_ID: 프로젝트 ID

    4. YAML 구성 파일을 승인 정책으로 가져옵니다.

      gcloud network-security authz-policies import AUTHORIZATION_POLICY_NAME \
  --source=iap-request-authz-policy.yaml \
  --location=LOCATION

  4. 선택사항: 프롬프트 인젝션 공격 및 민감한 정보 유출로부터 배포를 보호하는 데 도움이 되도록 Model Armor 가드레일을 구성하려면 Model Armor에 승인 위임을 참조하세요.

Terraform

google 제공업체를 사용하여 중앙 거버넌스 프로젝트에서 Agent-to-Anywhere (이그레스) Agent Gateway와 관련 IAP 승인 확장 프로그램 및 정책을 선언적으로 프로비저닝하려면 다음 안내를 따르세요.

  1. google_network_services_agent_gateway 리소스를 만들고 리전 또는 전역 Agent Registry 인스턴스를 연결합니다.

    resource "google_network_services_agent_gateway" "egress_gateway" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "AGENT_GATEWAY_NAME"
  protocols = ["MCP"]

  google_managed {
    governed_access_path = "AGENT_TO_ANYWHERE"
  }

  registries = [
    "//agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION",
  ]
}

  2. IAP google_network_services_authz_extension를 구성하고 google_network_security_authz_policy를 사용하여 게이트웨이에 연결합니다.

    resource "google_network_services_authz_extension" "iap_request_authz_ext" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "my-iap-request-authz-ext"
  service   = "iap.googleapis.com"
  timeout   = "1s"
  fail_open = false

  metadata = {
    iapPolicyVersion = "V2"
    # Uncomment the following line to deploy in dry-run (audit-only) mode:
    # iamEnforcementMode = "DRY_RUN"
  }
}

resource "google_network_security_authz_policy" "iap_request_authz_policy" {
  project        = "PROJECT_ID"
  location       = "LOCATION"
  name           = "my-iap-request-authz-policy"
  policy_profile = "REQUEST_AUTHZ"
  action         = "CUSTOM"

  target {
    resources = [
      google_network_services_agent_gateway.egress_gateway.id
    ]
  }

  custom_provider {
    authz_extension {
      resources = [
        google_network_services_authz_extension.iap_request_authz_ext.id
      ]
    }
  }
}

  1. 에이전트 게이트웨이가 생성되면 프로젝트 및 선택한 리전 내에서 에이전트 트래픽을 라우팅하는 기본 연결 지점 역할을 합니다. 이제 이 엔드포인트를 사용하여 에이전트와 대상 (도구, 다른 에이전트 또는 다른 엔드포인트) 간에 안전하고 암호화되고 인증된 통신 채널을 설정할 수 있습니다.

    이 페이지의 Agent Gateway 배포 계획 섹션을 다시 검토하고 에이전트가 Agent Registry에 등록되어 있고 에이전트가 연결하려는 모든 대상에 대해 iap.resources.egressViaIAP 권한을 부여받았는지 확인합니다. 연결 문제가 발생하면 Agent Gateway 연결 문제 해결을 참조하세요.

다음으로 에이전트를 배포하고 Agent Gateway를 통해 트래픽을 라우팅하는 방법을 알아봅니다.

클라이언트에서 에이전트로 (인그레스) 모드에서 Agent Gateway 구성

이 섹션에서는 클라이언트-에이전트 통신을 위한 Agent Gateway를 설정하는 방법을 보여줍니다.

다음 단계에 따라 Agent Gateway 리소스를 만듭니다.

Cloud de Confiance 콘솔

  1. Cloud de Confiance 콘솔에서 Agent Gateway 페이지로 이동합니다.

    게이트웨이로 이동

  2. 게이트웨이 추가를 클릭합니다.
  3. 이름을 입력합니다.
  4. 리전 목록에서 리전을 선택합니다.
  5. 배포 모드에서 Google 관리가 선택되어 있는지 확인합니다.
  6. 에이전트 레지스트리 설정을 그대로 둡니다. 레지스트리는 인그레스에 사용되지 않습니다.
  7. 관리형 액세스 경로 목록에서 클라이언트-에이전트 (인그레스)를 선택합니다.

  8. (선택사항) AI 보안 섹션에서 추가 보안을 구성합니다.

    1. Model Armor로 AI 모델 상호작용을 보호하려면 Model Armor 사용 설정을 사용 설정합니다.

    2. 목록에서 게이트웨이에 대한 수신 요청에 적용되는 템플릿을 선택합니다.

    3. 응답에 다른 템플릿을 사용하려면 요청 및 응답에 동일한 템플릿 사용을 선택 해제하고 목록에서 템플릿을 선택합니다.

  9. 게이트웨이 추가를 클릭합니다.

gcloud

YAML을 사용하여 선언적으로 Agent Gateway를 정의합니다.

  1. 리소스를 정의하고 구성을 YAML 파일에 저장합니다. 이 예시에서는 my-agent-gateway-ingress.yaml를 사용합니다.

    name: AGENT_GATEWAY_NAME
protocols:
  - MCP
googleManaged:
  governedAccessPath: CLIENT_TO_AGENT

    AGENT_GATEWAY_NAME을 Agent Gateway 리소스 이름으로 바꿉니다.

  2. 다음 명령어를 실행하여 YAML 사양을 기반으로 Agent Gateway 리소스를 만듭니다.

    gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \
 --source="my-agent-gateway-ingress.yaml" \
 --location=LOCATION

    LOCATION을 Agent Gateway 리소스를 만들려는 위치로 바꿉니다. 예를 들면 us-central1입니다.

Terraform

google 제공업체를 사용하여 클라이언트에서 에이전트로 (인그레스) Agent Gateway 리소스를 선언적으로 프로비저닝하려면 다음 안내를 따르세요.

resource "google_network_services_agent_gateway" "ingress_gateway" {
  project   = "PROJECT_ID"
  location  = "LOCATION"
  name      = "AGENT_GATEWAY_NAME"
  protocols = ["MCP"]

  google_managed {
    governed_access_path = "CLIENT_TO_AGENT"
  }
}

Agent Gateway가 생성되면 프로젝트 및 선택한 리전의 에이전트로 트래픽을 라우팅하는 기본 연결 지점 역할을 합니다.

다음으로 에이전트를 배포하고 Agent Gateway를 통해 트래픽을 라우팅하는 방법을 알아봅니다.

에이전트 배포 및 Agent Gateway를 통한 트래픽 라우팅

Agent Gateway를 통해 트래픽을 라우팅하는 Agent Runtime 에이전트를 배포하려면 Agent Gateway를 통해 트래픽 라우팅을 참조하세요.

Agent Gateway를 통해 트래픽을 라우팅하는 Gemini Enterprise 에이전트를 배포하려면 Agent Gateway를 통해 Gemini Enterprise 트래픽 라우팅을 참조하세요.

Codelab

Agent Gateway를 설정하고 사용하는 방법에 대한 엔드 투 엔드 데모는 다음 Codelab을 참조하세요.

다음 단계

가이드

안전하고 제어된 연결을 위해 Agent Gateway를 통해 Agent Runtime 트래픽을 라우팅하는 방법을 알아봅니다.

가이드

Agent Gateway의 승인을 IAP, Model Armor 또는 자체 커스텀 승인 서비스에 위임하는 방법을 알아봅니다.

가이드

Agent Gateway를 모니터링하는 방법을 알아봅니다.

문제 해결

Agent Gateway 연결 문제를 해결하는 방법을 알아봅니다.

가이드

Agent Gateway를 통해 Gemini Enterprise 트래픽을 라우팅하는 방법을 알아봅니다.