このページでは、Secure Web Proxy の認可ポリシーを構成する方法について説明します。
始める前に
Secure Web Proxy の概要と認可ポリシーの概要のページを確認します。
-
- ネットワーク セキュリティ API
- Network Services API
- Certificate Manager API
適切なロールと権限があることを確認します。
アクティブな Secure Web Proxy インスタンスがデプロイされ、
GatewaySecurityPolicyに関連付けられている必要があります。詳細については、Secure Web Proxy インスタンスをデプロイするをご覧ください。Secure Web Proxy 認可ポリシーを構成するには、TLS 検査ポリシーを有効にする必要があります。
認可ポリシーを作成する
認可ポリシーは、次の 2 つの異なるユースケースに合わせて構成できます。
エージェント トラフィックを管理する: AI エージェントから Model Context Protocol(MCP)サーバー、ツール、モデルへのアウトバウンド トラフィックを保護するには、エージェントの宛先の認可ポリシーを構成するをご覧ください。
agentGatewayリソースでポリシーと拡張機能バインディングを構成して、MCP ツールの制限、mTLS エージェント ID、ペイロードのサニタイズを適用できます。エージェント型以外のウェブ トラフィックを保護する: エージェント型以外のエンタープライズ ワークロードからのアウトバウンド ウェブ トラフィックを保護するには、以降のセクションの例をご覧ください。Secure Web Proxy
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リソースを使用して、エージェント ID の本人確認用の Identity-Aware Proxy(IAP)や、プロンプトとレスポンスのサニタイズ用の 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 が証明書のピン留めを使用している場合、またはペイロード検査を必要としない場合は、ネットワーク ルールを使用して Server Name Indication(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 サービス(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 の拡張機能バインディングを構成する手順は次のとおりです。
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 リソースに接続されているサービス アカウントまたはタグに基づく認可ポリシーを適用できます。
この例では、次のことが完了していることを前提としています。
タグを作成し、Key-Value ペアとして 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 アクションを含む認可ポリシーを作成できます。その後、認可の判断を認可拡張機能(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 検査を有効にする必要があります。