WebServer へのリクエスト情報から動的に BaseURL を決定する方法（IIS 編）

2021年1月15日 最終更新日時 : 2025年2月19日 kodamad

ここでは、WebServer（IIS）へのリクエスト情報から BaseURL を動的に決定する方法を BaseUrlProvider のサンプル実装、IIS との連携例と共に紹介します。
製品標準の設定では、テナント一つにつき、一つの BaseURL のみが設定可能ですが、BaseUrlProvider インタフェースを実装することで、複数の BaseURL を持たせることができます。
BaseUrlProvider は intra-mart Accel Platform 2014 Summer (Honoka) から導入されたインタフェースです。
したがって、2014 Summer (Honoka) 以降で使用可能です。

WebServer が Apache の場合はこちら

図のようにクライアントから WebServer へアクセスするURLの情報を利用して、WebServer（IIS）で BaseURL を作成します。
さらに、WebServer で作成した BaseURL を HTTP Header に追加して、intra-mart AccelPlatform（Resin）へ渡します。
intra-mart AccelPlatform では、BaseUrlProvider を用いて HTTP Header を確認し、渡された BaseURL を利用します。

注意事項

Internet Information Services (IIS) の設定

URL Rewrite モジュールを利用し、リクエスト情報を元に HTTP Header (x-com-base-url)に BaseURL を設定します。

前提条件

  • 「静的ファイルの配置」がされていること。
  • 設定手順は セットアップガイド-Internet Information Services(IIS) を参照してください。
  • IISの稼働しているサーバへ2つのドメイン名からアクセスできるようにします。(app1.example.com および app2.example.com)
    試験的に名前解決を行う場合はブラウザを利用するマシンの hosts ファイルにドメイン名を記述します。
    実際の運用ではDNSで名前解決できるようにしてください。

    1. Windows の場合は、C:\Windows\System32\drivers\etc\hosts に以下を追加します。
    2. IIS サーバのIPアドレスが 192.168.1.1 の場合 
      192.168.1.1 app1.example.com
192.168.1.1 app2.example.com

手順

以降の手順では下記の環境を想定しています。

intra-mart AccelPlatform のコンテキストパス imart
IIS のルート ディレクトリ C:\inetpub\wwwroot
静的ファイルの展開フォルダ C:\imart
intra-mart AccelPlatform の IP アドレス 192.168.1.2
intra-mart AccelPlatform のポート番号 8080
IIS の IP アドレス 192.168.1.1
IIS のポート番号 80
  1. web.config を以下のように変更します。
    【変更前】

    <rewrite>
  <rules>
    <clear />
    <rule name="ReverseProxyInboundStatic" stopProcessing="true">
      <match url="^imart/(?!reverse_proxy/)(.*\.gif|.*\.png|.*\.jpg|.*\.jpeg|.*\.css|.*\.js|.*\.swf|.*\.ico|.*\.svg|.*\.json|.*\.jar|.*\.xml|.*\.yaml|.*\.txt|.*\.html|.*\.htm)$" />
      <action type="None" />
    </rule>
    <rule name="ReverseProxyInboundDynamic" stopProcessing="true">
      <match url="^imart/(.*)" />
      <action type="Rewrite" url="http://192.168.1.2:8080/imart/{R:1}" />
    </rule>
  </rules>
  <outboundRules>
    <rule name="RewriteLocationHeader" preCondition="Redirect Response">
      <match serverVariable="RESPONSE_Location" pattern="^http://192.168.1.2:8080/imart/(.*)" />
      <action type="Rewrite" value="http://app1.example.com/imart/{R:1}" />
    </rule>
    <preConditions>
      <preCondition name="Redirect Response">
        <add input="{RESPONSE_STATUS}" pattern="3\d\d" />
      </preCondition>
    </preConditions>
  </outboundRules>
