Web ゲートウェイと連携させるための IIS の構成 (Windows)

Web ゲートウェイ・コンポーネントに対する許可の設定

選択した Web ゲートウェイ構成オプションに関係なく、標準の IIS ドキュメント・ルート (例 ： C:\inetpub\wwwroot) 以外の場所に保持されている Web リソースに適切な許可を割り当てる必要があります。

既定では、IIS 7 は Web アプリケーションのユーザに対して、あらかじめ構成されたドキュメント・ルートの範囲外にあるものへのアクセスを一切許可しません。ただし、以下のユーザまたはグループに対して、このような外部リソースへの読み取りと実行および書き込み許可を割り当てている場合は例外です。

[machine_name]\IIS_IUSRS

および、

[machine_name]\Users

IIS_IUSRS は IIS ワーカ・プロセスが動作するユーザ (グループ) を表していることに注意してください。これは、バージョン 7 より前の IIS バージョンで使用されていた IUSR_[machine_name] ユーザ・グループに替わるものです。IIS を通じてコントロールされるアプリケーション (Web ゲートウェイなど) は、IIS_IUSRS に割り当てられた特権のレベルで動作します。

CSP では、Web サーバのルートの外側にあるリソースには、通常、以下のものがあります。

Web ゲートウェイのバイナリ・コンポーネント ：

C:\Inetpub\CSPGateway

静的ファイル・コンポーネント ：

install-dir\CSP\

Windows エクスプローラ経由でこれらのフォルダに手動で特権を割り当てるには、以下の手順に従って操作します。

1. フォルダ名を右クリックし、[プロパティ] を選択します。

2. [セキュリティ] タブを選択します。

3. [編集] を選択します。

4. [追加] を選択します。

5. [選択するオブジェクト名を入力してください] テキスト・ボックスに以下のように入力します。

   [machine_name]\IIS_IUSRS

6. [名前の確認]、[OK] の順に選択します。

7. [グループまたはユーザー名] ウィンドウで [[machine_name]\IIS_IUSRS] を選択してから、以下の操作を実行します。

8. [許可] ウィンドウで [読み取りと実行] および [書き込み] 許可を割り当てます。

9. [適用]、[OK] の順に選択します。

10. [[machine_name]\Users] ユーザ・グループについて、上記の処理を繰り返します。

IIS ユーザ・グループには、Web ゲートウェイの構成ファイルとログ・ファイルに対する完全な読み取りおよび書き込み許可が必要です。例えば、Windows のコマンド・プロンプトで、以下を入力します。

cacls CSP.ini /E /G IIS_IUSRS:F

cacls CSP.log /E /G IIS_IUSRS:F

もちろん、この操作は Windows エクスプローラ経由でもできます。

Web アプリケーション・パスの構成

このセクションでは、IIS で Web アプリケーション・パス (csp など) を構成するための手順について説明します。これらの手順は、IIS のすべての Web ゲートウェイ構成オプションに共通です。

IIS の構成は、[インターネット インフォメーション サービス (IIS) マネージャ] コントロール パネルで行います。ドキュメント・ルートの下で構成したサブディレクトリは、[Virtual] または [Application] に分類されます。[Virtual] サブディレクトリ (またはエイリアス) は物理的な同等物 (Windows のディレクトリ) にマップされます。同じことは Applications に分類されたサブディレクトリにもいえますが、ただし、物理的な同等物が定義できるほか、アプリケーションを特定のアプリケーション・プールに関連付けられるという点が異なります。既定値は DefaultAppPool です。

Web アプリケーションには Web ゲートウェイを通じてサービスが提供されるので、ホスト・サブディレクトリ (/csp など) は [Applications] として構成する必要があります。

既定の CSP 構成では、/csp アプリケーション・パスは物理位置 install-dir\CSP にマップされます。静的ファイルはすべて、このルートの下 (\csp\broker…) に置かれます。

1. [インターネット インフォメーション サービス (IIS) マネージャ] を開きます。

2. 左側のパネルで、最上位レベルを展開して [Web サイト] セクション、[既定の Web サイト] セクションの順に表示します。[既定の Web サイト] セクションをハイライト表示します。

   [MACHINE_NAME] ([machine_name]\[user_name])
               Web Sites
                       Default Web Site
   

   

