X-Forwarded-For (XFF) は、プロキシを介してウェブサーバーに接続するクライアントの発信元IPアドレスを特定するHTTPリクエストヘッダーです。これがないと、サーバーは最後のプロキシのIPしか見ることができません。このヘッダーは設計上クライアントのIPを公開するため、これを追加するプロキシは元のアドレスを宛先サイトに渡します。

各プロキシは、接続を受け取ったIPアドレスを追加します。左端のエントリが主張されたクライアントで、右端が最も最近のプロキシです。例えば X-Forwarded-For: 203.0.113.195, 198.51.100.178。

標準ステータスと関連ヘッダー

  • 事実上の標準: XFFは広く使用されていますが、現在の仕様には定義されていません。
  • Forwardedヘッダー: RFC 7239は同じ情報のための標準 Forwarded ヘッダーを定義していますが、実際にはあまり使用されていません。
  • 関連ヘッダー: X-Forwarded-Host, X-Forwarded-Proto および Via は関連するプロキシの詳細を持っています。
  • ロードバランサー: 一部のロードバランサーは、クライアントIPをXFFに追加したり、変更せずに通過させたり、削除したりすることができます。

信頼と偽造

クライアントは偽造されたX-Forwarded-Forヘッダーを送信できるため、信頼できるプロキシによって追加されたアドレスのみが信頼できます。XFFをレート制限やアクセス制御に使用するサーバーは、右からリストを読み取り、既知の信頼できるプロキシをスキップし、左端の値を信頼できないものとして扱うべきです。サーバーがインターネットから直接到達可能な場合、リストのどの部分も信頼できません。

X-Forwarded-Forの使用目的

プロキシやロードバランサーの背後にあるサーバーは、そのデバイスのIPアドレスのみをログに記録します。XFFを使用することで、デバッグ、統計、および位置依存コンテンツのためにクライアントのアドレスを回復できます。

NGINXにおけるX-Forwarded-Forの読み取り

NGINXのrealipモジュールは、X-Forwarded-Forのようなヘッダーから取得したアドレスでクライアントアドレスを置き換えます。

  • set_real_ip_from: 正しい値を送信することが知られている信頼できるアドレスのリストです。
  • real_ip_header X-Forwarded-For;: NGINXにどのヘッダーを読むべきかを指示します。
  • real_ip_recursive on;: 最後のアドレスが信頼できない場合、そのヘッダー内の最後のアドレスを使用します。

このモジュールはデフォルトでは構築されていません。--with-http_realip_module ビルドオプションが必要です。

関連用語