이 페이지에서는 Secure Web Proxy의 승인 정책을 구성하는 방법을 설명합니다.
시작하기 전에
Secure Web Proxy 개요 및 승인 정책 개요 페이지를 검토합니다.
-
- Network Security API
- Network Services API
- Certificate Manager API
적절한 역할 및 권한이 있는지 확인합니다.
활성 Secure Web Proxy 인스턴스가 배포되고
GatewaySecurityPolicy와 연결되어 있어야 합니다. 자세한 내용은 Secure Web Proxy 인스턴스 배포를 참조하세요.Secure Web Proxy 승인 정책을 구성하려면 TLS 검사 정책을 사용 설정해야 합니다.
승인 정책 만들기
두 가지 사용 사례에 대해 승인 정책을 구성할 수 있습니다.
에이전트 트래픽 제어: AI 에이전트에서 모델 컨텍스트 프로토콜(MCP) 서버, 도구, 모델로의 아웃바운드 트래픽을 보호하려면 에이전트 대상에 대한 승인 정책 구성을 참조하세요.
agentGateway리소스에서 정책 및 확장 프로그램 바인딩을 구성하여 MCP 도구 제한, mTLS 에이전트 ID, 페이로드 정제를 시행할 수 있습니다.비에이전트형 웹 트래픽 보호: 비에이전트형 엔터프라이즈 워크로드에서 아웃바운드 웹 트래픽을 보호하려면 다음 섹션의 예시를 참조하세요. 보안 웹 프록시
Gateway리소스에서 직접 정책을 구성하여 mTLS 클라이언트 인증서 ID, 서비스 계정, 보안 태그 또는 커스텀 승인 확장 프로그램을 적용할 수 있습니다.
Secure Web Proxy의 승인 정책을 만들려면 다음을 수행합니다.
- 타겟과 규칙을 정의하는 YAML 파일을 구성합니다.
- YAML 파일을 가져오려면
gcloud network-security authz-policies import명령어를 실행합니다.
에이전트형 대상에 대한 승인 정책 구성
Secure Web Proxy를 Agent Gateway로 배포하면 승인 정책을 정의하여 MCP 도구 서버 및 AI 에이전트 대상으로 전달되는 트래픽을 검사하고 제한할 수 있습니다.
다음 요청 레이어에서 액세스 제어를 시행하는 규칙을 구성할 수 있습니다.
네트워크 규칙: 특정 신뢰할 수 있는 외부 모델 또는 Agent Endpoint에 대해 TLS 검사 또는 심층 페이로드 분석을 건너뜁니다.
확장 프로그램 바인딩: Service Extensions의
ExtensionBinding리소스를 사용하여 에이전트 본인 인증을 위한 IAP(Identity-Aware Proxy), 프롬프트 및 대답 정제를 위한 Model Armor와 같은 외부 거버넌스 및 보안 프로세서를 연결합니다.HTTP MCP 메서드 및 도구 필터링:
tools/list또는tools/call와 같은 특정 MCP 작업에 대한 세분화된 제어를 시행하고 인수를 검증하여 에이전트가 호출할 수 있는 도구를 제한합니다.
승인 규칙 평가 순서
Agent Gateway를 통해 아웃바운드 AI 에이전트 트래픽을 처리할 때 규칙은 다음 순서로 평가됩니다.
네트워크(L4) 승인 규칙: 먼저 평가됩니다. 외부 모델 엔드포인트에 대한 직접 통신을 허용하는 등 SNI 일치 규칙이 적용되면 트래픽이 TLS 가로채기를 우회합니다.
TLS 가로채기: 우회되지 않은 트래픽은 게이트웨이의 TLS 검사 정책을 사용하여 가로채고 복호화됩니다.
확장 프로그램 바인딩 규칙: 요청은 구성된 확장 프로그램 서비스에 의해 평가됩니다. 예를 들어 IAP는 요청 헤더에서 호출자 ID를 확인하고 Model Armor는 복호화된 페이로드를 검사하여 프롬프트 안전성을 확인하고 응답에서 데이터 유출을 방지합니다.
HTTP(L7) 승인 규칙: MCP 도구 제한 및 메서드 필터링과 같은 HTTP 수준 승인 정책이 평가됩니다.
예시 1: MCP 도구 실행 제한
다음 예시에서는 에이전트가 도구를 검색하고(tools/list) 승인된 도구만 실행할 수 있도록 허용하는(get_weather 및 get_location에 대한 tools/call) agentGateway 리소스에 연결된 승인 정책을 보여줍니다.
authz-policy-mcp.yaml파일을 만듭니다.name: authz-policy-restrict-tools target: resources: - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME" policyProfile: REQUEST_AUTHZ httpRules: - to: operations: - mcp: baseProtocolMethodsOption: MATCH_BASE_PROTOCOL_METHODS methods: - name: "tools/list" - name: "tools/call" params: - exact: "get_weather" - exact: "get_location" action: ALLOW다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전AGENT_GATEWAY_NAME: Secure Web Proxy 게이트웨이와 연결된agentGateway리소스의 이름
승인 정책을 가져오려면
gcloud network-security authz-policies import명령어를 실행합니다.gcloud network-security authz-policies import authz-policy-restrict-tools \ --source=authz-policy-mcp.yaml \ --location=LOCATION
예시 2: SNI 일치를 사용하여 TLS 가로채기 우회
특정 외부 모델 제공업체 또는 에이전트 API가 인증서 고정을 사용하거나 페이로드 검사가 필요하지 않은 경우 네트워크 규칙을 사용하여 서버 이름 표시(SNI)를 일치시키고 세션을 복호화하지 않고 연결을 허용할 수 있습니다.
authz-policy-sni.yaml파일을 만듭니다.name: authz-policy-skip-interception target: resources: - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME" policyProfile: REQUEST_AUTHZ networkRules: - to: operations: - snis: - exact: "api.example-model-provider.com" action: ALLOW다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전AGENT_GATEWAY_NAME: Secure Web Proxy 게이트웨이와 연결된agentGateway리소스의 이름
승인 정책을 가져오려면
gcloud network-security authz-policies import명령어를 실행합니다.gcloud network-security authz-policies import authz-policy-skip-interception \ --source=authz-policy-sni.yaml \ --location=LOCATION
예시 3: 확장 프로그램 바인딩을 사용하여 Model Armor로 심층 페이로드 검사 사용 설정
프롬프트 인젝션, 유해한 출력 또는 민감한 정보 유출을 방지하려면 Service Extensions의 확장 프로그램 바인딩을 사용하여 트래픽 처리를 Model Armor 또는 커스텀 ext_proc 프로세서로 오프로드하면 됩니다.
이 모델은 다음과 같은 방식으로 확장 프로그램 제공업체를 소비자와 분리합니다.
- Google 서비스(퍼스트 파티): Model Armor 및 IAP와 같은 기본 제공 Google 서비스의 경우 Google에서 기본 인프라를 관리합니다. 사전 정의된 엔드포인트 URI(
modelarmor.googleapis.com또는iap.googleapis.com)를 사용하여 서비스를 직접 바인딩할 수 있습니다. - 커스텀 및 파트너 확장 프로그램(2P/3P): 커스텀 내부 프로세서 또는 서드 파티 보안 공급업체의 경우 제작자가 Private Service Connect 서비스 연결을 가리키는
ProducerExtension리소스를 게시하고 소비자가 해당 리소스 URI를 바인딩합니다.
agentGateway 리소스에서 승인 정책 및 확장 프로그램이 평가되는 방식에 대한 자세한 내용은 서비스 확장 프로그램으로 승인 위임 및 Agent Gateway의 확장 가능한 정책을 참조하세요.
Model Armor의 확장 프로그램 바인딩을 구성하려면 다음 단계를 따르세요.
Service Extensions API를 사용 설정합니다.
gcloud services enable serviceextensions.googleapis.com
agentGateway리소스를 타겟팅하고, 검사 템플릿을 설정하고, MCP 서버로 향하는 트래픽을 가로채는extension-binding-model-armor.yaml이라는 구성 파일을 만듭니다.name: ext-binding-model-armor target: resources: - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME" failOpen: false producerExtension: modelarmor.googleapis.com producerMetadata: model_armor_settings: '[ { "request_template_id": "projects/TEMPLATE_PROJECT_ID/locations/LOCATION/templates/REQUEST_TEMPLATE_ID", "response_template_id": "projects/TEMPLATE_PROJECT_ID/locations/LOCATION/templates/RESPONSE_TEMPLATE_ID" } ]' matchConditions: - to: destination: resources: - prefix: "urn:mcp"다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전AGENT_GATEWAY_NAME:agentGateway리소스 이름TEMPLATE_PROJECT_ID: Model Armor 템플릿이 생성되는 프로젝트 IDREQUEST_TEMPLATE_ID: 수신 요청을 검사하는 데 사용되는 템플릿의 IDRESPONSE_TEMPLATE_ID: 발신 응답을 검사하는 데 사용되는 템플릿의 ID
참고:
failOpen: false는 확장 프로그램 서비스에 연결할 수 없는 경우 트래픽을 차단합니다. 서비스 중단 중에 트래픽이 검사되지 않은 상태로 통과하도록 허용하려면failOpen: true를 설정합니다.- Model Armor 대신 커스텀 내부 또는 서드 파티 확장 프로그램을 바인딩하려면
producerExtension를projects/PRODUCER_PROJECT_ID/locations/LOCATION/producerExtensions/PRODUCER_EXTENSION_NAME형식의 프로듀서 리소스 경로로 설정합니다.
확장 프로그램 바인딩을 가져오려면
gcloud beta service-extensions extension-bindings import명령어를 실행합니다.gcloud beta service-extensions extension-bindings import ext-binding-model-armor \ --source=extension-binding-model-armor.yaml \ --location=LOCATION
본인 인증을 위해 IAP를 바인딩하는 방법에 대한 자세한 내용은 Agent Gateway에 확장 프로그램 바인딩 연결을 참조하세요.
mTLS ID 기반 승인 정책
Secure Web Proxy는 상호 TLS(mTLS) 인증서에서 파생된 ID를 기반으로 보안 규칙을 시행할 수 있습니다. 이러한 ID를 기반으로 규칙을 시행하는 것은 클라이언트와 프록시 간의 트래픽이 mTLS로 보호되는 제로 트러스트 환경에서 특히 유용합니다. 자세한 내용은 주 구성원 기반 승인 정책을 참조하세요.
다음 예시에서는 swp1이라는 Secure Web Proxy 인스턴스의 승인 정책을 보여줍니다. 이 예시에서는 프록시로의 트래픽이 HTTPS 프로토콜을 사용한다고 가정합니다.
REQUEST_AUTHZ 프로필이 있는 정책은 example.com/mcp로 전송되는 모든 트래픽이 특정 주 구성원의 mTLS 인증을 거쳐야만 통과할 수 있도록 합니다. 또한 이 정책은 example.com/mcp로 전송되지 않는 모든 아웃바운드 트래픽을 거부합니다.
승인 정책 YAML 파일을 만듭니다.
다음 예시에서는
authz-policy.yaml파일을 만듭니다. 이 정책은 클라이언트가 정의된SPIFFE ID주 구성원과 일치하는 인증서를 제시하는 경우에만 지정된 호스트 및 경로로의 트래픽을 허용합니다.$ cat >authz-policy.yaml <<EOF name: test-authz-policy-mtls target: resources: - "projects/ PROJECT_ID /locations/ LOCATION /gateways/swp1" policyProfile: REQUEST_AUTHZ httpRules: - to: operations: - hosts: - exact: "example.com" paths: - exact: "/mcp" from: sources: - principals: - principalSelector: CLIENT_CERT_URI_SAN principal: exact: "spiffe:// PROJECT_ID .global.123.workload.id.goog/ns/ns1/sa/hellomcp" action: ALLOW EOF다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Secure Web Proxy 인스턴스의 리전
gcloud network-security authz-policies import명령어를 사용하여 승인 정책을 만들고 YAML 파일을 가져옵니다.gcloud beta network-security authz-policies import my-authz-policy-allow --source=authz-policy.yaml --location= LOCATIONLOCATION을 Secure Web Proxy 인스턴스의 리전으로 바꿉니다.
서비스 계정 또는 태그 기반의 승인 정책
다양한 Google Cloud 리소스에 연결된 서비스 계정 또는 태그를 기반으로 승인 정책을 적용할 수 있습니다.
이 예시에서는 다음을 완료했다고 가정합니다.
태그를 만들고 Google Cloud 리소스에 키-값 쌍으로 연결했습니다. 태그를 만들 때
--purpose플래그를GCE_FIREWALL로 설정합니다. 승인 정책은GCE_FIREWALL용도로 설정되어 있어야만 태그를 적용할 수 있습니다.
서비스 계정
특정 요청을 허용하는 승인 정책 YAML 파일을 만듭니다.
다음 예시에서는
swp1이라는 Secure Web Proxy 인스턴스의authz-policy.yaml파일을 만듭니다. 이 정책은 서비스 계정my-sa-123@56788.를 사용하는 Compute Engine 가상 머신(VM) 인스턴스의 요청이 example1.com/url1 경로에 도달하도록 허용하도록 구성되어 있습니다.$ cat >authz-policy.yaml <<EOF name: my-authz-policy-allow target: resources: - "projects/PROJECT_ID/locations/ LOCATION /gateways/swp1" policyProfile: REQUEST_AUTHZ httpRules: - from: sources: - resources: - iamServiceAccount: exact: "my-sa-123@56788." to: operations: - hosts: - exact: "example1.com" paths: - prefix: "/url1" action: ALLOW EOF다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Secure Web Proxy 인스턴스의 리전
gcloud network-security authz-policies import명령어를 사용하여 승인 정책을 만들고 YAML 파일을 가져옵니다.다음 명령어 예시는 이전에 만든 정책 파일을 가져와 승인 정책을 만드는 방법을 보여줍니다.
gcloud network-security authz-policies import my-authz-policy-allow --source=authz-policy.yaml --location= LOCATIONLOCATION을 Secure Web Proxy 인스턴스의 리전으로 바꿉니다.
태그
특정 요청을 허용하는 승인 정책 YAML 파일을 만듭니다.
다음 예시에서는
swp1이라는 Secure Web Proxy 인스턴스에 대한authz-policy-tag.yaml파일을 만듭니다. 이 정책은 태그 값이TAG_VALUE_PERMANENT_ID인 Google Cloud리소스에서 시작되는 요청만 example1.com/url1 URL 경로에 액세스하도록 허용합니다.$ cat >authz-policy-tag.yaml <<EOF name: my-authz-policy-tag-allow target: resources: - "projects/PROJECT_ID/locations/ LOCATION /gateways/ GATEWAY_NAME " policyProfile: REQUEST_AUTHZ httpRules: - from: sources: - resources: - tagValueIdSet: ids: ["TAG_VALUE_PERMANENT_ID"] to: operations: - hosts: - exact: "example1.com" paths: - exact: "/url1" action: ALLOW EOF다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 IDLOCATION: Secure Web Proxy 인스턴스의 리전GATEWAY_NAME: Secure Web Proxy 게이트웨이의 이름TAG_VALUE_PERMANENT_ID: 태그 값의 영구 ID(예:tagValues/123456789012)
gcloud network-security authz-policies import명령어를 사용하여 승인 정책을 만들고 YAML 파일을 가져옵니다.다음 명령어 예시는 이전에 만든 정책 파일을 가져와 지정된 Google Cloud 리전에 승인 정책을 만듭니다.
gcloud network-security authz-policies import my-authz-policy-tag-allow --source=authz-policy-tag.yaml --location= LOCATIONLOCATION을 Secure Web Proxy 인스턴스의 리전으로 바꿉니다.
승인 결정을 위임하는 승인 정책
표준 ALLOW 또는 DENY 규칙을 사용하여 표현할 수 없는 복잡한 승인 결정의 경우 CUSTOM 작업으로 승인 정책을 만들 수 있습니다. 그런 다음 승인 결정을 승인 확장 프로그램(서비스 확장 프로그램)에 위임할 수 있습니다.
CUSTOM 작업으로 정책을 구성하면 Secure Web Proxy가 요청 메타데이터 또는 페이로드를 Service Extensions로 오프로드합니다. 서비스 확장 프로그램의 응답에 따라 프록시는 트래픽을 허용하거나 거부합니다.
Secure Web Proxy는 다음과 같은 유형의 위임을 지원합니다.
요청 승인 결정을 Service Extensions에 위임:
CUSTOM작업 및REQUEST_AUTHZ프로필로 구성된 승인 정책을 사용하여 요청 메타데이터 및 헤더를 기반으로 결정을 위임할 수 있습니다. 이 모드에서는 액세스 결정이 승인 확장 프로그램에 위임됩니다. 이 모드를 사용하여 ID와 권한을 확인할 수 있습니다.콘텐츠 승인 결정을 서비스 확장 프로그램에 위임:
CUSTOM작업 및CONTENT_AUTHZ프로필이 있는 승인 정책을 사용하여 요청의 실제 데이터 페이로드를 기반으로 승인 확장 프로그램에 결정을 위임할 수 있습니다. 이 모드를 사용하면 심층 콘텐츠 검사 및 보안 시행을 사용 설정하여 Model Armor와 같은 서비스와 통합하여 민감한 정보나 악성 패턴을 검사할 수 있습니다.
제한사항
Secure Web Proxy에 대한 승인 정책을 구현할 때는 다음 제한사항이 적용됩니다.
대상 및 연결 제약 조건: Secure Web Proxy의 승인 확장 프로그램은 IAP를 직접 대상으로 지원하지 않습니다.
정책 충돌 및 호환성: 기존 보안 규칙이 있는 게이트웨이 보안 정책이 있는 경우 이를 삭제할 필요가 없습니다. 인스턴스에 승인 정책을 적용하면 Secure Web Proxy에서 이러한 규칙을 무시합니다.
프로토콜 및 검사 요구사항: Secure Web Proxy 승인 정책을 구성하려면 TLS 검사를 사용 설정해야 합니다.