3. 右側のパネルで、[アプリケーションの表示] を選択します。

4. もう一度、右側のパネルで、[アプリケーション追加] を選択します。

5. [アプリケーション追加] ダイアログに以下のように入力します。

   エイリアス ： csp

   物理パス ： install-dir\CSP\

6. [OK] を選択します。

代替オプションに基づく Web ゲートウェイ・ソリューションを使用している場合は、/csp アプリケーションの下に /bin というアプリケーションをセットアップします。Web ゲートウェイ・バイナリを保持している物理ディレクトリにこれをマップします。以下はその例です。

アプリケーション /csp/bin を C:\Inetpub\CSPGateway にマップします。

/bin を含む URLの有効化

InterSystems IRIS インストーラを使用して Web ゲートウェイをインストールしている場合、この手順は自動的に実行されています。Web ゲートウェイを手動でインストールする場合には、この手順を実行する必要があります(詳細およびこの手順に代わる方法については、次の外部 Web サイト https://weblogs.asp.net/owscott/iis7-blocks-viewing-access-to-files-in-bin-and-other-asp-net-foldersOpens in a new tab を参照)。/bin を含む URL を有効にするには、applicationHost.config ファイルに以下の位置タグを追加します。

<location path="sitename.com/subfolder/bin/debug">
    <system.webServer>
        <security>
           <requestFiltering>
              <hiddenSegments>
                 <remove segment="bin" />                    
               </hiddenSegments>
           </requestFiltering>
        </security>
     </system.webServer>
 </location>

IIS の再起動

このセクションでは、各種コントロール・パネル経由で IIS を再起動したときに何が起こるかについて説明します。

アクティブな IIS インストールに対する構成変更の大半はリアルタイムで行うことができます。しかし、[インターネット インフォメーション サービス (IIS) マネージャ] コントロール・パネルには停止、開始、および再起動オプションが用意されています。これらのオプションは Web サーバ構成の更新には便利ですが、その結果、アクティブ Web ゲートウェイの再初期化が行われることはありません (つまり、Web ゲートウェイの DLL は再ロードされません)。

Web ゲートウェイ・モジュールを再ロードするために IIS を強制的に再起動する場合、メインの Windows [サービス] コントロール・パネルを使用して World Wide Web Publishing サービスを再起動する必要があります。

トラブルシューティング

このセクションでは、IIS で使用するためにサードパーティ・モジュール (ネイティブ・モジュールおよび ISAPI モジュールの両方) を構成しているときによく発生する問題について説明します。

最もよく発生する問題は、再構成後、IIS への要求が失敗し、以下のエラーが表示されるというものです。

Service Unavailable

HTTP Error 503. The service is unavailable.

これは通常、既定のアプリケーション・プールが終了していることを示します。

1. [インターネット インフォメーション サービス (IIS) マネージャ] ウィンドウを開きます。

2. 左側のパネルで、最上位レベルを展開します。[アプリケーション プール] セクションが表示されます。

   [MACHINE_NAME] ([machine_name]\[user_name])

   アプリケーション・プール

3. 既定のアプリケーション・プール (DefaultAppPool)、またはサーバで使用が構成されているアプリケーション・プールのステータスが [開始] になっていることを確認します。

4. 必要に応じて、右側のパネルのオプションを使用して、アプリケーション・プールを再開します。

5. それでも問題が解決されない場合は、メインの Windows イベント・ログ ([アプリケーション] セクション内) を見て、ヒントを探してください。特に、次のエラー・メッセージを確認してください。

   Failed to find the RegisterModule entrypoint in the module DLL C:\Inetpub\CSPGateway\CSPms.dll.The data is the error.

   例えば、これは、使用しているバージョンの Web ゲートウェイ DLL が、このネイティブ・モジュール・インタフェースを実装していないことを示します。インターシステムズから最新の DLL を入手するか、または従来の ISAPI インタフェースで動作するように Web ゲートウェイを構成します。

すべてのソフトウェアと同様、一時的な問題が再起動により解決されることはよくあります。IIS を完全に再起動するには、メインの Windows サービス・コントロール・パネルから World Wide Web Publishing サービスを再起動します。

ファイル拡張子をマップするのにワイルドカードスクリプトマップの追加ユーティリティを使用しないでください。使用すると、「このハンドラーに対して指定されたモジュールが、モジュールの一覧にありません。スクリプト マップ ハンドラー マッピングを追加する場合は、モジュールの一覧に IsapiModule または CgiModule が存在している必要があります。」というエラーが発生する可能性があります。 代わりに、モジュールマップの追加を使用し、ワイルドカードを指定してファイル拡張子をマップしてください。

/bin を含む URL が機能しない場合には、/bin を含む URLの有効化の手動手順を参照してください。

IIS 7 のインストール場所

以下の Web ゲートウェイのコンポーネントおよび CSP 静的ファイルをインストールします。

1. ネイティブ・モジュールの既定の場所

   • CSPms.dll (実行時モジュール)

   • CSPmsSys.dll (システム管理モジュール)

   これらのモジュールの既定の場所は以下のとおりです。

   C:\Inetpub\CSPGateway

   NSD ベース以外の接続オプションの場合、構成ファイルとログ・ファイルはこのディレクトリに書き込まれます。

2. ハイパーイベントのコンポーネント

   • CSPBroker.js

   • CSPxmlhttp.js

   これらのファイルの既定の場所は以下のとおりです。

   install-dir\csp\broker

3. 管理ポータルで使用するその他の静的リソース

   管理ポータルでは、(イメージ・ファイルなど) いくつかの静的な Web リソースが必要になります。これらのファイルの既定の場所は以下のとおりです。

   install-dir\csp\sys

推奨オプション ： ネイティブ・モジュールの使用 (CSPms*.dll)

これは最も多く使用されている推奨オプションです。これは、IIS 7 で導入されたネイティブ・モジュール・インタフェースを使用します。このオプションでは最適なパフォーマンスが得られます。

その他の構成オプションについては、"IIS 7 以降の代替オプション (Windows)" および "NSD の使用法 (Windows)" を参照してください。

インターシステムズのファイル・タイプを認識し、それらを Web ゲートウェイに渡して処理するように、ネイティブ・モジュールの登録および Web サーバの構成を行います。インストールで必要となる可能性のある追加ファイル (例えば、分析に必要な特別な CSP リソース) をすべて含めます。

SOAP フォルトの詳細を返すための IIS の構成

エラーが発生している InterSystems IRIS Web サービスは、関連する SOAP フォルトの詳細を含めずに HTTP 500 エラーを返すことがあります。既定では、IIS は広範なエラー情報をローカル・クライアントに対してのみ返します。 しかし、構成ファイル web.config 内の <httpErrors> 要素でこの動作を変更できます。変更するには、以下のセクションを追加して、詳細なエラー情報をすべてのクライアントに配信するように IIS に指示します。

<configuration>
    <system.webServer>
       <httpErrors errorMode="Detailed" />
    </system.webServer>
</configuration>

ホスト環境に関する機密情報がクライアントに公開されることがあるため、この方法を使用する場合は注意が必要です。 errorMode="Detailed" の使用に関するセキュリティ上の問題を回避する代わりの方法は、existingResponse="PassThrough" 指示文を使用することです。

<configuration>
    <system.webServer>
       <httpErrors existingResponse="PassThrough" />
    </system.webServer>
</configuration>

構成の変更後に、IIS を再起動します。

これらの変更は、IIS web.config ファイルに対して手動で行うことができます。または、より適切で、エラーの発生が少ない方法を選択するには、IIS マネージャに組み込まれている構成エディタ を使用します。

1. IIS マネージャの左側の [接続] パネルから、Web サービスに対応するパスを選択します。 例 ：[既定の Web サイト] の後に csp を選択。

2. 中央のパネル下部の [管理] という見出しの下で、[構成エディタ] をダブルクリックします。

3. [セクション] のラベルが付いた上部の [構成エディタ] ドロップダウンで、system.webServer を展開し、[httpErrors] をクリックします。

4. [existingResponse] の横にある値をクリックし、ドロップダウンを使用してオプションを表示します。 [PassThrough] を選択します。

5. 右側の [アクション] ペインで、[適用] をクリックします。

6. 構成の変更後に、IIS を再起動します。

IIS でのエラー処理の詳細は、以下を参照してください。

https://docs.microsoft.com/en-us/iis/configuration/system.webServer/httpErrors/Opens in a new tab