X-Forwarded-For

X-Forwarded-For (XFF) とは、HTTPヘッダフィールドの一つ。HTTPプロキシサーバまたは負荷分散装置（ロードバランサ）を経由してウェブサーバに接続するクライアントの送信元IPアドレスを特定する際のデファクトスタンダードである。このヘッダはSquidキャッシング・プロキシサーバの開発者により初めて導入された。のちに、IETFのネットワーク作業部会 (Network Working Group) が同種のHTTPヘッダForwardedを で提唱している。

ここでのキャッシングサーバとは、概ね、大規模なISPの利用者がWWWへ接続する際にISPが利用を推奨または強制的に利用させるプロキシサーバのことを指し、データのキャッシングにより外部へのネットワーク帯域幅を減らす働きを持つ。いくつかの場合、これらプロキシサーバは透過的プロキシであり、利用者は利用していることに気付かないかもしれない。

XFFや別の類似の技術を利用しなければ、プロキシ経由の接続はすべてプロキシサーバの送信元IPアドレスのみを示すことになり、送信元IPアドレスが利用できなくなる。そのため、悪意あるアクセスを検知したり防ぐことはかなり困難になり、プロキシサーバをに変えてしまう。XFFの利用は送信元ホストのIPアドレスを正直に報告するプロキシサーバの存在を仮定している。そのため、XFFを効果的に利用するためには、どのプロキシサーバが信頼できるかの情報が必須となる。例えば、信頼できる人物が管理するサーバが一覧化されているホワイトリストに当該プロキシサーバが載っているかを検索するなどして情報を得る必要がある。

フォーマット

このフィールドの一般的なフォーマットは次の通りである。

ここで、値（変数）はコンマとスペースで分けられたIPアドレスの一覧である。コロンとスペースの次に来る、最も左のカラムにある値は最下流に位置するクライアントのIPアドレス、続いて接続要求を伝送する、おのおの連続したプロキシが、接続要求の送信元IPアドレスを追加していく。この例では、接続要求はproxy1、proxy2を通過し、最後に接続要求側のリモート・アドレスとして現れるproxy3に伝わる。

X-Forwarded-Forフィールドをでっち上げるのは簡単なのでXFFを偽装するMozilla Firefox用拡張機能が存在する。、与えられた情報は慎重に取り扱うべきである。最終IPアドレスは常に最後のプロキシに接続するIPアドレスであるが、すなわちこの情報ソースが最も信頼できることを意味する。

フォワードプロキシまたはリバースプロキシを利用するシナリオにおいてはX-Forwarded-Forデータが利用可能である。

クライアントがフォワードプロキシを利用するシナリオの場合、接続先ネットワークの管理者は、クライアント側内部のネットワークのプロキシ接続の連鎖を経由して、接続するクライアントの実体IPアドレスを追跡することが可能で、ゲートウェイ機器上でのそのIPアドレスが記録される。セキュリティ的理由で、インターネットへ接続要求を送信する前に、管理下にあるゲートウェイ機器は任意のX-Forwarded-Forを削るべきである。またX-Forwarded-Forの情報が管理下にあるネットワーク内部で全て生成される場合は、このシナリオにおいては、X-Forwarded-Forの情報を信頼できるようにすべきである。

管理下のネットワークがリバースプロキシを利用するシナリオの場合、たとえ管理下のウェブサーバがインターネットからの経路情報を持たない場合でも、- 例えばウェブサーバがOSI参照モデル第7層に位置するプロキシ機器の背後に隠れている場合でも、ウェブサーバ管理者はウェブサーバにインターネット接続するクライアントの実体IPアドレスを追跡できる。またインターネット上から欺瞞情報を受信する可能性がある場合は、このシナリオにおいては、全てのX-Forwarded-Forの情報は信頼すべきではない。X-Forwarded-Forフィールドに通知されているプロキシIPアドレスが信頼できるものか確かめるため、斯様な信頼できるIPアドレスのリストを利用するべきである。

プロキシ接続の連鎖の末端にあるIPアドレスはX-Forwarded-Forフィールドの中に含まれていないので、X-Forwarded-Forフィールドのログをただ取得することは常に十分であるとは限らない。その情報は実際にはIPヘッダに含まれている。徹底するためには、ウェブサーバは接続要求元IPアドレスとX-Forwarded-Forフィールドの情報の双方を記録すべきである。

各種製品のサポート状況

プロキシサーバとキャッシュエンジン

X-Forwarded-Forフィールドは多くのプロキシサーバやキャッシュ・エンジンでサポートされており、Apacheなどのウェブサーバと連携できるものも含まれる。一例を挙げると、 SquidSquid configuration directive forwarded_forSquidFaq/ConfiguringSquid Apache mod_proxymod_proxy IHSも同様リバース・プロキシーとしての IHS の構成。 Pound proxy。"Request Logging"を参照。 HAProxyHAProxy 設定マニュアル Varnish Cacheログ記録に関するVarnish FAQ。 Web Security ApplianceIronPort Web Security Appliances

アレイ・ネットワークス

