Web サービス構成

このセクションの内容

•前提条件

•Web サービス ポート構成

•SSL を使用するように Application Manager Web サービスを構成する

•通信で使用される TCP ポート番号の構成

•Windows HTTP サブシステムの構成

•構成用に Application Manager Web サービスを編集する

前提条件

Application Manager Web サービスのシステム要件

•Microsoft .NET Framework 4.0 Full (x86および x64)

•Microsoft Visual C++ 2015 x86 Redistributable パッケージ。これは x64および x86バージョンの両方で必要ですApplication Control

必要なユーティリティとコンポーネントの詳細については、User Workspace Manager ヘルプの「前提条件」トピックをご参照ください。

Web サービス ポート構成

Application Manager Web サービスには、次の2つの通信経路があります。

•データの報告を許可するために Application Control エージェントをホストするコンピュータ。

•収集されたデータのクエリを許可する Application Controlコンソール。

Application Manager Web サービスとの通信は HTTP または任意で Secure HTTP (HTTPS) 経由で行われます。既定は、標準 TCP ポート 80 (HTTP) および 443 (HTTPS) です。既定値を使用することをお勧めします。これらのポートはファイアウォール製品によって認識されており、トラブルがないインストールが可能です。

ただし、ポートが他のソフトウェアと競合している場合は、手順に従い、空きポートを使用するように、Application Manager Web サービスを構成してください。

SSL を使用するように Application Manager Web サービスを構成する

この手順は、Application Manager Web サービスを構成して、通信で安全なソケットを使用する方法について説明します。

  1. [スタート] > [実行] をクリックし、MMC と入力します。

    Microsoft 管理コンソールが表示されます。

  2. [ファイル] > [スナップインの追加と削除...] をクリックします。 

    [スナップインの追加と削除] ダイアログが表示されます。

  3. [証明書] を選択し、[追加] をクリックします。

  4. [証明書スナップイン] ダイアログで、[コンピュータ アカウント] を選択し、[次へ] をクリックします。

  5. [完了]、[OK] の順にクリックします。

    スナップインが MMC に追加されました。

  6. ナビゲーション ツリーで、[証明書 (ローカル コンピュータ)] > [個人] をクリックします。

  7. [個人] を右クリックし、[すべてのタスク] > [インポート...] を選択します。

    [証明書インポート ウィザード] が表示されます。

  8. [次へ] をクリックします。

  9. [参照] をクリックし、[開く] ダイアログで [すべてのファイル] を選択します。

  10. 目的の PFX ファイルに移動して選択し、[開く] をクリックします。
  11. [次へ] をクリックします。

  12. 秘密鍵のパスワードを入力し、[次へ] をクリックします。

  13. [証明書のタイプに基づいて自動的に証明書ストアを選択する] オプションを選択し、[次へ] をクリックします。

  14. [次へ]、[OK] の順にクリックし、インポートを完了します。ウィザードを閉じます。

  15. MMC を更新します。

    証明書は、[個人] > [証明書ストア] に表示されます。

  16. コンピュータ証明書を右クリックし、[開く] を選択します。
  17. [詳細] タブを選択します。

  18. [サムプリント] を選択して、下のテキストボックスに値を表示します。

  19. 値をコピーして、メモ帳などのテキスト エディタに貼り付けます。

  20. 値のスペースを削除します。これは、手順26で入力されたコマンドの certhash 値で使用されます。

  21. [OK] をクリックして、証明書を閉じます。
  22. 保存せずに MMC を閉じます。
  23. Application Manager Web サービスを停止します。
  24. 昇格されたメモ帳から、次のファイルを開きます。
    %ProgramFiles(x86)%\AppSense\ApplicationManager\AnalysisService\AnalysisServiceCore.dll.config
  25. ファイルで、http://localhost:80/ondemand から https://localhost:443/ondemand に変更して保存します。
  26. サーバの昇格された CMD から、次のコマンドを実行し、certhash 値を手順20のサムプリント値で置換します。 
    • netsh http add sslcert hostnameport=localhost:443 certhash=d3a081a09fbde478ecf58b22387955a5daeb87e4 appid={00000000-0000-0000-0000-000000000000} certstorename=my
    • netsh http add sslcert hostnameport=lb-svr2012-r2-5:443 certhash=d3a081a09fbde478ecf58b22387955a5daeb87e4 appid={00000000-0000-0000-0000-000000000000} certstorename=my
  27. Application Manager Web サービスを開始します。

  28. ブラウザから、https を使用して、Web サービスへの接続を入力します。https:// lb-svr2012-r2-5/ondemand 

  29. 有効なユーザで認証します。

