Secure Web Proxy의 승인 정책 설정

이 페이지에서는 Secure Web Proxy의 승인 정책을 구성하는 방법을 설명합니다.

시작하기 전에

승인 정책 만들기

두 가지 사용 사례에 대해 승인 정책을 구성할 수 있습니다.

  • 에이전트 트래픽 제어: AI 에이전트에서 모델 컨텍스트 프로토콜(MCP) 서버, 도구, 모델로의 아웃바운드 트래픽을 보호하려면 에이전트 대상에 대한 승인 정책 구성을 참조하세요. agentGateway 리소스에서 정책 및 확장 프로그램 바인딩을 구성하여 MCP 도구 제한, mTLS 에이전트 ID, 페이로드 정제를 시행할 수 있습니다.

  • 비에이전트형 웹 트래픽 보호: 비에이전트형 엔터프라이즈 워크로드에서 아웃바운드 웹 트래픽을 보호하려면 다음 섹션의 예시를 참조하세요. 보안 웹 프록시 Gateway 리소스에서 직접 정책을 구성하여 mTLS 클라이언트 인증서 ID, 서비스 계정, 보안 태그 또는 커스텀 승인 확장 프로그램을 적용할 수 있습니다.

Secure Web Proxy의 승인 정책을 만들려면 다음을 수행합니다.

에이전트형 대상에 대한 승인 정책 구성

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 에이전트 트래픽을 처리할 때 규칙은 다음 순서로 평가됩니다.

  1. 네트워크(L4) 승인 규칙: 먼저 평가됩니다. 외부 모델 엔드포인트에 대한 직접 통신을 허용하는 등 SNI 일치 규칙이 적용되면 트래픽이 TLS 가로채기를 우회합니다.

  2. TLS 가로채기: 우회되지 않은 트래픽은 게이트웨이의 TLS 검사 정책을 사용하여 가로채고 복호화됩니다.

  3. 확장 프로그램 바인딩 규칙: 요청은 구성된 확장 프로그램 서비스에 의해 평가됩니다. 예를 들어 IAP는 요청 헤더에서 호출자 ID를 확인하고 Model Armor는 복호화된 페이로드를 검사하여 프롬프트 안전성을 확인하고 응답에서 데이터 유출을 방지합니다.

  4. HTTP(L7) 승인 규칙: MCP 도구 제한 및 메서드 필터링과 같은 HTTP 수준 승인 정책이 평가됩니다.

예시 1: MCP 도구 실행 제한

다음 예시에서는 에이전트가 도구를 검색하고(tools/list) 승인된 도구만 실행할 수 있도록 허용하는(get_weather 및 get_location에 대한 tools/call) agentGateway 리소스에 연결된 승인 정책을 보여줍니다.

  1. 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 프로젝트 ID
    • LOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전
    • AGENT_GATEWAY_NAME: Secure Web Proxy 게이트웨이와 연결된 agentGateway 리소스의 이름
  2. 승인 정책을 가져오려면 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)를 일치시키고 세션을 복호화하지 않고 연결을 허용할 수 있습니다.

  1. 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 프로젝트 ID
    • LOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전
    • AGENT_GATEWAY_NAME: Secure Web Proxy 게이트웨이와 연결된 agentGateway 리소스의 이름
  2. 승인 정책을 가져오려면 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의 확장 프로그램 바인딩을 구성하려면 다음 단계를 따르세요.

  1. Service Extensions API를 사용 설정합니다.

    gcloud services enable serviceextensions.googleapis.com
    
  2. 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 프로젝트 ID
    • LOCATION: Agent Gateway 및 Secure Web Proxy 인스턴스가 배포된 리전
    • AGENT_GATEWAY_NAME: agentGateway 리소스 이름
    • TEMPLATE_PROJECT_ID: Model Armor 템플릿이 생성되는 프로젝트 ID
    • REQUEST_TEMPLATE_ID: 수신 요청을 검사하는 데 사용되는 템플릿의 ID
    • RESPONSE_TEMPLATE_ID: 발신 응답을 검사하는 데 사용되는 템플릿의 ID

    참고:

    • failOpen: false는 확장 프로그램 서비스에 연결할 수 없는 경우 트래픽을 차단합니다. 서비스 중단 중에 트래픽이 검사되지 않은 상태로 통과하도록 허용하려면 failOpen: true를 설정합니다.
    • Model Armor 대신 커스텀 내부 또는 서드 파티 확장 프로그램을 바인딩하려면 producerExtension를 projects/PRODUCER_PROJECT_ID/locations/LOCATION/producerExtensions/PRODUCER_EXTENSION_NAME 형식의 프로듀서 리소스 경로로 설정합니다.
  3. 확장 프로그램 바인딩을 가져오려면 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로 전송되지 않는 모든 아웃바운드 트래픽을 거부합니다.

  1. 승인 정책 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 프로젝트 ID
    • LOCATION: Secure Web Proxy 인스턴스의 리전
  2. gcloud network-security authz-policies import 명령어를 사용하여 승인 정책을 만들고 YAML 파일을 가져옵니다.

    gcloud beta network-security authz-policies import my-authz-policy-allow
        --source=authz-policy.yaml
        --location= LOCATION 
    

    LOCATION을 Secure Web Proxy 인스턴스의 리전으로 바꿉니다.

서비스 계정 또는 태그 기반의 승인 정책

다양한 Google Cloud 리소스에 연결된 서비스 계정 또는 태그를 기반으로 승인 정책을 적용할 수 있습니다.

이 예시에서는 다음을 완료했다고 가정합니다.

서비스 계정

  1. 특정 요청을 허용하는 승인 정책 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 프로젝트 ID
    • LOCATION: Secure Web Proxy 인스턴스의 리전
  2. gcloud network-security authz-policies import 명령어를 사용하여 승인 정책을 만들고 YAML 파일을 가져옵니다.

    다음 명령어 예시는 이전에 만든 정책 파일을 가져와 승인 정책을 만드는 방법을 보여줍니다.

    gcloud network-security authz-policies import my-authz-policy-allow
    
        --source=authz-policy.yaml
        --location= LOCATION 
    

    LOCATION을 Secure Web Proxy 인스턴스의 리전으로 바꿉니다.

태그

  1. 특정 요청을 허용하는 승인 정책 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 프로젝트 ID
    • LOCATION: Secure Web Proxy 인스턴스의 리전
    • GATEWAY_NAME: Secure Web Proxy 게이트웨이의 이름
    • TAG_VALUE_PERMANENT_ID: 태그 값의 영구 ID(예: tagValues/123456789012)
  2. 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= LOCATION 
    

    LOCATION을 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 검사를 사용 설정해야 합니다.

다음 단계