F5 Big-IPApache または PHP で "X-Forwarded-For" を使用する Blue Coat ProxySGBluecoat Knowledge Base Article 2996 Cisco キャッシュエンジンCisco Cache Engine ユーザガイド Version 2.1.0 - Appendix A: Command Reference - グローバル設定コマンド - "http" McAfee Web ゲートウェイ Phion Airlock Finjan製 Vital Security NetApp （に売却済み）Web キャッシュを調節 - NetApp NetCache C720 jetNEXUS Crescendo Networks製 Maestro Microsoft ISA Server 2004/2006 に ISA サーバ向け Winfrasoft X-Forwarded-For を積んだものTMG, ISA サーバと IIS 向け X-Forwarded-For Winfrasoft X-Forwarded-For Microsoft と Forefront TMG 2010 （ 2012年11月末をもって販売終了）- フリー・ウェブフィルターの TMG あるいは XFF-Filter.dll 向けTMG2010 向け X-Forwarded-For フリー・ウェブフィルター などがある。

X-Forwarded-Forフィールドを記録する方法はApache HTTP Serverをはじめとする多くのウェブサーバでサポートされている。Microsoft IIS 6.0と7.0では"Winfrasoft X-Forwarded-For for IIS"というサードパーティーのISAPIフィルターがこの機能を実現している。IIS 7.0はまた、"HTTP Module"というサードパーティー製フィルターを利用できるIIS7 向け X-Forwarded-For HTTP Module, ソースも提供!。

ロードバランサ

"Zeus Traffic Manager"と"Zeus Load Balancer"はX-Forwarded-Forフィールドをサポートしている。 RadwareのロードバランサはVLAN間でのルーティングに利用されるルーターの設定。とmulti-armed設定用のX-Forwarded-Forをサポートしている。 シトリックス・システムズの"NetScaler"はクライアントのIPアドレスをクライアントの接続要求に挿入するため、X-Forwarded-Forをはじめとするユーザー定義フィールドをサポートしているCitrix NetScaler Traffic Management Guide - Release 9.1。 "Cisco Ace Load Balancing Modules"は、送信元ネットワークアドレス変換（"source NAT"、SNAT）を実行するためロードバランサを設定する時や、ロードバランサのone-armed設定を有効にした場合、このフィールドを挿入可能であり、通常それで十分であるが、一方、クライアントの送信元IPアドレスのために実体サーバが利用できる仕組みをこの製品は提供する。製品マニュアルには"x-forward"と記述されているが、これはX-Forwarded-Forの代わりであると推定されるCisco ACE with Source NAT and Client IP Header。 CAI Networksのロードバランサはone-armed single network設定向けのX-Forwarded-Forをサポートしている。 F5ネットワークスのロードバランサはone-armedとmulti-armed設定向けのX-Forwarded-ForをサポートしているUsing the X-Forwarded-For HTTP header field to preserve the original client IP address for traffic translated by a SNAT。 jetNEXUSのロードバランサはone-armedとmulti-armed設定向けのX-Forwarded-Forをサポートしている。 "LoadMaster"はone-armedとmulti-armed設定双方で非透過的負荷分散処理向けにX-Forwarded-ForをサポートしているLoadMaster Product Manual. p.129。 "Equalizer"はone-armedとmulti-armed設定双方で負荷分散処理向けにX-Forwarded-ForフィールドをサポートしているEqualizer User Guide. pp.119,136。 HAProxyはone-armedとmulti-armed設定双方で非透過的または透過的負荷分散処理向けにX-Forwarded-Forをサポートしている。 OpenBSD "relays"はこのフィールドを挿入もしくは改変できるrelayd.conf manual page。 Amazon's Elastic Load Balancing serviceはIPv4、IPv6双方でこのフィールドをサポートしているUsing IPv6 with Elastic Load Balancing。 "LBL LoadBalancer"はone-armedとmulti-armed設定向けにX-Forwarded-Forをサポートしている。

ウェブサーバログのためのX-Forwarded-For 多くのウェブサーバはログファイルにX-Forwarded-Forフィールドに含まれるIPアドレスを記録するよう設定できる。Apache HTTP Serverでは、これは標準機能として実装されており、単に設定を変更することでログに記録するようになる具体的には、X-Forwarded-Forは、（非標準であるとはいえ）HTTPヘッダフィールドであるから、設定ファイル（/etc/apache2/apache2.confなど）のLogFormatディレクティブにて LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b" などと記述してから、httpdデーモンを再起動すれば、以降のログの各行最左端にX-Forwarded-Forフィールドの中身が記録される。またApacheはHTTPヘッダフィールドを環境変数として利用可能であるからSetEnvIfディレクティブを利用し、X-Forwarded-Forと送信元IPアドレスを使った簡易なアクセス制御も可能である。IHSも同様。"負荷分散装置やProxyが付与する"X-Forwarded-For"ヘッダー情報をIHSアクセス・ログに記録する方法 (NTWK-09-036)"。しかしながら、Microsoft IISはサードパーティーアプリケーションが必要であるWinfrasoft X-Forwarded-For for IISはIISにX-Forwarded-For IPサポートを追加するIISのサードパーティープラグインである。これを利用すると、IISのW3C Extended Log Fileにおける"c-ip"（client-ip）ログ・フィールドにXFFの情報を追加することができる。。IIS7向けには、IIS.netウェブサイトから、同様にIISのログにX-Forwarded-Forの値を書き込むフリーなIISモジュールを取得可能であるClient-ip not logged on application server when using ARR 。

脚注

注釈

出典

関連項目

プロキシ - 送信元IPアドレスを通知する電子メールヘッダ。

外部リンク Forwarded HTTP Extension Apache mod_extract_forwarded - Apacheソフトウェア財団外で作成されているプロキシ転送情報抽出用Apache HTTP Serverモジュール。 X-Forwarded-For in TMG2010 Free web filter for TMG2010 to add X-Forwarded-For header in inbound requests XFF project - ウィキメディア財団のXFFに関する情報。