X-Forwarded-For(XFF) は、ロードバランサーやプロキシなどの中継役が「どこから届いたか」を書き足していくリクエストヘッダーです。ただのヘッダーなので、利用者も好きな値を書いて送れます。アプリが XFF の左端をクライアントの IP として信じていると、IP を偽装されます。信じてよいのは、自分たちの中継役が書いた値(右端)だけです。
接続元の IP はごまかせない
通信は手紙のやりとりに似ています。封筒には差出人の住所(接続元の IP)が書かれています。サーバーは返事をこの住所に送るので、嘘の住所を書くと返事が届かず、通信そのものが始まりません。だから、接続元の IP はごまかせません。
ところが、間に ALB(ロードバランサー)などの中継役がいると、アプリから見た接続元は中継役の IP になります。そこで中継役は、手紙の本文に「元の差出人は○○でした」というメモを書き足します。このメモが X-Forwarded-For です。
X-Forwarded-For: 203.0.113.10
中継役が何段もあるときは、それぞれが自分に直接つないできた相手の IPを、カンマ区切りで後ろに書き足していきます。中継役は、自分自身の IP は書きません。
なぜ偽装できるのか
許可された会社の IP を 203.0.113.10、攻撃者の本当の IP を 198.51.100.7 として、まず正規の利用者がアクセスしたときを見てみます。
ふつうのブラウザや API を呼ぶプログラムは、XFF を付けて送りません。ALB は XFF がなければ新しく作り、自分につないできた相手の IP を入れます。
① 利用者が送る (X-Forwarded-For なし) ② ALB が書く X-Forwarded-For: 203.0.113.10
値は 1 つだけなので、左端を読んでも右端を読んでも 203.0.113.10 で、正しく判定できます。ふだん届くのはこの形なので、左端を読むアプリでも、ふだんは問題なく動いて見えます。
利用者の会社に社内のプロキシがあると、プロキシが社員の PC の社内 IP を書くことがあります(HTTPS では、ふつうプロキシは中身に書き込めないので、書かれないことのほうが多いです。くわしくは「企業からのアクセスで X-Forwarded-For に何が入るか」)。この場合も、ALB が書いた右端は会社の出口の IP です。
① 社内のプロキシが書く X-Forwarded-For: 192.168.1.23 ② ALB が後ろに書き足す X-Forwarded-For: 192.168.1.23, 203.0.113.10
ところが、XFF は本文のメモなので、利用者が最初から書いて送ることもできます。攻撃者が次のように送ったとします。
curl -H "X-Forwarded-For: 203.0.113.10" https://api.example.com/
XFF の考え方では「左端が最初の送り主」なので、左端を読むアプリが多くあります。ところが、左端を書いたのが本当に中継役なのかを、アプリは確かめられません。これが偽装の正体です。
右端だけが本物になる理由
- ALB は攻撃者と直接つながっているので、攻撃者の本当の IP を知っています(封筒の差出人はごまかせない)。
- ALB は、届いた XFF に何が書かれていても、必ずその後ろに本当の IP を書き足します。攻撃者が自分で右端に書いても、ALB がさらに後ろに書くので、攻撃者の値はいつも ALB の値より左になります。
- だから、アプリは右端(ALB が書いた値)を読めば、本当の IP がわかります。
ただし、これが言えるのはリクエストが必ず ALB を通ってきたときだけです。ALB を通らずにアプリへ直接届くと、右端も攻撃者が書いた値になります。そのため、アプリ側では次の 2 つを両方確かめます。
- 接続元(封筒の差出人)が、自分たちの ALB であること
- そのうえで、XFF の右端をクライアントの IP とすること
中継役が 2 段(例:CloudFront → ALB)なら、右端は CloudFront の IP になり、クライアントは右から 2 番目になります。信じる中継役の数だけ、右から読み飛ばします。
まちがえやすいところ
| 思い込み | 実際 |
|---|---|
| ALB の IP が XFF の右端に入る | 入らない。ALB の IP は、アプリから見た接続元として見える |
| XFF は最初から入っている | ふつうは空。入って届くのは、偽装か、利用者の会社のプロキシが書いたとき |
| 利用者の会社のプロキシが書いた社内 IP(左側)も使える | 本物か確かめられないので使わない。右端の会社の出口の IP を使う |
| XFF 以外のヘッダー(X-Real-IP など)なら安全 | 同じ。利用者が書けるヘッダーは、だれが書いたか確かめるまで信じない |
対策の考え方
アプリのコードで XFF を直接読むと、「中継役が何段あるか」「中継役の IP はどの範囲か」「中継役を通らない道はないか」といったネットワークの構成を、アプリが知っていなければなりません。構成が変わると、知らないうちに偽装できる状態に戻ります。
そこで、どの中継役を信じるかは、構成を知っている場所の設定で決め、アプリは決まった IP を受け取るだけにします。
| 動かす場所 | 設定 | アプリが使う値 |
|---|---|---|
| Tomcat | RemoteIpValve(internalProxies に ALB のサブネット) | request.getRemoteAddr() |
| FastAPI(Uvicorn) | --forwarded-allow-ips に ALB のサブネット | request.client.host |
| API Gateway → Lambda | 設定はいらない | requestContext の sourceIp |
合わせて、セキュリティグループなどで、アプリには中継役からしか届かないようにします。
偽装できないかの確かめ方
偽の XFF を付けて送り、アプリのログに出る IP を見ます。
curl -H "X-Forwarded-For: 1.2.3.4" https://api.example.com/
ログに 1.2.3.4 ではなく自分の本当の IP が出れば、偽装は効いていません。1.2.3.4 が出たら、どこかで XFF の左端を読んでいます。IP の判定だけでなく、ログの出力やレート制限などで別々に XFF を読んでいることもあるので、X-Forwarded-For でコードを検索して、読んでいるところを全部確かめます。
