プロキシを使用するための ロギング・エージェント の設定

ロギング・エージェント、 IBM Cloud® Identity and Access Management (IAM)または IBM Cloud Logs インスタンス間の仲介としてプロキシを使用できます。

ファイアウォールが外部のサービス・エンドポイントへのすべての非エンタイトル接続をブロックしているような、ネットワーク・アウトバウンド・トラフィックに対して厳格な接続制御を実施している環境に ロギング・エージェント をインストールする必要がある場合、 ロギング・エージェント トラフィックをプロキシ経由で再指向することができます。

プロキシは、ファイアウォールやフィルタのように機能し、アウトバウンドトラフィックを制御することができます。

例えば、内部IPアドレスを外部に隠すことができる。 このセットアップでは、 ロギング・エージェント から送られたリクエストはプロキシを経由してルーティングされ、ブロックされ たり、元の宛先に転送(forward)されたりする。

プロキシの設定とセキュリティ確保は通常、ネットワーク管理者の責任である。

プロキシを使用するように ロギング・エージェント を設定することは可能である。

使用するプロキシの URL は、環境変数 HTTP_PROXY、 HTTPS_PROXY 、 NO_PROXY （または小文字バージョン）をエクスポートすることで設定できる。 変数を host[:port] に設定する場合は、完全な URL を含むか、http スキームが想定されます。

有効な環境変数の例は以下の通りである： HTTPS_PROXY="https://example.proxy:443" HTTP_PROXY="192.168.1.1:8080"、 HTTP_PROXY="localhost"。

例えば、環境変数 HTTPS_PROXY="https://example.proxy:443" をエクスポートすると、 ロギング・エージェント からのすべての HTTPS リクエストは、 https://example.proxy:443 でリッスンしているプロキシを経由してルーティングされる。 これらのリクエストには、 IBM Cloud® Identity and Access Management (IAM) への呼び出しによる認証トークンの取得や、 IBM Cloud Logs インスタンスへのログ送信リクエストが含まれる。

この例をさらに詳しく見ると、 ロギング・エージェント、IAMに対して認可トークンを取得するリクエストを作成し、それを送信する。 環境変数 HTTPS_PROXY を設定することで、この呼び出しはそのアドレスでリッスンしているプロキシに転送される。 このプロキシは次に、リクエストを送信できるか、ブロックすべきか を決定することができる。

最初のケースでは、元のアドレス（IAM）に転送されますが、2番目のケースでは、ログを送信するためにトークンが必要であるため、エージェントはエラーを表示します。

特定のリクエストをプロキシ経由にしたくない場合は、環境変数 NO_PROXY で URL をエクスポートすることで設定できます。

複数のURLをカンマ区切りでエクスポートできます。