転送プロキシによって、複数のマシンから外部サーバーにリクエストを送信するための単一の通過ポイントが提供されます。転送プロキシでは、リクエストをビジネスルールに準拠させるために、セキュリティ ポリシーの適用や、リクエストのロギングと分析などの処理を行うことができます。
Apigee ハイブリッドで転送プロキシを使用すると、Kubernetes クラスタからのすべての下り（外向き）トラフィックをインターセプトして管理できます。これには、ターゲット エンドポイントへの API プロキシ リクエストや、ハイブリッド ランタイムがデバッグと分析パイプライン、および MessageLogging などのポリシーと AI ポリシー（SanitizeUserPrompt や SemanticCacheLookup など）のために行う *.googleapis.com との通信が含まれます。
ハイブリッドと TargetEndpoint の間で HTTP 転送プロキシを使用するには、オーバーライド ファイルで送信プロキシ設定を構成する必要があります。これらの環境スコープのプロパティにより、ターゲット リクエストはハイブリッドから HTTP 転送プロキシにルーティングされます。また、HTTP 転送プロキシを経由する TargetEndpoint で use.proxy が true に設定されていることも確認する必要があります。手順については、ページの下部をご覧ください。
転送プロキシ用のハイブリッド環境を構成するには、envs.httpProxy プロパティをオーバーライド ファイルに追加してクラスタに適用します。次に例を示します。
envs:
- name: test
httpProxy:
scheme: HTTP
host: 10.12.0.47
port: 3128
...各 envs.httpProxy 構成プロパティの詳細については、構成プロパティのリファレンスをご覧ください。
フォワード プロキシは 1 つの環境向けに構成されます。つまり、その環境の API プロキシからバックエンド ターゲットに送信されるすべてのトラフィックは、指定された HTTP フォワード プロキシを通過します。API プロキシの特定のターゲットへのトラフィックを、転送プロキシを経由せずに直接バックエンド ターゲットに送信する場合は、TargetEndpoint で次のプロパティを設定して、HTTP 転送プロキシをオーバーライドする必要があります。
<Property name="use.proxy">false</Property>
ターゲット エンドポイントへの接続の構成方法など、TargetEndpoint プロパティの設定の詳細については、Endpoint プロパティのリファレンスをご覧ください。
HTTP 転送プロキシを経由する TargetEndpoint の use.proxy を true に設定します。
<Property name="use.proxy">true</Property>
バックエンドにファイアウォールがあり、ホスト ヘッダーに常にバックエンド サーバーのホスト名が含まれるように構成されているが、Message Processor がプロキシ サーバーのホスト名を送信している場合は、次の手順でこのオプションを構成します。
次の例に示すように、TargetEndpoint でプロパティ use.proxy.host.header.with.target.uri を true に設定します。
TargetEndpoint の構成例:
<TargetEndpoint name="default">
<HTTPTargetConnection>
<URL>https://mocktarget.apigee.net/json</URL>
<Properties>
<Property name="use.proxy.host.header.with.target.uri">true</Property>
</Properties>
</HTTPTargetConnection>
</TargetEndpoint>use.proxy.host.header.with.target.uri プロパティの詳細については、エンドポイント プロパティのリファレンスをご覧ください。
AI ポリシーとフォワード プロキシ
Model Armor ポリシー（SanitizeUserPrompt と SanitizeModelResponse）とセマンティック キャッシュ ポリシー（SemanticCacheLookup と SemanticCachePopulate）は、リクエストとレスポンスの処理中にアウトバウンド呼び出しを行います。これには、Model Armor のサニタイズ呼び出し、Agent Platform のテキスト エンベディング、ベクトル検索の findNeighbors 呼び出しと upsertDatapoints 呼び出しが含まれます。
envs.httpProxy を使用して環境に転送プロキシが構成されている場合、上記の呼び出しはすべてデフォルトで転送プロキシ経由でルーティングされ、ポリシーレベルの構成は必要ありません。この動作は、*.googleapis.com に属していないエンドポイント（SemanticCacheLookup が呼び出すパブリック ベクトル検索エンドポイントなど）にも当てはまります。
外部サービスへのこれらのポリシー呼び出しは、ランタイムのトレースと分析トラフィックと同じように扱われます。envs[].managementCallsSkipProxy を true に設定すると、転送プロキシをスキップして直接下り（外向き）します。転送プロキシのスキップは、上記のすべての呼び出し（サニタイズ、テキスト エンベディング、findNeighbors、upsertDatapoints）に適用されます。このプロキシレベルの転送プロキシの動作は、TargetEndpoint とは異なります。TargetEndpoint の転送プロキシの動作は、独自の use.proxy プロパティによって制御されます。