</rewrite>

    【変更後】

    <rewrite>
  <rules>
    <clear />
    <rule name="ReverseProxyInboundStatic" stopProcessing="true">
      <match url="^imart/(?!reverse_proxy/)(.*\.gif|.*\.png|.*\.jpg|.*\.jpeg|.*\.css|.*\.js|.*\.swf|.*\.ico|.*\.svg|.*\.json|.*\.jar|.*\.xml|.*\.yaml|.*\.txt|.*\.html|.*\.htm)$" />
      <action type="None" />
    </rule>
    <rule name="MakeBaseUrl(protcol1)">
      <match url="^imart/(.*)" />
      <conditions>
        <add input="{HTTPS}" pattern="ON" />
      </conditions>
      <serverVariables>
        <set name="HTTP_X_COM_BASE_URL" value="https://{HTTP_HOST}" />
      </serverVariables>
      <action type="None" />
    </rule>
    <rule name="MakeBaseUrl(protcol2)">
      <match url="^imart/(.*)" />
      <conditions>
        <add input="{HTTPS}" pattern="OFF" />
      </conditions>
      <serverVariables>
        <set name="HTTP_X_COM_BASE_URL" value="http://{HTTP_HOST}" />
      </serverVariables>
      <action type="None" />
    </rule>
    <rule name="ReverseProxyInboundDynamic" stopProcessing="true">
      <match url="^(imart)/(.*)" />
      <action type="Rewrite" url="http://192.168.1.2:8080/{R:1}/{R:2}" />
      <serverVariables>
        <set name="HTTP_X_COM_BASE_URL" value="{HTTP_X_COM_BASE_URL}/{R:1}" />
      </serverVariables>
    </rule>
  </rules>
  <outboundRules>
    <rule name="RewriteLocationHeader" preCondition="Redirect Response">
      <match serverVariable="RESPONSE_Location" pattern="^http://192.168.1.2:8080/imart/(.*)" />
      <action type="Rewrite" value="{HTTP_X_COM_BASE_URL}/{R:1}" />
    </rule>
    <preConditions>
      <preCondition name="Redirect Response">
        <add input="{RESPONSE_STATUS}" pattern="3\d\d" />
      </preCondition>
    </preConditions>
  </outboundRules>
</rewrite>
  2. 「Default Web Site」、「URL 書き換え」、をダブルクリックします。
  3. 「サーバ変数の表示」をクリックします。
  4. 「追加」をクリックします。
  5. 「サーバー変数名」に「HTTP_X_COM_BASE_URL」を入力し、「OK」をクリックします。
  6. IIS を再起動してください。

BaseUrlProvider の実装

HTTP Header に応じて異なる BaseURL を返却する BaseUrlProvider を実装します。

  1. 以下の内容のファイルを WEB-INF/classes/com/example/HttpHeaderBaseUrlProvider.java として保存します。 
    1. package com.example;
import javax.servlet.http.HttpServletRequest;
import jp.co.intra_mart.common.annotation.Priority;
import jp.co.intra_mart.foundation.platform.BaseUrlProvider;
import java.util.Enumeration;

// Priority を設定することで、実装クラスの呼び出し順を制御できます。ここでは、100 とします。
@Priority(value = 100)
public class HttpHeaderBaseUrlProvider implements BaseUrlProvider {

private static final String BASE_URL_HEADER_KEY = "x-com-base-url";

@Override
public String getBaseUrl(final HttpServletRequest request) {
if (request == null) {
return null;
}

final String orgBaseUrl = request.getHeader(BASE_URL_HEADER_KEY);
if (orgBaseUrl != null && orgBaseUrl.length() > 0) {
return orgBaseUrl;
} else {
// null を返却することで、後続の BaseUrlProvider に処理を委ねることができます。
return null;
}
}
}
    2. HTTP Header「x-com-base-url」の値を BaseURL として利用します。
      「x-com-base-url」が存在しない場合は、後続の BaseUrlProvider に処理を委ねます。
  2. 以下の内容のファイルを WEB-INF/classes/META-INF/services/jp.co.intra_mart.foundation.platform.BaseUrlProvider として保存します。 
    1. com.example.HttpHeaderBaseUrlProvider
  3. intra-mart AccelPlatform を起動してください。

動作確認

以下を確認してください。

応用

図のようにクライアントと WebServer の間に Load Balancer がある場合
WebServer で HTTP Header（x-com-base-url）を設定するのではなく、Load Balancer で作成した BaseURL を HTTP Header（x-com-base-url）に設定するようにしてください。
これは、クライアントが最初にアクセスするサーバが Load Balancer となるためです。

カテゴリー
CookBook
タグ
ノウハウ、環境構築
前の記事
WebServer へのリクエスト情報から動的に BaseURL を決定する方法（Apache 編）
2021年1月15日
次の記事
IM-BloomMaker と IM-LogicDesigner を組み合わせて、請求書を Excel でダウンロードする方法
2021年3月5日