キャッシュ機能説明書 (運用管理Webサーバ編)

2.14 クライアントIPアドレス送信機能

　HTTP PROXY機能およびリバース機能使用時に、アクセスしているクライアントのIPアドレスをWWWサーバにリクエストヘッダとして通知する機能です。これにより、アクセスしているクライアントマシンのIPアドレス情報を、WWWサーバのCGIなどの処理で使用することができます。追加するヘッダ名には任意のヘッダ名を指定できます。指定を省略した場合は、"X-Client-IP:"を使用します。

2.14.1 送信するIPアドレスヘッダの形式

　以下の4つのうちのいずれかの形式で、送信するIPアドレス情報ヘッダを作成します。

• ヘッダ行を追加する
  　リクエストヘッダの先頭行にIPアドレス情報ヘッダを追加します。同じ名前のヘッダが既に存在する場合でも、IPアドレス情報ヘッダを追加します。
  
  
• 同一ヘッダが存在した場合は削除して追加する
  　クライアントからのリクエストヘッダ中に、追加しようとしているIPアドレス情報ヘッダと同じ名前のヘッダが含まれている場合は、それらをすべて削除した後で先頭行に追加します。
  
  
• 同一ヘッダが存在した場合はヘッダ値の最後に追加する
  　クライアントからのリクエストヘッダ中に、追加しようとしているIPアドレス情報ヘッダと同じ名前のヘッダが含まれている場合は、ヘッダの内容の末尾にIPアドレス情報を追加します。
  　　【例】クライアントのIPアドレスが192.168.0.3の場合
  

  X-Client-IP: 192.168.0.1, 192.168.0.2
  

  　　↓　IPアドレス情報設定(192.168.0.3を最後に追加)

  X-Client-IP: 192.168.0.1, 192.168.0.2, 192.168.0.3

  
  
• 同一ヘッダが存在した場合はヘッダ値の先頭に追加する
  　　クライアントからのリクエストヘッダ中に、追加しようとしているIPアドレス情報ヘッダと同じ名前のヘッダが含まれている場合は、ヘッダの内容の先頭にIPアドレス情報を追加します。
  　　【例】クライアントのIPアドレスが192.168.0.3の場合
  

  X-Client-IP: 192.168.0.2, 192.168.0.1
  

  　　↓　IPアドレス情報設定(192.168.0.3を先頭に追加)

  X-Client-IP: 192.168.0.3, 192.168.0.2, 192.168.0.1

　ただし上記形式のうち、ヘッダ値の最後または先頭にIPアドレス情報を設定する形式を選択し、クライアントから同じ名前のヘッダが複数行送信された場合は、それぞれのヘッダ行を一行に結合した上で、IPアドレス情報を設定します。複数ヘッダ行の結合方法として、以下のいずれかを指定できます。

• ヘッダと逆の並びでヘッダ値を結合する
  　ヘッダ行を受信したのと逆の順番でヘッダの値を結合します。つまり後で受信したヘッダの情報が結合後のヘッダでは前の方にあります。
  　　【例】クライアントのIPアドレスが192.168.0.3の場合
  

  X-Client-IP: 192.168.0.1
  X-Client-IP: 192.168.0.2
  

  　　↓　ヘッダ結合

  X-Client-IP: 192.168.0.2, 192.168.0.1

  　　↓　IPアドレス情報設定(192.168.0.3を先頭に追加する場合)

  X-Client-IP: 192.168.0.3, 192.168.0.2, 192.168.0.1

  
  
• ヘッダと同じ並びでヘッダ値を結合する
  　　ヘッダ行を受信したのと同じ順番でヘッダの値を結合します。つまり先に受信したヘッダの情報が結合後のヘッダでも前の方にあります。
  　　【例】クライアントのIPアドレスが192.168.0.3の場合
  

  X-Client-IP: 192.168.0.1
  X-Client-IP: 192.168.0.2
  

  　　↓　ヘッダ結合

  X-Client-IP: 192.168.0.1, 192.168.0.2

  　　↓　IPアドレス情報設定(192.168.0.3を最後に追加する場合)

  X-Client-IP: 192.168.0.1, 192.168.0.2, 192.168.0.3

　クライアントIPアドレス送信機能の設定方法の詳細については、“11.10　ヘッダ設定”を参照してください。