通信で使用される TCP ポート番号の構成

この2つの通信経路では、HTTP および HTTPS で使用されるポートを独立して構成し、最大4つの異なるポート番号を構成できます。

ただし、簡素化のため、ポート構成を変更する場合は、両方の通信経路に同じ変更を行うことをお勧めします。HTTP で使用されるポートを変更する場合は、両方の経路で HTTP の変更を行います。Secure HTTP ポートを変更する場合も同じです。

通信に参加するコンピュータのファイアウォールは、構成されたポート上での接続を許可する必要があります。

次の手順を使用して、ポートを構成します。

  1. 管理者レベルのコマンドプロンプトを開き、次のコマンドを入力します。netsh http show urlacl

    予約された URL のリストが表示されます。

  2. 次のエントリが存在していることを確認します。

予約済み URL: https://+:443/AmAnalysisService/

ユーザ:NT AUTHORITY\LOCAL SERVICE

リスニング: はい

委任:いいえ

SDDL: D:(A;;GX;;;LS)

予約済み URL : https://+:443/AmAnalysisQueryDataService/

ユーザ:NT AUTHORITY\LOCAL SERVICE

リスニング: はい

委任:いいえ

SDDL: D:(A;;GX;;;LS)

予約済み URL : https://+:443/OnDemand/

ユーザ:NT AUTHORITY\LOCAL SERVICE

リスニング: はい

委任:いいえ

SDDL: D:(A;;GX;;;LS)

  1. テキスト エディタを使用して、次の場所の AMAnalysisServiceCore.dll.config を開きます。

    C:\Program Files(x86)\AppSense\ApplicationManager\AnalysisService\AMAnalysisServiceCore.dll.config

  2. 次の文のテキスト文書検索:

    <add key="ON_DEMAND_SERVICE_URI" value="https://localhost:80/OnDemand/"/>

  3. 文を次の内容で置換します。

    <add key="ON_DEMAND_SERVICE_URI" value="https://localhost:443/OnDemand/"/>

  4. テキスト文書を保存して閉じます。
  5. Internet Explorer を使用して、https://localhost:443/OnDemand に移動します。

文書を保存するには、テキスト エディタを昇格する必要があります。

Windows HTTP サブシステムの構成

Application Manager Web Service サービスは、Windows HTTP (HTTP.SYS) のポート共有機能を使用して、同じメカニズムを使用する他のアプリケーションとの共存を可能にします。基本レベルでは、ポート番号を含む URL の部分を登録するアプリケーションによって実現されます。これはサービス要求の処理にかかわっています。

Application Manager Web サービスは Local Service アカウントで実行されるため、そのアカウントの部分へのアクセスを付与する必要があります。Application Manager Web サービスをインストールした OS バージョンに応じて、httpcfg.exe または netsh.exe を使用して実行できます。

Windows Server 2008、Windows Server 2008 R2、Windows Server 2012、Windows Server 2012 R2、Windows 7、Windows 8および Windows 8.1

Netsh.exe ツールを使用して、さまざまなネットワーク通信サーバ ロールおよびコンポーネントのステータスを構成および表示します。

詳細については、http://technet.microsoft.com/en-us/library/cc754753(WS.10).aspx をご参照ください。

次の手順を実行します。

管理者レベルのコマンドプロンプトを開き、次のコマンドを入力します。netsh http add urlacl sddl=D:(A;;GX;;;LS) url=<URL>

<URL> is the URL containing the port you wish to grant access to.

次の URL とコマンドを用いて netsh.exe または httcfg.exe ツールを使用して、各ポートを構成します。この例では、netsh.exe ツールを使用していますが、httpcfg.exe でも同じコマンド パラメータを使用します。

HTTP ポート

http://+:<HTTP_PORT>/AmAnalysisService/ と入力します。

この例の <HTTP_PORT> は、標準 HTTP 通信用に選択したポート番号を表します。

たとえば、ポート81を使用するには、次のコマンドを入力します。

netsh http add urlacl sddl=D:(A;;GX;;;LS) url= http://+:81/AmAnalysisService/

Secure HTTP (HTTPS) ポート

https://+:<HTTPS_PORT>/AmAnalysisService/ と入力します

この例の <HTTPS_PORT> は、Secure HTTP 通信用に選択したポート番号を表します。

たとえば、ポート444を使用するには、次のコマンドを入力します。

netsh http add urlacl sddl=D:(A;;GX;;;LS) url= https://+:444/AmAnalysisService/

