リバースプロキシが正しいクライアントIPを送信しているか確認する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

既知の外部接続元とすべてのプロキシヘッダー、およびバックエンドで最終的に解析されたアドレスを比較して、クライアントIPの転送を確認する。

リバースプロキシはクライアントとの接続を終端するため、プロキシが信頼できるリクエストメタデータを渡さない限り、通常、バックエンドに見えるのはプロキシのソケットアドレスです。テストでは、直接の接続元アドレスとForwarded、X-Forwarded-For、X-Real-IPを区別し、信頼するすべてのホップを文書化したうえで、インターネット上のクライアントがログ、レート制限、アクセス制御に使われる値を偽装できないことを証明する必要があります。

自宅の外部から既知のクライアントIPでテストする

モバイルデータ通信または別の外部ネットワークにつないだ端末を使い、リクエストを送る直前に、その端末のパブリックIPv4またはIPv6アドレスを記録します。一意のパス、クエリ値、またはタイムスタンプを付けて、パブリックリバースプロキシ経由でリクエストを送信します。

MDNは、X-Forwarded-Forを、プロキシ接続を経由して元のクライアントアドレスを保持するために広く使われるヘッダーと説明しています。

そのリクエストについて、エッジプロキシ、中間プロキシがあればそのログ、バックエンドアプリケーションのログを収集します。既知の接続元と照合できるタイムスタンプがなければ、複数のユーザーが同時にアクセスした際、ヘッダーの連鎖を特定できないことがあります。

ソケット接続元とすべての転送ヘッダーを記録する

バックエンドでは、直接のTCP接続元アドレスをForwarded、X-Forwarded-For、X-Real-IP、およびCDN固有のクライアントヘッダーとは別に記録します。最初のテストでは、生の値を上書きしないでください。

「実際の」クライアントIPの扱いに関する実用的な分析では、正確性はプロキシによるヘッダーの設定や追加の方法、さらに前段の値が偽装可能かどうかに左右されるとされています。プロキシの信頼モデル全体を実際のネットワーク構成に合わせる必要があります。

バックエンドのソケット接続元は直前の信頼できるプロキシと一致し、選択されたクライアントアドレスは外部テスト端末と一致する必要があります。バックエンドのログにプロキシのアドレスしか記録されない場合、ヘッダーの生成または解析が行われていません。

各プロキシがヘッダーを追加または置換する方法を確認する

CDNやトンネルからエッジプロキシ、内部プロキシ、アプリケーションまで、すべてのホップを調べます。各ホップが既存のリストに追加するのか、信頼できない入力を置き換えるのか、ヘッダーを変更せずに渡すのかを記録します。

Sling Academyによると、NGINXは直接接続元からX-Real-IPを設定し、proxy_add_x_forwarded_forを使って転送元のチェーンに追加できます。

最初の信頼されたエッジでクライアントが送信した転送ヘッダーを削除または置き換え、その後、管理された内部ホップでアドレスを追記するよう設定してください。信頼するプロキシの数を定義せずに、左端または右端の値をそのまま受け入れないでください。

既知のプロキシアドレスのみを信頼するようバックエンドを設定する

アプリケーションまたはウェブサーバーの信頼するプロキシリストに、正確なリバースプロキシのアドレスまたは管理されたサブネットを設定してください。通常の LAN またはインターネット上のクライアントからの直接接続が、信頼されたヘッダー送信元として扱われないことを確認してください。

Ip2Geo の解説によると、アプリケーションへの接続元はロードバランサーまたはリバースプロキシです。元の IP を安全に解析するには、任意の入力を受け入れるのではなく、信頼ホップのルールが必要です。

コンテナ、オーバーレイネットワーク、または CDN によりプロキシのアドレスが変わる場合は、サポート対象の範囲を文書化し、意図的に更新してください。現在プロキシがプライベートアドレスを使っているという理由だけで、すべてのプライベートアドレスを信頼しないでください。

偽装ヘッダーのテストを実行する

外部テスト端末から、実際のプロキシ経由で接続しながら、偽装した X-Forwarded-For または Forwarded の値を送信してください。受信した生のヘッダー、正規化されたプロキシヘッダー、バックエンドが選択したクライアントアドレスを比較します。

正しい動作では、信頼されたエッジが信頼されていない入力を置き換えるか安全に追記し、バックエンドが文書化された信頼ホップ数に基づいてアドレスを選択します。偽装されたアドレスが認証や許可リストで使用される値になってはなりません。

そのポートに到達できる場合は、LAN セグメントからバックエンドへ直接接続するテストも繰り返してください。バックエンドは、信頼されていない直接接続クライアントからの転送ヘッダーを無視し、実際のソケットピアを記録する必要があります。

IPv4、IPv6、複数プロキシ経路を検証する

IPv4 と IPv6、通常の公開ホスト名、そして本番環境で使用している CDN、トンネル、またはセカンダリプロキシ経由でテストを繰り返してください。ログに正しいアドレス形式が保持され、チェーンが途中で切り捨てられないことを確認してください。

ZimaSpace のリバースプロキシにおけるリクエストの識別情報ガイドでは、正しい転送値がログ記録以外にも重要である理由について、背景を説明しています。

既知の送信元と解析されたクライアント IP が一致し、信頼するプロキシが生のチェーン内に保持され、なりすましの試みが失敗し、セキュリティ制御が正規化された値を一貫して使用している場合にのみ、プロキシは検証済みとなります。CDN、トンネル、または別のプロキシホップを追加した後は、再確認してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.