インストールと構成
以下のセクションでは、WBI_folder は現在インストールされている InterChange Server Express が格納されているフォルダーを指します。すべての環境変数およびファイル分離文字は Windows 2003 の形式で記述されます。
サーバーとツールの始動
- ショートカットから InterChange Server Express を始動します。
- WebSphere Business Integration Server Express System
Manager を始動して、Component Navigator のパースペクティブを開きます。
- サーバーをサーバー・インスタンスとして InterChange Server Express ビューに登録および接続します。
サンプル・コンテンツのロード
Component Navigator のパースペクティブから以下を実行します。
- 新規統合コンポーネント・ライブラリーの作成
- WBI_folder¥connectors¥HTTP¥samples¥WebSphereICS¥ にある HTTPSample.jar というリポジトリー・ファイルのインポート
コラボレーション・テンプレートのコンパイル
WebSphere Business Integration Server Express System
Manager を使用して以下の作業を実行します。
- リポジトリー・ファイル HTTPSample.jar からインポートされたコラボレーション・テンプレートをすべてコンパイルする。
コネクターの構成
- コネクターをまだ構成していない場合は、このガイドの説明に従ってご使用のシステムに応じて構成してください。
- WebSphere Business Integration Server Express
System Manager を使用して、Connector Configurator Express の HTTPConnector
を開きます。
- また、このサンプルで使用するプロトコルの HTTPConnector も構成する必要があります。
HTTP プロトコル・シナリオ用の構成
このセクションでは、HTTP サンプル・シナリオ用にコネクターを構成する方法について説明します。本書の本文に記載されているとおり、コネクターには HTTP プロトコル・リスナーと HTTP-HTTPS プロトコル・ハンドラーが組み込まれています。
以下のステップと説明では、階層コネクター構成プロパティーが -> 記号で示されています。例えば、A-> B は、A が階層プロパティーであり、B が A の子プロパティーであることを示します。
このサンプルに対して HTTP プロトコル・リスナーを構成するには、以下の手順に従います。
- Connector Configurator Express で、HTTPConnector の「コネクター固有プロパティー」をクリックします。
- ProtocolListenerFramework プロパティーを展開して、ProtocolListeners 子プロパティーを表示します。
- ProtocolListeners 子プロパティーを展開して、HTTPListener1 子プロパティーを表示します。
- HTTPListener1->Host および
HTTPListener1->Port の各プロパティーの値を検査します。ホストで他のプロセスが実行中でないこと、この TCP/IP ポートで listen していないことを確認してください。オプションで、HTTPListener1->Host の値をコネクターを実行するマシン名に設定することもできます。
このためにこのサンプルに HTTP-HTTPS プロトコル・ハンドラーを構成する必要はありません。
HTTPS プロトコル・シナリオ用の構成
このセクションでは、HTTPS サンプル・シナリオ用にコネクターを構成する方法について説明します。
コネクターには、HTTPS プロトコル・リスナーおよび HTTP-HTTPS プロトコル・ハンドラーが
含まれています。
以下のステップと説明では、階層コネクター構成プロパティーが -> 記号で示されています。例えば、A-> B は、A が階層プロパティーであり、B が A の子プロパティーであることを示します。
注:
はじめににリストされたプリインストール項目の他に、鍵および証明書管理ソフトウェアを使用して、鍵ストアとトラストストアを作成およびテストしておく必要があります。
SSL コネクター固有プロパティーの構成
HTTPS の場合、コネクターに
SSL コネクター固有の階層プロパティーを構成する必要があります。
- Connector Configurator Express で、HTTPConnector の「コネクター固有プロパティー」タブをクリックします。
- SSL 階層プロパティーを展開して、すべての子プロパティーを表示します。さらに、階層
SSL コネクター固有プロパティーの以下の子プロパティーを確認または変更します。
- SSL->KeyStore このプロパティーは、鍵ストア・ファイルへの完全パスに設定します。このファイルは鍵および証明書管理ソフトウェアを使用して作成する必要があります。
- SSL->KeyStorePassword このプロパティーは、KeyStore にアクセスするために必要なパスワードに設定します。
- SSL->KeyStoreAlias このプロパティーは、KeyStore の秘密鍵の別名に設定します。
- SSL->TrustStore このプロパティーは、鍵および証明書管理ソフトウェアを使用して作成したトラストストア・ファイルへの完全パスに設定します。
- SSL->TrustStorePassword このプロパティーは、TrustStore にアクセスするために必要なパスワードに設定します。
注:
必ず Connector Configurator Express で変更内容を保管するようにしてください。
HTTPS プロトコル・リスナーの構成
- Connector Configurator Express で、HTTPConnector の「コネクター固有プロパティー」をクリックします。
- ProtocolListenerFramework プロパティーを展開して、ProtocolListeners 子プロパティーを表示します。
- ProtocolListeners 子プロパティーを展開して、HTTPSListener1 子プロパティーを表示します。HTTPSListener1->Host および HTTPSListener1->Port の
各プロパティーの値を検査します。ホストで他のプロセスが実行中でないこと、この TCP/IP ポートで listen していないことを確認してください。オプションで、HTTPSListener1->Host の値を
コネクターを実行するマシン名に設定することもできます。
このためにこのサンプルに HTTP-HTTPS プロトコル・ハンドラーを構成する必要はありません。
KeyStore および TrustStore のセットアップ
サンプル・シナリオで使用できるように KeyStore と TrustStore を素早くセットアップできます。実動システムの場合は、鍵ストア、証明書、および鍵生成をセットアップおよび管理するために、サード・パーティーのソフトウェアを使用する必要があります。これらのリソースをセットアップおよび管理するためのツールは Adapter for HTTP には含まれていません。
このセクションは、Java 仮想マシンがシステムにインストール済みであること、JVM (Java 仮想マシン) に付属の鍵ツールについて十分な知識と経験があることを前提としています。鍵ツールの詳細と問題のトラブルシューティングについては、JVM に付属の資料を参照してください。
KeyStore をセットアップするには、以下の手順に従います。
- 鍵ツールを使用して KeyStore を作成します。KeyStore に鍵ペアを作成する必要があります。これを実行するには、コマンド行に以下を入力します。
keytool -genkey -alias httpadapter -keystore c:¥security¥keystore
- これにより、鍵ツールからパスワードを入力するようプロンプトが出ます。SSL->KeyStorePassword コネクター・プロパティーの値として入力したパスワードを指定します。
上記の例で、コマンド行に -keystore c:¥security¥keystore を指定した場合は、c:¥security¥keystore を SSL->KeyStore プロパティーの値として入力することができます。また、コマンド行に -alias httpadapter を指定した場合は、httpadapter を SSL->KeyStoreAlias コネクター・プロパティーの値として入力することができます。次に、鍵ツールから、証明書の詳細についてプロンプトが出されます。以下は、各プロンプトとその入力例を示しています。ただし、以下に示すのは単なる例にすぎません。必ず鍵ツールの資料を参照してこれに従ってください。
What is your first and last name?
[Unknown]: HostName
What is the name of your organizational unit?
[Unknown]: myunit
What is the name of your organization?
[Unknown]: myorganization
What is the name of your City or Locality?
[Unknown]: mycity
What is the name of your State or Province?
[Unknown]: mystate
What is the two-letter country code for this unit?
[Unknown]: mycountryIs <CN=HostName, OU=myunit, O=myorganization,
L=mycity, ST=mystate, C=mycountry> correct?
[no]: yes
- 「What is your first and last name?」というプロンプトが表示されたら、コネクターを実行しているマシンの名前を入力します。次に、鍵ツールから次のプロンプトが出されます。
Enter key password for <httpadapter> (RETURN if same as keystore password):
- 同じパスワードを使用するには「Return」を選択します。自己署名証明書を使用する場合は、上記で作成済みの証明書のエクスポートが可能です。これを実行するには、コマンド行に以下を入力します。
C:¥security>keytool -export -alias httpadapter -keystore c:¥security¥keystore
-file c:¥security¥httpadapter.cer
- ここで、鍵ツールから、鍵ストア・パスワードを入力するよう求めるプロンプトが出されます。上記で入力したパスワードを入力します。
TrustStore をセットアップするには、以下の手順に従います。
- TrustStore にトラステッド証明書をインポートするには、次のコマンドを入力します。
keytool -import -alias trusted1 -keystore c:¥security¥truststore
-file c:¥security¥httpadapter.cer
- ここで、鍵ツールから、鍵ストア・パスワードを入力するよう求めるプロンプトが出されます。-keystore c:¥security¥truststore と入力した場合は、SSL->TrustStore プロパティーが c:¥security¥truststore に設定されていることを必ず確認してください。また、SSL->TrustStorePassword プロパティーの値を、上記で入力したパスワードに設定する必要があります。
ユーザー・プロジェクトの作成
- WebSphere Business Integration System Manager を使用して、新規ユーザー・プロジェクトを作成します。サンプル・コンテンツのロードで作成した統合コンポーネント・ライブラリーから、すべてのコンポーネントを選択します。
プロジェクトの追加と配置
- サーバー・インスタンス・ビューから、ユーザー・プロジェクトの作成で作成したユーザー・プロジェクトを InterChange Server Express に追加します。
- このユーザー・プロジェクトのすべてのコンポーネントを InterChange Server Express に配置します。
InterChange Server Express のリブート
- すべての変更内容を有効にするため、InterChange Server Express をリブートします。
- System Monitor ツールを使用して、コラボレーション・オブジェクト、コネクター・コントローラー、およびマップがすべて正常であることを確認します。