ポートごとに、次の URL とコマンドを用いて netsh.exe または httpcfg.exe ツールを使用します。この例では、netsh.exe ツールを使用していますが、httpcfg.exe でも同じコマンド パラメータを使用します。

HTTP ポート

http://+:<HTTP_PORT>/ AmAnalysisQueryDataService/ と入力します。

この例の <HTTP_PORT> は、標準 HTTP 通信用に選択したポート番号を表します。

たとえば、ポート81を使用するには、次のコマンドを入力します。

netsh http add urlacl sddl=D:(A;;GX;;;LS) url= http://+:81/AmAnalysisQueryDataService/

Secure HTTP (HTTPS) ポート

https://+:<HTTPS_PORT>/ AmAnalysisQueryDataService/ と入力します。

この例の <HTTPS_PORT> は、Secure HTTP 通信用に選択したポート番号を表します。

たとえば、ポート444を使用するには、次のコマンドを入力します。

netsh http add urlacl sddl=D:(A;;GX;;;LS) url= https://+:444/AmAnalysisQueryDataService/

構成用に Application Manager Web サービスを編集する

Application Manager Web サービス構成を編集するには、XML 構成ファイル AMAnalysisServiceCore.dll.config を手動で編集する必要があります。これは、Application Manager Web サービスがインストールされたディレクトリにあります。

既定のインストール ディレクトリ:

  • 32Bit OS - C:\Program Files\AppSense\Application Manager\AM Web Services
  • 64Bit OS - C:\Program Files (x86)\AppSense\Application Manager\AM Web Services

注意:開始する前に、このファイルのバックアップ コピーを作成することを強くお勧めします。構成が正しくない場合、Application Manager Web サービスが起動しなくなるためです。

以下の手順では、<HTTP_PORT> は、標準 HTTP 通信用に選択したポート番号です。

  1. Windows Services Administrative ツールを使用して、Application Manager Web サービスを停止します。
  2. メモ帳などのテキスト エディタで AMAnalysisServiceCore.dll.config ファイルを開き、<services> XML タグに移動します。
  3. 必要な場合、次の手順を実行します。
    • エージェントとサービスの通信を再構成するには、手順4に移動します。
    • コンソールとサービスの通信を再構成するには、手順9に移動します。

  4. HTTP ポートを変更するには、次の XML タグに移動します。

    <service name="AmAnalysisServiceCore.AmAnalysisWebService">

  5. webHttpNonSecureBinding 属性を選択し、次の形式を使用して、アドレス値を置換します。

    address="http://localhost:<HTTP_PORT>/AmAnalysisService

  6. Secure HTTP ポートを変更するには、次の XML タグに移動します。

    <service name="AmAnalysisServiceCore.AmAnalysisWebService">

  7. webHttpSecureBinding 属性を選択し、次の形式を使用して、アドレス値を置換します。

    address="http://localhost:<HTTPS_PORT>/AmAnalysisService

  8. HTTP ポートを変更するには、次の XML タグに移動します。

    <service name="AmAnalysisServiceCore.AmQueryDataWebService">

  9. wsHttpNonSecureBinding 属性を選択し、次の形式を使用して、アドレス値を置換します。

    address="http://localhost:<HTTP_PORT>/AmAnalysisQueryDataService

  10. Secure HTTP ポートを変更するには、次の XML タグに移動します。

    <service name="AmAnalysisServiceCore.AmQueryDataWebService">

  11. wsHttpSecureBinding 属性を選択し、次の形式を使用して、アドレス値を置換します。

    address="http://localhost:<HTTP_PORT>/AmAnalysisQueryDataService

  12. AMAnalysisServiceCore.dll.config ファイルを保存して閉じます。

    文書を保存するには、テキスト エディタを昇格する必要があります。

  13. テキスト エディタを使用して、次の場所の AMAnalysisServiceCore.dll.config を開きます。

    C:\Program Files(x86)\AppSense\ApplicationManager\AnalysisService\AMAnalysisServiceCore.dll.config

  14. 次の文のテキスト文書検索:

    <add key="ON_DEMAND_SERVICE_URI" value="http://localhost:80/OnDemand/"/>

  15. 文を次の内容で置換します。

    <add key="ON_DEMAND_SERVICE_URI" value="http://localhost:443/OnDemand/"/>

  16. テキスト文書を保存して閉じます。

  17. Windows Services Administrative ツールを使用して、Application Manager Web サービスを起動します。

    サービスを起動できない場合は、エラー データについて、AppSense の下の Windows イベント ログをご参照ください。

関連トピック

権限検出モード