このセクションでは、グローバルに共有および参照できる、JMS、 XPath、 SOAP ヘッダー、およびデータベース プロパティの作成方法について説明します。このセクションの内容:
Table of Contents | ||
---|---|---|
|
グローバルな [JMS 接続プロパティ]
複数のツールがある大規模なテストを作成する場合、一部のツール (SOAP Client、Messaging Client、および Call Back Tool) が同じ JMS 接続プロパティを使用する場合があるかもしれません。各ツールに同じ情報を手動で入力したり、ツール間で設定をコピー & ペーストしたりするよりも、各ツールが参照できる JMS 設定を作成すると簡単です。この場合、テストまたはアクション スイート レベルで [JMS 接続プロパティ] を作成できます。グローバルな JMS プロパティを作成するには、次の作業を実施します。
目的のノードを選択し、[プロパティの追加] ボタンをクリックします。
- [グローバル プロパティの追加] ウィザードで [グローバル プロパティ] > [JMS 接続プロパティ] を選択し、[終了] をクリックします。[プロパティ] ノードが表示され、GUI 左側に [JMS 接続プロパティ] パネルが表示されます。
- [JMS 接続プロパティ] パネルに次のように設定を指定します。
- (任意) [名前] フィールドに新しい名前を入力します。この名前は、これらのプロパティを参照するツールに表示される名前です。グローバルな JMS 接続プロパティのリファレンスは 1 つ以上作成できるので、入力する名前は直観的に目的が分かるものであるべきです。
[すべてのテストにプロパティを追加] をクリックします。このボタンをクリックしない場合、追加したグローバル プロパティはアクション スイートのツールに無視されます。ドロップダウン リストから [共有プロパティのみ使用] を選択した場合、アクション スイート中の関連するツールは、ユーザーが追加したグローバル プロパティだけを使用できます。
- [プロバイダー URL] フィールドで、JMS 管理オブジェクトの場所を指定します。
- [初期コンテキスト] フィールドで、すべての JMS プロパティのマッピングを含む Java クラスを指定します。
- [接続ファクトリ] フィールドで、初期コンテキストから MOM 固有ファクトリのルックアップに使用されるキーを指定します。キュー接続ファクトリまたはトピック接続ファクトリのどちらでもかまいません。
- [認証] エリアでは、[認証の実行] チェックボックスをオンにし、リクエストを認証するためのユーザー名とパスワードを入力します。不正なユーザー名とパスワードが使用された場合、リクエストは認証されません。
Info | ||
---|---|---|
| ||
グローバルな JMS 接続プロパティの設定が完了すると、これらのSOAtest ツールの複数のインスタンスでプロパティを共有できます。 |
グローバルな [無視する XPath] プロパティ
グローバルな JMS プロパティの場合と同様に、同じ XPath 設定を使用する複数の Diff ツールが存在するケースがあるかもしれません。各 Diff ツールに同じ情報を手動で入力したり、Diff ツール間で設定をコピー & ペーストしたりするよりも、各 Diff ツールが参照できる XPath 設定を作成すると簡単です。この場合、アクションまたはテスト スイート レベルでグローバルな XPath プロパティを作成できます。
グローバルな無視する Xpath のリストを作成するには、次の作業を実施します。
目的のスイート ノードを選択し、[プロパティの追加] ボタンをクリックします。
[グローバル プロパティの追加] ウィザードが開きます。
- ウィザードで [グローバル プロパティ] > [無視する XPath] を選択し、[終了] をクリックします。[プロパティ] ノードが表示され、GUI 左側に [JMS 接続プロパティ] パネルが表示されます。
- [無視する XPath] パネルに次のように設定を指定します。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。この名前は、これらのプロパティを参照する Diff ツールに表示される名前です。グローバルな XPath の一覧リファレンスは 1 つ以上作成できるので、入力する名前は直観的に目的が分かるものであるべきです。
[すべてのテストにプロパティを追加] をクリックします。このボタンをクリックしない場合、追加したグローバル プロパティはアクション スイートのツールに無視されます。ドロップダウン リストからの選択に従って、次のいずれかが発生します。
ドロップダウン リストから [共有プロパティのみ使用] を選択した場合、アクション スイート中の関連するツールは、ユーザーが追加したグローバル プロパティだけを使用できます。
ドロップダウン リストから [ローカルプロパティと共有プロパティを使用] を選択した場合、アクション スイート中の関連するツールは、ユーザーが追加したグローバル プロパティおよび個々のツールで設定されたプロパティを使用できます。
- [追加] ボタンをクリックします。[無視する XPath のリスト] の [XPath] 列に空のフィールドが表示されます。デフォルトでは、[設定] 列は自動的にすべての XPath 操作を指定した状態が入力されます。つまり、ユーザーが追加したすべての XPath は無視されます。
[XPath] 列をダブルクリックすると開く [無視する XPath の設定] ダイアログでは、 XPath のポジションを指定します。入力した XPath はスイート中の複数の Diff ツールによって共有できます。 要素の XPath の場所で 1 つ以上の属性を無視したい場合、属性名を空のままにするか、ワイルドカード * を使用します (例: myAttribute*)。
グローバルな [SOAP ヘッダー] プロパティ
複数のツールがある大規模なテストを作成する場合、SOAP Client ツールが同じ SOAP ヘッダー プロパティを使用するケースがあるかもしれません。各ツールに同じ情報を手動で入力したり、ツール間で設定をコピー & ペーストしたりするよりも、各ツールが参照できる SOAP ヘッダー設定を作成すると簡単です。この場合、テストまたはアクション スイート レベルでグローバルな SOAP ヘッダー プロパティを作成できます。
グローバルな SOAP ヘッダーを作成するには、次の作業を実施します。
目的のスイート ノードを選択し、[プロパティの追加] ボタンをクリックします。
[グローバル プロパティの追加] ウィザードが開きます。
- ウィザードで [グローバル プロパティ] > [SOAP ヘッダー] を選択し、[終了] をクリックします。[プロパティ] ノードが表示され、GUI 左側に [SOAP ヘッダー] パネルが表示されます。
- [SOAP ヘッダー] パネルに次のように設定を指定します。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。
[すべてのテストにプロパティを追加] をクリックします。このボタンをクリックしない場合、追加したグローバル プロパティはアクション スイートのツールに無視されます。ドロップダウン リストからの選択に従って、次のいずれかが発生します。
ドロップダウン リストから [共有プロパティのみ使用] を選択した場合、スイート中の関連するツールは、ユーザーが追加したグローバル プロパティだけを使用できます。
ドロップダウン リストから [ローカルプロパティと共有プロパティを使用] を選択した場合、スイート セット中の関連するツールは、ユーザーが追加したグローバル プロパティおよび個々のツールで設定されたプロパティを使用できます。
[追加] ボタンをクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。
- 利用可能なヘッダー タイプから、SOAP ヘッダーのタイプを選択し、[OK] をクリックします。
必要に応じて、SOAP ヘッダーのパラメーターを設定します。各 SOAP ヘッダーの詳細については、「SOAP ヘッダーの追加」を参照してください。
グローバルなデータベース アカウント プロパティ
複数のツールがある大規模なテスト スイートを作成する場合、DB ツールが同じデータベースプロパティを使用するケースがあります。各ツールに同じ情報を手動で入力したり、ツール間で設定をコピー & ペーストしたりするよりも、各ツールが参照できるデータベース アカウントを作成すると簡単です。この場合、スイート レベルでグローバルなデータベース アカウント プロパティを作成できます。
グローバルなデータベース アカウントを作成するには、次の作業を実施します。
目的のスイートを選択し、[プロパティの追加] ボタンをクリックします。
- [グローバル プロパティの追加] ウィザードで [グローバル プロパティ] > [データベース アカウント] を選択し、[終了] をクリックします。[プロパティ] ノードが表示され、GUI 左側に [データベース アカウント] パネルが表示されます。
- [データベース アカウント] パネルに次のように設定を指定します。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。
[すべてのテストにプロパティを追加] をクリックします。このボタンをクリックしない場合、追加したグローバル プロパティはアクション スイートのツールに無視されます。ドロップダウン リストからの選択に従って、次のいずれかが発生します。
ドロップダウン リストから [共有プロパティのみ使用] を選択した場合、アクション スイート中の関連するツールは、ユーザーが追加したグローバル プロパティだけを使用できます。
- 必要に応じて残りのデータベース アカウント設定をします。
- ファイルにアカウント設定を格納している場合、[ファイル] を選択してファイルのパスを指定します。
- ファイルをリフレッシュ/リロードするには (たとえば外部で編集した場合など)、[構成設定のリフレッシュ] をクリックします。
このパネルで設定を指定したい場合、 [ローカル] を有効にし、ドライバー設定を指定します。次を参照:
詳細については「データベース構成パラメーター」を参照してください。
これらの値をファイルにエクスポートするには [構成設定のエクスポート] をクリックします。ファイルに値をエクスポートしたら、[ファイル]> [入力ファイル] コントロール (上記で説明) からファイルをインポートできます。この方法を用いれば、この同じアカウントを別のスイートに追加したいときに値を再入力する必要がありません。
なお、エクスポートされたプロパティ ファイルには以下のプロパティが含まれます:
- driver
- url
- username
- password
- close.connection
例:
version=1
driver=org.hsqldb.jdbcDriver
url=jdbc:hsqldb:hsql://localhost/parabank username=sa
password=dGVzdA==
close.connection=true
- ファイルにアカウント設定を格納している場合、[ファイル] を選択してファイルのパスを指定します。
グローバル キーストア
Anchor | ||||
---|---|---|---|---|
|
キー ストアには、Web サービスを介して安全なサーバー/クライアント認証、XML 暗号化、XML デジタル署名を実行するために必要な証明書や秘密鍵が格納されます。キー ストアで指定した値は、SOAP Client、XML Encryption、および XML Signer ツールで使用できます。
SOAP Client ツールは、キー ストアの証明書を使用してサーバーとのハンドシェークを実行できます。XML Encryption ツールは、キー ストアの証明書を使用して XML ドキュメントを暗号化でき、また XML Signer ツールは、キー ストアの証明書および秘密鍵を使用して XML ドキュメントに署名したり作成者の証明を行うことができます。
Info | ||
---|---|---|
| ||
キー ストアを使用するには、Unlimited Strength Java Cryptography Extension をダウンロードし、インストールする必要があります。詳細については 「JCE 前提条件」 を参照してください。 |
MQ SSL
MQ のグローバル テスト スイート プロパティを構成する場合は、キーストアとトラストストアを構成する必要があります。キーストア設定では、[証明書] タブで必要事項を記入するだけです。[証明書エイリアス] フィールドは必須ではありません。[秘密鍵] タブは MQ SSL には適用されません。
ローカル キー ストアの構成
ローカル キー ストアの構成は、テスト スイートのすべてのクライアントとツールに関係します。
- テスト スイート エクスプローラーでテスト スイートを右クリックし、[新規追加] > [グローバル プロパティ] を選択します。
- [グローバル キー ストア] を選択して [終了] クリックします。キー ストアの子を持つキー ストア ノードがテスト ケースに追加されます。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。
- [ローカル] オプションを選択し、[キー ストア] パネルの [証明書] タブで次の設定を指定します。
- キー ストアに証明書の秘密鍵が含まれている場合は [秘密鍵に同じキー ストアを使用] を有効にします。
- [キー ストア ファイル] フィールドでキー ストア ファイルを指定します。[相対パスとして保持] を有効にし、相対パスとして (つまり、プロジェクトの共有を促進するために) 場所を保存します。
- [キー ストア パスワード] フィールドにキー ストアのパスワードを入力します。
- [キー ストア タイプ] ドロップダウンメニューから、使用されているキー ストアのタイプ (JKS、PKCS12、BKS、UBER、PEM) を選択します。
- [ロード] をクリックし、利用可能な証明書/キーでエイリアスを入力します。パス、タイプ、およびキー ストア パスワードが有効でない場合、証明書/キーはロードされません。
- [証明書のエイリアス] ドロップダウン メニューで証明書のエイリアスを選択します。
- [秘密鍵] タブをクリックします。
- [証明書]タブで [秘密鍵に同じキー ストアを使用] が無効になっている場合 (手順 4.a-4.d を参照)、適切なフィールドでキー ストア ファイル、キー ストアのパスワード、およびキー ストア タイプを指定します。
- [ロード] をクリックし、利用可能な証明書/キーでエイリアスを入力します。パス、タイプ、およびキー ストア パスワードが有効でない場合、証明書/キーはロードされません。
- [秘密鍵のパスワード] フィールドで秘密鍵のパスワードを指定し、変更を保存します。
キー ストア ファイルが外部で編集されている場合、[構成設定のリフレッシュ] をクリックして構成フィールドを再ロードし、グローバル キー ストアが最新の値を使用するようにできます。
グローバル キー ストア設定のエクスポート
グローバル キー ストアを構成した後、設定を .properties ファイルにエクスポートし、他の .tst ファイルでこの設定を参照して、プロジェクトのすべてのスイートに同じキー ストア設定を構成する必要がないようにすることができます。
- ローカル キー ストア設定を構成し、[構成設定のエクスポート] をクリックします。
- .properties 構成ファイルを保存する場所を選択します。
グローバル キー ストア設定のインポート
別のテスト シナリオからエクスポートされたキーストア構成を参照できます。これにより、証明書の設定を一度構成し、プロジェクト間で共有できます。ソース キー ストアの .properties 構成ファイルが更新されると、そのファイルを参照するテスト ケースも更新されます。
- テスト スイート エクスプローラーでテスト スイートを右クリックし、[新規追加] > [グローバル プロパティ] を選択します。
- [グローバル キー ストア] を選択して [終了] クリックします。キー ストアの子を持つキー ストア ノードがテスト ケースに追加されます。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。
- [ファイル] オプションを選択し、キー ストア設定の .properties ファイルを参照します。
- 変更を保存します。
Anchor | ||||
---|---|---|---|---|
|
Data Bank などのグローバル ツールをテスト スイートに追加し、テスト シナリオ全体で必要に応じて参照することで、毎回再作成する必要がなくなります。
- テスト スイートを右クリックし、[新規追加] > [グローバル プロパティ] を選択します。
- [グローバル ツール] メニューからツールを選択し、[終了] をクリックします 。新しいツール ノードがテストケース エクスプローラーに表示されます。
- ツールのコンフィギュレーション パネルでツールの設定をカスタマイズします。
- 「出力の追加」で説明されているとおり、ツールにさらに別のツールを連結できます。
テストでグローバル ツールを使用するには、テストまたは出力を追加する際に表示される [既存ツール] リストからツールを選択します。
スイート内の他のツールまたはグローバル ツールによって参照されているグローバル ツールを削除すると、参照も削除するように求められます。
ツールを削除しても参照を保持することを選択した場合、参照は非アクティブ化され、スイートに残ります。削除されたツールと同じ名前の新しいグローバル ツールが追加されると、参照は再び有効になります。
グローバル WS-Policy バンク
Web サービスの大きな特徴の 1 つが相互運用性です。Web サービスは、サービス コンシューマーが満たすべき要件を宣言するための標準化されたインターフェイスに依拠してサービス プロバイダーと相互に通信します。標準的な WSDL 仕様には、複雑なクライアント サイドの要件を宣言する機能がありません。これを補うため、WSDL は WS-Policy および WS-PolicyAttachment によって拡張され、サービス プロバイダーが WSDL 内で付加的な要件を定義することが可能になっています。WS-Policy は、他の WS-* 仕様に独自のポリシーのセットの定義を委ねています。そのような仕様の 1 つが、WS-Security に関するポリシーを定義する WS-SecurityPolicy です。
SecurityPolicy 拡張を使用する WSDL を読み取ると、SOAtest はポリシーに関する必要な設定をすべて備えたテスト ケースを自動的に生成します。テスト ケースの一部の属性については手動で設定する必要がありますが、基盤となるテストは自動的にセットアップされます。
Note | ||
---|---|---|
| ||
WS-Policy は簡易的な仕様です。WS-Policy はポリシーの設計を他の WS-* 仕様に委ねています。また、ベンダーに依存するポリシーの大規模なセットも存在します。WS-* の範囲は広大であるため、SOAtest は WS-SecurityPolicy のアサーションだけをサポートしていますが、他の一般的なアサーション セットも処理できるよう、プロセッサの拡張が続けられています。 |
WS-Policy バンクを追加するには、以下の操作を行います。
- 対象のテスト スイートのノードを選択し、[プロパティの追加] ボタンをクリックします。
[グローバルの追加] ウィザードが開きます。 - ウィザードで [グローバルの追加] から [WS-Policy バンク] を選択し、[終了] をクリックします。テスト ケース エクスプローラー ツリーに WSDL ポリシー ノードが表示されます ( [WS-Policy バンク] ブランチの下に追加されます。[WS-Policy バンク] ブランチがまだない場合は、ブランチが追加されます)。GUI の右側に WSDL ポリシーの設定パネルが表示され、SOAP client ツールにさまざまな WSDL-security テストが連結されます。
- [WSDL ポリシー] パネルで、以下のように設定を設定します。
- デフォルトの名前を変更したい場合は、[名前] フィールドに新しい名前を入力します。
- [WSDL URL] フィールドに、この Web サービスがアクセスできる WSDL URL を指定します。WSDL を入力するか、[参照] ボタンをクリックして指定します。
- 指定されたロケーション URL から WSDL をリフレッシュして再解析するには、[WSDL のリフレッシュ] をクリックします。
- [グローバル ポリシー] エリアで、非 XML 形式で表現されたポリシーの定義とともに、WSDL が示唆する代替ポリシーを確認します。左側のツリーの各セクションは、WSDL 内のグローバル ポリシー要素を表しています。