Secure Web Proxy の認可ポリシーを設定する

このページでは、Secure Web Proxy の認可ポリシーを構成する方法について説明します。

始める前に

認可ポリシーを作成する

認可ポリシーは、次の 2 つの異なるユースケースに合わせて構成できます。

  • エージェント トラフィックを管理する: AI エージェントから Model Context Protocol(MCP)サーバー、ツール、モデルへのアウトバウンド トラフィックを保護するには、エージェントの宛先の認可ポリシーを構成するをご覧ください。agentGateway リソースでポリシーと拡張機能バインディングを構成して、MCP ツールの制限、mTLS エージェント ID、ペイロードのサニタイズを適用できます。

  • エージェント型以外のウェブ トラフィックを保護する: エージェント型以外のエンタープライズ ワークロードからのアウトバウンド ウェブ トラフィックを保護するには、以降のセクションの例をご覧ください。Secure Web Proxy Gateway リソースでポリシーを直接構成して、mTLS クライアント証明書 ID、サービス アカウント、セキュアタグ、カスタム認可拡張機能を適用できます。

Secure Web Proxy の認可ポリシーを作成する手順は次のとおりです。

エージェントの宛先の認可ポリシーを構成する

Secure Web Proxy を Agent Gateway としてデプロイすると、認可ポリシーを定義して、MCP ツールサーバーと AI エージェントの宛先に送信されるトラフィックを検査して制限できます。

次のリクエスト レイヤでアクセス制御を適用するルールを構成できます。

  • ネットワーク ルール: 特定の信頼できる外部モデルまたは Agent Endpoint に対して、TLS インスペクションまたはディープ ペイロード分析をスキップします。

  • 拡張機能バインディング: Service Extensions の ExtensionBinding リソースを使用して、エージェント ID の本人確認用の Identity-Aware Proxy(IAP)や、プロンプトとレスポンスのサニタイズ用の 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 が証明書のピン留めを使用している場合、またはペイロード検査を必要としない場合は、ネットワーク ルールを使用して Server Name Indication(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 サービス(1P): Model Armor や IAP などの組み込みの Google サービスの場合、Google が基盤となるインフラストラクチャを管理します。事前定義されたエンドポイント URI(modelarmor.googleapis.com または iap.googleapis.com)を使用して、サービスを直接バインドできます。
  • カスタム拡張機能とパートナー拡張機能(2P/3P): カスタム内部プロセッサまたはサードパーティのセキュリティ ベンダーの場合、プロデューサーは Private Service Connect サービス アタッチメントを指す ProducerExtension リソースを公開し、コンシューマーはそのリソース URI をバインドします。

agentGateway リソースで認可ポリシーと拡張機能が評価される方法については、Service Extensions を使用して認可を委任すると 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 アクションを含む認可ポリシーを作成できます。その後、認可の判断を認可拡張機能(Service Extensions)に委任できます。

CUSTOM アクションを使用してポリシーを構成すると、Secure Web Proxy はリクエスト メタデータまたはペイロードを Service Extensions にオフロードします。Service Extensions からのレスポンスに応じて、プロキシはトラフィックを許可または拒否します。

Secure Web Proxy は、次のタイプの委任をサポートしています。

  • リクエスト認可の決定をサービス拡張機能に委任する: CUSTOM アクションと REQUEST_AUTHZ プロファイルで構成された認可ポリシーを使用して、リクエスト メタデータとヘッダーに基づいて決定を委任できます。このモードでは、アクセスに関する決定が認可拡張機能に委任されます。このモードを使用して、ID と権限を確認できます。

  • コンテンツ認可の決定を Service Extensions に委任する: CUSTOM アクションと CONTENT_AUTHZ プロファイルを含む認可ポリシーを使用して、リクエストの実際のデータ ペイロードに基づいて認可拡張機能に決定を委任できます。このモードでは、コンテンツの詳細な検査とセキュリティの適用を有効にできます。Model Armor などのサービスと統合することで、機密情報や悪意のあるパターンをスキャンできます。

制限事項

Secure Web Proxy の認可ポリシーを実装する場合は、次の制限が適用されます。

  • ターゲットと接続の制約: Secure Web Proxy の認可拡張機能は、直接ターゲットとして IAP をサポートしていません。

  • ポリシーの競合と互換性: 既存のセキュリティ ルールを含むゲートウェイ セキュリティ ポリシーがある場合、それらを削除する必要はありません。インスタンスに認可ポリシーを適用すると、Secure Web Proxy はこれらのルールを無視します。

  • プロトコルと検査の要件: Secure Web Proxy 認可ポリシーを構成するには、TLS 検査を有効にする必要があります。

次のステップ