このページでは、Google Kubernetes Engine(GKE)アンビエント ネットワーキングで実行されているワークロードから Secure Web Proxy(SWP)ゲートウェイへの下り(外向き)ルーティングを構成する方法について説明します。
Secure Web Proxy ゲートウェイを介してアウトバウンド トラフィックをルーティングすることで、アプリケーション コードを変更することなく、URL フィルタリング、ドメイン許可リスト、TLS インスペクションなどの一元化された下り(外向き)セキュリティ ポリシーを適用できます。レイヤ 4 ノードプロキシは、アプリケーション Pod の外部でアウトバウンド トラフィックをインターセプトし、ワークロード コンテナが侵害された場合でも Pod 外のセキュリティ分離を提供します。
アーキテクチャとトラフィック フロー
このデプロイモデルでは、GKE クラスタ、Secure Web Proxy インスタンス、Private Service Connect(PSC)エンドポイント(クロス VPC デプロイの場合)など、インフラストラクチャの所有権を維持します。
下り(外向き)トラフィック フローは次のように動作します。
- ワークロード Pod が、外部エンドポイントまたはインターネット宛先へのアウトバウンド トラフィックを開始します。
- ローカルのレイヤ 4 アンビエント ノード プロキシが、ノードのアウトバウンド リクエストをインターセプトします。
- ノードプロキシは、下り(外向き)ゲートウェイへの HTTP CONNECT トンネルを確立します。
- Secure Web Proxy が同じ VPC ネットワーク内にある場合、トラフィックはゲートウェイに直接接続されます。Secure Web Proxy が別の VPC ネットワークにある場合、トラフィックは PSC サービス アタッチメントを通過します。
- Secure Web Proxy はトンネルを終了し、構成された下り(外向き)セキュリティ ポリシーを適用して、承認されたリクエストを宛先に転送します。
制限事項
Secure Web Proxy の下り(外向き)ルーティングを設定する前に、プレビュー版の次の制限事項を確認してください。
- Namespace 全体のポリシー: 下り(外向き)ルーティング ポリシーは、Namespace レベルでのみ適用されます。ラベルセレクタを使用した Pod の詳細な選択はサポートされていません。
- ホスト名フィルタリングには TLS インスペクションが必要: Secure Web Proxy ポリシーでは、TLS インスペクションが有効になっていない限り、IP アドレスによる下り(外向き)トラフィックのフィルタリングのみが可能です。
- Workload Identity: GKE アンビエント ネットワーキングは、標準の Workload Identity をサポートしています。このプレビューでは、マネージド エージェント ID プールはサポートされていません。
- 認証: アンビエント ノード プロキシと Secure Web Proxy 間の接続では、サーバー証明書の検証がスキップされます。CONNECT リクエストには、クライアント証明書とともに無制限のトークンが含まれています。
- 構成の更新時にリソースを再作成する: 既存の Secure Web Proxy インスタンスまたは PSC 構成に加えた変更は、自動的に反映されません。Secure Web Proxy または PSC の構成を更新する場合は、
GCPEgressPolicyリソースと Secure Web Proxy インスタンスを削除して再作成し、変更を適用する必要があります。 - TLS 検査のトラスト アンカー: GKE は、Secure Web Proxy のプライベート CA 証明書をワークロード コンテナに自動的に挿入しません。TLS 検査を使用する場合は、信頼証明書をコンテナ イメージに手動でインストールする必要があります。
前提条件
下り(外向き)ルーティングを構成する前に、次のものがあることを確認してください。
- アンビエント ネットワーキングが有効になっている GKE クラスタ。手順については、GKE アンビエント ネットワーキングを準備するをご覧ください。
- Google Cloud プロジェクトまたは共有 VPC で
clientValidationMode: ALLOW_INVALID_OR_MISSING_CLIENT_CERTを使用して構成されたserverTlsPolicyを持つ、デプロイされた Secure Web Proxy インスタンス。 - Secure Web Proxy が GKE クラスタとは異なる VPC ネットワークにある場合:
- Secure Web Proxy 用に作成された PSC サービス アタッチメント。
- GKE クラスタの VPC ネットワークで構成された PSC コンシューマー エンドポイント。
これらの手順を完了するには、次のロールが必要です。
- Secure Web Proxy / ネットワーク サービス:
networkservices.gateways.*(またはroles/networkservices.admin)。Secure Web Proxy ゲートウェイ リソースを構成します。 - PSC 管理(クロス VPC デプロイのみ): Private Service Connect 接続を管理するための
compute.networkAttachments.list(またはroles/compute.networkAdmin)。 - GKE 管理: カスタム リソース(
GCPBackend、GCPEgressPolicy)をデプロイするためのroles/container.clusterAdmin。
TLS インスペクションの信頼を構成する
Secure Web Proxy ポリシーで TLS インスペクションを使用して暗号化されたアウトバウンド トラフィックを検査する場合、プロキシはプライベート認証局(CA)によって署名された証明書を生成して、外部の宛先を偽装します。
ワークロード アプリケーションは、Secure Web Proxy によって提示されたプライベート CA 証明書を信頼する必要があります。GKE はこの証明書を自動的に挿入しないため、SWP CA 証明書(トラスト アンカー)をコンテナのトラストストアにインストールする必要があります。
CA 証明書をコンテナ イメージに追加するには、Dockerfile に次の行を追加します。
COPY swp-ca-cert.pem /usr/local/share/ca-certificates/swp-ca-cert.crt
RUN update-ca-certificates
ゲートウェイ エンドポイントを定義する
アンビエント Egress ルーティングを構成する最初のステップは、ゲートウェイ エンドポイントを作成することです。これにより、GKE クラスタ内に Secure Web Proxy エンドポイントが定義され、プロキシの場所がアンビエント ネットワーキングに通知されます。
Secure Web Proxy または Private Service Connect(PSC)サービス アタッチメントの URI を指定するには、GKE クラスタに GCPBackend カスタム リソースを作成します。
同じ VPC
次のマニフェストを
swp-backend.yamlとして保存します。apiVersion: networking.gke.io/v1 kind: GCPBackend metadata: name: swp-backend namespace: ambient-test spec: serviceUris: - //networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/gateways/SWP_NAME次のように置き換えます。
ambient-test: アンビエント ネットワーキングに登録されている Namespace。PROJECT_ID: 実際の Google Cloud プロジェクト ID。REGION: Secure Web Proxy がデプロイされているリージョン。SWP_NAME: Secure Web Proxy の名前。
GCPBackendリソースを適用します。kubectl apply -f swp-backend.yaml
VPC 間
次のマニフェストを
swp-backend.yamlとして保存します。apiVersion: networking.gke.io/v1 kind: GCPBackend metadata: name: swp-backend namespace: ambient-test spec: serviceUris: - //compute.googleapis.com/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME次のように置き換えます。
ambient-test: アンビエント ネットワーキングに登録されている Namespace。PROJECT_ID: 実際の Google Cloud プロジェクト ID。REGION: PSC サービス アタッチメントがデプロイされているリージョン。ATTACHMENT_NAME: Secure Web Proxy が別の VPC ネットワークにある場合は、PSC サービス アタッチメントの名前。
GCPBackendリソースを適用します。kubectl apply -f swp-backend.yaml
下り(外向き)トラフィックのリダイレクトを構成する
GCPEgressPolicy カスタム リソースを作成して、名前空間から Secure Web Proxy ゲートウェイにアウトバウンド トラフィックをルーティングします。これにより、アンビエント ノード プロキシが Secure Web Proxy への HTTP CONNECT トンネルを確立するために必要なシグナリングが提供されます。これは、下り(外向き)ルーティングに必要です。
次のマニフェストを
swp-egress-policy.yamlとして保存します。apiVersion: networking.gke.io/v1 kind: GCPEgressPolicy metadata: name: swp-egress-policy namespace: ambient-test spec: to: excludeCIDRRanges: - "CLUSTER_CONTROL_PLANE_CIDR" proxyRef: group: networking.gke.io kind: GCPBackend name: swp-backend次のように置き換えます。
ambient-test: アンビエント ネットワーキングに登録されている Namespace。CLUSTER_CONTROL_PLANE_CIDR: Secure Web Proxy をバイパスする必要がある内部通信の CIDR の範囲(GKE コントロール プレーンのアドレス範囲や内部 VPC サブネットなど)。
GCPEgressPolicyリソースを適用します。kubectl apply -f swp-egress-policy.yamlポリシーが適用されると、名前空間内のワークロードからのアウトバウンド トラフィックが Secure Web Proxy にリダイレクトされます。
トラブルシューティング
アンビエント下り(外向き)ルーティングの問題を診断して解決するには、次のガイダンスを使用します。
- トラフィックが Secure Web Proxy に到達しない:
- 同じ VPC のデプロイの場合は、
GCPBackendリソースが正しい Secure Web Proxy ゲートウェイ URI を指していることを確認します。 - クロス VPC デプロイの場合:
GCPBackendリソースが正しい PSC サービス アタッチメント URI を参照していることを確認します。- プロデューサー VPC で PSC エンドポイントが確立され、承認されていることを確認します。
GCPEgressPolicyのexcludeCIDRRangesが宛先トラフィックと誤って一致していないことを確認します。
- 同じ VPC のデプロイの場合は、
- mTLS 接続エラー:
- Secure Web Proxy がノードプロキシからの接続を受け入れるように構成されていることを確認します。
- TLS インスペクション証明書のエラー:
- クライアント リクエストが証明書の検証エラー(
x509: certificate signed by unknown authorityなど)で失敗した場合は、Secure Web Proxy CA 証明書がワークロード コンテナのシステム証明書ストアに正しくインストールされていることを確認します。
- クライアント リクエストが証明書の検証エラー(
エージェントの下り(外向き)ガバナンス
自律型 AI エージェントをデプロイすると、外部 SaaS API、リモート Model Context Protocol(MCP)サーバー、サードパーティのエージェント エコシステムに動的に接続されます。標準のファイアウォール ルールでは、IP アドレスだけでなく、エージェントの ID とペイロードのセマンティック コンテンツに基づいてポリシーを適用する必要があるため、このトラフィックを適切に保護できません。
GKE クラスタでアンビエント ネットワーキングを使用している場合は、このアウトバウンド エージェント トラフィックを Secure Web Proxy(SWP)にシームレスにリダイレクトして、レイヤ 7 の検査とポリシーの適用を行うことができます。
エージェントの下り(外向き)リダイレクトの仕組み
エージェントからのアウトバウンド トラフィックを管理するには、エージェント リクエストをインターセプトして Secure Web Proxy に転送するように GKE アンビエント プロキシを構成します。
- トラフィックのリダイレクト:
GCPEgressPolicyカスタム リソースを適用して、プロキシに転送するトラフィックを定義します。excludeCIDRRangesフィールドを使用すると、Kubernetes コントロール プレーンとの通信などの内部トラフィックで SWP をバイパスできます。 - 認可とコンテンツ セキュリティ: Secure Web Proxy は、ポリシー適用ポイント(PEP)として機能します。Identity-Aware Proxy(IAP)を使用して、呼び出し元エージェントの ID に基づいてトラフィックを認可するリクエストを評価します。
Service Extension Bindingを接続して、トラフィックがネットワーク境界から出る前に Google CloudModel Armor で送信ペイロードをスクリーニングすることもできます。
次のステップ
- Secure Web Proxy をプロビジョニングし、エージェントのアンビエント リダイレクトを構成するには、GKE でエージェントの下り(外向き)ガバナンスを設定するをご覧ください。