Webサービスのテスト・クライアントを使用すると、次のことが可能です。
基本的な機能性のテストにより、Webサービスがデプロイされ、期待どおりに作動していることを確認。
基本的な認証のセキュリティのテスト。
Webサービス・アドレス、原子性トランザクション、SOAPメッセージ転送最適化メカニズム(MTOM)、Fast Infoset、Oracle Web Service Manager (OWSM)のセキュリティ・ポリシーなどの拡張機能のテスト。
注意:
接続プロトコルとしてSOAP over Java Messaging Service (JMS)トランスポートを使用するWebサービスでは、基本機能のみをテストできます。
適用可能な場合、WebサービスのWSDLおよびインポートされたスキーマの表示。
テスト・ケースのエクスポートおよびインポート。
セキュリティ・テストに使用するためのJava keystores (JKS)の構成。
環境に要求されるHTTPプロキシ設定の構成および使用。
次の項では、Webサービスのテスト・クライアントを使用する方法について説明します。
次の項で説明されているように、Webサービス・エンドポイントまたは管理コンソールを使用して、ブラウザからWebサービスのテスト・クライアントを起動します。
注意:
初めてWebサービスのテスト・クライアントを起動する場合、アプリケーションのデプロイの間にわずかなディレイが生じます。
接続プロトコルとしてSOAP over JMSトランスポートを使用するWebサービスをテストする場合は、Webサービスがデプロイされているサーバーからテスト・ページを起動する必要があります。
次のURLを入力すると、ブラウザからWebサービスのテスト・クライアントが起動します。
http://host:port/ws_utc
説明:
host
- WebLogic Serverが動作しているコンピュータの名前。
port
- WebLogic Serverがリスニングしているポート番号(デフォルト値は7001
です)。
プロンプトが表示されたら、Webサービスのテスト・クライアントのログイン資格証明を入力します。
Webサービスのテスト・クライアントのホーム・ページが起動します。WebサービスのWSDLを選択するには、5-3ページの「テストするWebサービスの選択」を参照してください。
Webサービス・エンドポイントへ移動して、Webサービスのテスト・クライアントを起動します。
Oracle Infrastructure Webサービスの場合、Webサービス・エンドポイントへ移動すると、Webサービスのテスト・クライアントが選択したWebサービスのWSDLとともに起動します。
JAX-WSおよびJAX-RPCのWebサービスの場合、中間ページが起動します。「テスト」をクリックすると、選択したWebサービスのWSDLとともにWebサービスのテスト・クライアントが起動します。
プロンプトが表示されたら、Webサービスのテスト・クライアントのログイン資格証明を入力します。
Webサービス操作をテストするには、5-4ページの「Webサービス操作のテスト」を参照してください。
管理コンソールを使用してデプロイされたWebサービスをテストするには、次の手順を実行します。
選択したWebサービスのWSDLとともにWebサービスのテスト・クライアントが起動します。Webサービス操作をテストするには、5-4ページの「Webサービス操作のテスト」を参照してください。
Webサービスのテスト・クライアントのホーム・ページから、テストするWebサービスに対応したWSDLを入力します。「別のWSDLを選択」を選択すると、いつでもこのページに戻ります。
テストするWebサービスを選択する手順は次のとおりです。
または、WSDLリストからロード済のWSDLを選択できます。「WSDLリストの表示」または「WSDLリストの非表示」をクリックして、リストを切り替えます。
テスト可能なWebサービス操作が表示されます。詳細は、5-4ページの「Webサービスの操作のテスト」を参照してください。
Webサービス操作をテストする手順は次のとおりです。
テスト結果セクションがコンテント・エリアの下部に表示され、SOAPリクエストおよびレスポンス・メッセージが表示されます。テストが失敗すると、「テスト結果」セクションにスタック・エラーが表示されます。
基本認証のユーザー名とパスワードを含むWebサービスのテスト・クライアントの基本設定を構成するには、「設定」セクションの基本設定タブをクリックして、表5-1で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。
表5-1 基本的なテスト・クライアント設定
設定 | 説明 |
---|---|
エンドポイントURL |
Webサービス・エンドポイント・アドレスをオーバーライドします。 |
ユーザー名 |
基本認証のテストに使用するユーザー名です。 注意: 5-11ページの「JKSキーストアの構成」の説明に従って、JKSキーストアを構成します。 |
パスワード |
基本認証のテストに使用するパスワードです。 注意: 5-11ページの「JKSキーストアの構成」の説明に従って、JKSキーストアを構成します。 |
エンコーディング |
エンコーディング規格です。有効な値には |
BindingType |
バインディング・タイプです。有効な値は次のとおりです。
|
HTTPプロキシ |
HTTPプロキシが有効かどうかを指定するフラグ。5-11ページの「HTTPプロキシの構成」の説明に従って、グローバルHTTPプロキシ設定を構成します。 注意: この設定は、開発モードでのみ使用できます。 |
Webサービスの拡張機能をテストするには、次の各項を参照してください。
注意:
接続プロトコルとしてSOAP over JMSトランスポートを使用するWebサービスでは、基本機能のみをテストできます。
WS-Addressingは、Webサービスおよびそれに関連するメッセージをアドレッシングするための、トランスポートに依存しないメカニズムを提供します。WS-Addressingを使用すると、エンドポイントはSOAPヘッダー内で一意かつ明確に定義されます。詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Webサービスのアドレシングの使用」を参照してください。
Webサービスで使用できる場合、WSアドレシングをテストするには、「設定」セクションの「アドレッシング」タブをクリックして、表5-2で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。
表5-2 WSアドレシングのテスト設定
設定 | 説明 |
---|---|
有効 |
WSアドレシングが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。 |
バージョン |
WSアドレシングのバージョンです。有効な値は次のとおりです。
|
ReplyTo |
|
FaultTo |
FaultToヘッダーのタイプです。有効な値には |
Webサービスは、次の仕様のサポートを通じて、Websphere、Microsoft .NETなどの他の外部トランザクション処理システムとの相互運用を可能にします。
Webサービスの原子性トランザクション(WS-AtomicTransaction)バージョン1.0、1.1、および1.2: http://docs.oasis-open.org/ws-tx/wstx-wsat-1.2-spec-cs-01/wstx-wsat-1.2-spec-cs-01.html
Webサービスのコーディネーション(WS-Coordination)バージョン1.0、1.1、および1.2: http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.2-spec-cs-01/wstx-wscoor-1.2-spec-cs-01.html
Webサービスの原子性トランザクションの詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のWebサービスの原子性トランザクションの使用に関する項を参照してください。
Webサービスで使用できる場合、原子性トランザクションをテストするには、「設定」セクションの「アトミック・トランザクション」タブをクリックして、表5-4で定義された値を設定し、「呼出し」をクリックしてWebサービスを起動します。
表5-3 原子性トランザクションのテスト設定
設定 | 説明 |
---|---|
有効 |
原子性トランザクションが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。 |
バージョン |
Webサービスのテスト・クライアントで使用されるWebサービス原子性トランザクションのコーディネーション・コンテキストのバージョンです。有効な値は、 |
トランザクション・フロー・タイプ |
Webサービス原子性トランザクションのコーディネーション・コンテキストがトランザクション・フローとともに渡されるかどうかを指定するフラグです。この値の設定に関する詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のWebサービスにおけるWebサービス原子性トランザクションの有効化を参照してください。 |
起動後のアクション |
起動後に必要なアクションです。有効な値にはトランザクションの |
SOAP MTOM/XOP (Message Transmission Optimization Mechanism/XML-binary Optimized Packaging)では、SOAPメッセージ内のxs:base64Binary
型またはxs:hexBinary
型のXMLデータの転送を最適化する方法が定義されています。トランスポート・プロトコルがHTTPの場合、Multipurpose Internet Mail Extension (MIME)添付ファイルを使用して、送信側と受信側の両方に対して同時にSOAPメッセージ内のXMLデータへの直接アクセスを許可する間にデータを伝達します。このとき、base64Binary
またはhexBinary
データのマーシャリングにMIMEアーティファクトが使用されていたことを意識する必要はありません。
MTOMの詳細は、次を参照してください。
JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』の「MTOM/XOPを使用したバイナリ・データ転送の最適化」を参照してください
Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のMTOMエンコード化メッセージ添付の使用に関する項。
Webサービスで使用できる場合、MTOMをテストするには、「設定」セクションの「MTOM」タブをクリックして、表5-5で定義された値を設定し、「呼出し」をクリックしてWebサービスを起動します。
表5-4 MTOMのテスト設定
設定 | 説明 |
---|---|
有効 |
MTOMがWebサービスのテスト・クライアントで有効かどうかを指定するフラグ。 |
しきい値 |
|
Fast Infosetは、テキストベースのXML形式よりも効率的にシリアライズできる、圧縮バイナリ・エンコーディング形式です。Fast Infosetの詳細は、次を参照してください。
JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Fast Infosetを使用したXMLの最適化」を参照してください。
Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項。
Webサービスで使用できる場合、Fast Infosetをテストするには、「設定」セクションの「Fast Infoset」タブをクリックして、表5-6で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。
表5-5 Fast Infosetのテスト設定
設定 | 説明 |
---|---|
有効 |
原子性トランザクションが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。 |
ネゴシエーション・タイプ |
ネゴシエーション戦略です。有効な値は次のとおりです。
コンテンツのネゴシエーション戦略の詳細は、次を参照してください。
|
OWSMセキュリティ・ポリシーをテストするには、「設定」セクションの「OWSM」タブをクリックして、表5-8で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。
注意:
Java EE Webサービスの場合、このタブはOWSMがインストールされている場合のみ使用できます。
使用できるのはOWSM事前定義済ポリシーの一部のみであり、これらのポリシー用に表示される属性のみが構成可能です。他のポリシー属性には、すべてポリシーのデフォルト値のみが使用されます。
したがって、事前定義済ポリシーから作成したコピーは使用できません。安全な会話の有効化やメッセージ・セキュリティ・アルゴリズム・スイートの変更などもできません。
表5-6 OWSMのテスト設定
設定 | 説明 |
---|---|
有効 |
OWSMポリシーが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。 |
ポリシー |
関連するチェック・ボックス列を選択して、クライアントにおいてテストするポリシーを選択します。セキュリティ・ポリシーのサブセットのみテストできます。 注意: 選択したポリシーに対して、次の必要なプロパティを構成する必要があります。それ以外の場合は、例外がスローされます。 |
ユーザー名 |
基本認証に使用するユーザー名です。 |
パスワード |
基本認証に使用するパスワードです。 |
キーストアの場所 |
キーストア・ファイルの場所。「ファイルの選択」をクリックして、ローカル・ディレクトリ内のファイルに移動します。ローカル・ディレクトリは通常、 |
リモート・キーストアの場所 |
リモート・キーストアの場所です。指定がない場合、サーバーに対してローカルなキーストアを使用します。 |
キーストア・パスワード |
キーストア・アクセスに使用するパスワードです。 |
暗号化キーの別名 |
サービスからのレスポンスの復号化に使用されるキーストア内のキーの別名。このプロパティはWSS11ポリシーでは使用されません。 |
暗号化キーのパスワード |
復号化に使用されるキーストア内のキーのパスワード。このプロパティはWSS11ポリシーでは使用されません。 |
署名鍵の別名 |
デジタル署名に使用されるキーストア内のキーの別名。WSS11ポリシーの場合、このプロパティは相互認証にのみ使用されます。 |
署名鍵のパスワード |
デジタル署名に使用されるキーストア内のキーの別名のパスワード。 |
受信者キーの別名 |
アウトバウンド・メッセージ・タイプの暗号化に使用される受信者の公開鍵の別名です。 |
SAMLオーディエンスのURI |
カンマ区切りのURIで表されたリライイング・パーティ。このプロパティではワイルドカードを使用できます。 |
SAML発行者名 |
SAMLメカニズムを使用して保護されているサービスにアクセスしようとする場合に使用するSAML発行者名。 |
ユーザー・ロールの組込み |
SAMLアサーションのユーザー・ロール。 |
マッピング属性のアテスト |
アテスト・エンティティの表現で使用されるマッピング属性。現在サポートされているのはDNのみです。この属性は、送信者保証メッセージ保護ユースケースにのみ適用されます。SAML over SSLポリシーには適用されません。 |
現在のWebサービスのWSDLを表示するには、「WSDL」をクリックします。
インポートされたWSDLおよびスキーマを表示するために、インポートされたWSDLおよびスキーマをクリックします。ダイアログ・ボックスで、表示するインポートされたファイルをクリックします。右上隅のxをクリックして、ダイアログ・ボックスを閉じます。
注意:
構成設定は、開発モードでのみ使用できます。
次の項で説明されているように、HTTPプロキシの定義、デフォルトの作業ディレクトリの設定、またはJavaキーストア(JKS)の定義によって、Webサービスのテスト・クライアントを構成します。
Webサービスのテスト・クライアントのHTTPプロキシを、一般設定ページで構成します。
HTTPプロキシの構成方法:
Webサービスのテスト・クライアント・セキュリティ・ページでテストするOWSMセキュリティ・ポリシーに関連するJKSキーストアを構成します。
WebLogicサーバーにおけるJKSキーストアの定義の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「WebLogicサーバーにおけるJKSキーストアの構成方法」を参照してください。
Javaキーストア(JKS)の構成方法:
Webサービスのテスト・クライアントの右上隅のをクリックします。
ナビゲーション・ペインで、セキュリティをクリックします。
新規JKSキーストアの追加方法:
「追加」をクリックします。
設定名フィールドに、JKSキーストアの名前を入力します。
キーストア・パスワード・フィールドに、JKSキーストアのパスワードを入力します。
注意:
製品環境が推奨されていないJKSキーストアのパスワードを定義します。
キーストア・ファイルフィールドにファイルへのパスを入力するか、ファイルの選択をクリックして、ローカル・ディレクトリにファイルを移動します。
「発行」をクリックします。
既存のJKSキーストアの編集または削除方法:
「編集」をクリックします。
をクリックして、JKSキーストアを削除します。
をクリックし、フィールドを編集し、編集の発行をクリックして、JKSキーストアを編集します。
編集の取消をクリックして、編集モードを終了します。
入力引数は、ユーザーにわかりやすい形式で表示できます。また、XMLソース・コードを直接編集できます。XMLソースを直接編集する場合は、有効なXMLを入力する必要があります。入力引数をXMLソースとして表示するために、未処理メッセージをクリックします。ユーザー・フレンドリなフォームに切り替えるために、フォーム入力をクリックします。
注意:
イノベーション履歴ペインは、最初のテスト操作の起動後にのみ表示され、開発モードでのみ利用可能です。
イノベーション履歴ペインの操作のクリックによって、現在のセッションに、以前に実行したテストの結果を表示できます。テストの失敗例は、イノベーション履歴ペインに赤で表示されます。
注意:
この機能は開発モードでのみ使用できます。
次の各項の説明に従って、個別のテストケースをWebサービスのテスト・クライアントからエクスポートして、その後、他のテスト環境にインポートできます。
Webサービスのテスト・クライアントの右上隅のをクリックして、テスト・ケースをエクスポートします。テスト・ケースは、
ws-testcase.xml
のファイル名で、XMLファイルとして保存されます。複数のテスト・ケースを保存する場合、ws-testcase(
n
).xml
のようにファイル名に拡張子が追加されます(n
は、新しいテスト・ケースが保存されるたびに増えます)。
開発環境では、デフォルトで、Webサービスのテスト・クライアントは有効です。本番環境では、デフォルトで、Webサービスのテスト・クライアントは無効(かつアンデプロイ済)です。
Webサービスのテスト・クライアント・ポリシーを有効または無効にするには、次の手順のうちの1つを実行します。
次で説明されているように、管理コンソールを使用します。
4-25ページの「WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化」で説明されているように、Fusion Middleware ControlをドメインまたはWebサービス・エンドポイント・レベルで使用します。
4-58ページの「WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化」で説明されているように、WLSTを使用します。
Webサービスのテスト・クライアントを無効にすると、Webサービスを公開するアプリケーションについて外部から参照できる詳細が少なくなり、セキュリティが向上します。
注意:
本番モードではWebサービスのテスト・クライアントを有効にしないことをお薦めします。本番モードの詳細は、in 『Oracle WebLogic Serverドメイン構成の理解』の「ドメイン・モード」を参照してください。
管理コンソールを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化方法: