Generic Service Client では、サービス呼び出しにコンテンツおよび呼び出しのトランスポート情報が含まれます。 内容は、SOAP エンベロープから構成されます。
トランスポート情報は、選択したプロトコルに応じて、送信/受信および応答に必要な情報を参照します。
メッセージ
このページには、要求の XML コンテンツが表示されます。このページから、データ相関にアクセスできます。同じ 1 つのコンテンツが、3 つの異なる形式で示されます。
- フォーム
- このビューは、XML コンテンツの値の編集に重点を置き、メッセージ
を簡略化して表示します。
- ツリー
このビューは、メッセージの XML 構造の階層を表示します。この表示には、エレメント、名前空間、関連付けられた値が含まれます。ツリー内の XML エレメントと名前空間は、「追加」、「挿入」、「除去」、「上へ」、および「下へ」を使用して編集できます。
必要に応じて名前空間、属性、またはテキスト・ノードの表示と非表示を切り替えるには、「フィルター」をクリックします。
「有効な変更のみを許可」をクリックして、指定された XML スキーマ文書 (XSD) に基づいてスマート編集を使用可能にすることができます。
ワークベンチ用の一連の XSD 文書を指定するには、テスト・ナビゲーターでプロジェクトを右クリックして、「プロパティー」および「スキーマ・カタログ」を選択します。
XSD がない場合、またはスキーマを使用しない場合は、「有効な変更のみを許可」を使用不可にします。
XML エレメントを右クリックして、XML フラグメントに
変換することができます。これを行うと、値に対してではなく XML フラグメント全体に対してデータ相関 (データプールの使用と参照の作成) を実行できます。
- ソース
- このビューには、メッセージのソース XML コンテンツまたはプレーン・テキス
ト・コンテンツが表示されます。
重要: 「ソース」ビューでは、SoaTag で始まるタグは編集しないでください。これらのタグを削除または変更すると、テスト内の参照と置換が壊れてしまいます。これらのタグは、削除した後は再作成できません。
添付
このページには、要求に付加される MIME 添付がリストされます。
このビューの内容は、Multipurpose Internet Mail Extensions (MIME) の仕様に対応します。
このページを使用すると、ワークベンチ・リソースを MIME 添付として追加することや、
プロパティーの変更を行うことができます。
注: Web サービス添付を使用するには、ワークベンチで使用する Java™ ランタイム環境 (JRE) に、一連の Java ライブラリーを追加する必要があります。
詳しくは、
添付ファイルの処理環境の構成を参照してください。
「コンテンツ ID」は、添付を参照するために要求で使用される ID です。
この ID を使用する方法は、サーバーの要件に応じて異なります。
- MTOM 伝送メカニズムの使用
- デフォルトで、要求は SOAP Messages with Attachments (SwA) を使用して添付を処理します。
SOAP Message Transmission Optimization Mechanism (MTOM) で添付を処理するには、このオプションを選択します。
トランスポート
このページでは、要求を送信する際に使用するトランスポート設定を取り扱います。
トランスポート・プロトコル設定はトランスポート構成に適用され、HTTP、Java Message Service (JMS)、WebSphere® MQ のいずれかとなります。プロトコルまたはプロトコルのバリアントを簡単に切り換えることができるように、プロトコルごとに複数の構成を作成できます。
- HTTP
- 要求に HTTP トランスポートを使用する場合は、「HTTP」を選択します。
URL または SOAP アクション、およびテストのグローバル構成への参照を要求レベルで更新できます。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。HTTP トランスポート構成には、再利用可能なプロキシーおよび認証設定が含まれています。
- メソッドおよびバージョン
- サービス要求を呼び出すために使用する HTTP メソッドおよびバージョンを指定します。
- URL
- サービス要求の URL エンドポイントを指定します。
- ヘッダー
- サービスで必要なカスタム HTTP ヘッダーの名前および値を指定します。「追加」、「編集」、または「除去」をクリックして、ヘッダー・リストを変更します。
- Cookie
- サービスで必要な Cookie の名前および値を指定します。「追加」、「編集」、または「除去」をクリックして、Cookie リストを変更します。
- JMS
要求に Java Message Service トランスポートを使用する場合は、「JMS」を選択します。
このページでは、JMS 構成に対する要求に添付するストリング・プロパティーを追加できます。
これらは、メッセージ・プロパティーとして JMS 経由で送信されます。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。JMS トランスポート構成には、再利用可能な汎用エンドポイント、受信ポイント、およびアダプター設定が含まれています。
- プロパティー
- 現在の JMS トランスポート構成に対する要求で必要なストリング・プロパティーの名前および値を指定します。
これらは、メッセージ・プロパティーとして JMS を介して送信されます。「追加」、「編集」、または「除去」をクリックして、プロパティー・リストを変更します。
- WebSphere MQ
- 要求に IBM® WebSphere MQ トランスポートを使用する場合は、「MQ」を選択します。
このページを使用すれば、SOAP アクションを指定して、テスト・レベルで選択した WebSphere MQ の構成設定をオーバーライドすることができます。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。MQ トランスポート構成には、再利用可能な汎用キュー、ヘッダー、および SSL 設定が含まれています。
- SOAP アクション
- MQ 要求を呼び出すために使用する SOAP アクションを指定します。
- MQ プロトコル構成値のオーバーライド
- MQ メッセージのフィールドを構成する場合に、このオプションを選択します。
MQ メッセージ記述子のサブセットは、他のサーバー・タイプとともに使用するカスタム形式に置き換えることができます (特に XML メッセージ要求を使用する場合)。
メッセージ記述子について詳しくは、WebSphere MQ の資料を参照してください。これらの設定は、MQ プロトコル構成のメッセージ記述子およびヘッダー設定を置き換えます。
- カスタム・ヘッダーの使用
- WebSphere MQ で提供される SOAP over MQ フィーチャー用のトランスポートのカスタム・ヘッダーを指定する場合に、このオプションを選択します。
この機能では、あらかじめ設定された MQ メッセージ形式 (RFH2) が使用されるため、これを選択した場合は、他の「メッセージ記述子」の各オプションは使用不可になります。
要求のセキュリティー
セキュリティー・プロトコルが送信前のサービス要求に適用するセキュリティー・アルゴリズム・スタックを編集するには、このページを使用します。
セキュリティー・スタックは、指定の順序で実行される一連のアルゴリズムです。
- WSDL セキュリティー・エディター設定のオーバーライド
- デフォルトでは、特定の WSDL ファイルに付加されるセキュリティー・アルゴリズム・スタックは、WSDL セキュリティー・エディターで編集します。現在のサービス要求だけを対象として別のセキュリティー・アルゴリズム・スタックを指定するには、このオプションを選択します。
- セキュリティー・アルゴリズムの詳細 (Security Algorithm Details)
- スタック内のセキュリティー・アルゴリズムを追加または除去するには、
「追加」、「挿入」、または「除去」をクリックします。
セキュリティー・スタック内で選択したアルゴリズムの順序を変更するには、
「上へ」と「下へ」をクリックします。
セキュリティー・スタックに追加できるセキュリティー・アルゴリズムを以下に示します。
- タイム・スタンプ
- タイム・スタンプ・セキュリティー・アルゴリズムは、応答内の XML 文書にタイム・スタンプ情報を追加します。
セキュリティー・アルゴリズムの詳細については、Web サービス・セキュリティーの仕様を参照してください。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを選択します。
- タイム・スタンプ
- タイム・スタンプを追加するまでの遅延を指定します。
- ユーザー名トークン
- ユーザー名トークン・セキュリティー・アルゴリズムは、応答内の XML 文書にユーザー名トークンを追加します。
セキュリティー・アルゴリズムの詳細については、Web サービス・セキュリティーの仕様を参照してください。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを選択します。
- 名前
- ユーザーの名前を入力します。
- パスワード
- ユーザーのパスワードを入力します。
- パスワード・タイプ
- セキュリティー・アルゴリズムのパスワード・タイプを指定します。
- XML 暗号化
- XML 暗号化セキュリティー・アルゴリズム。XML 文書の暗号化の方法を指定します。
セキュリティー・アルゴリズムの詳細については、Web サービス・セキュリティーの仕様を参照してください。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを選択します。
- ID タイプ
- 暗号化で使用する鍵 ID のタイプを以下から選択します。
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- ユーザー XPath パーツ選択
- これにより、XML 文書の一部を記述した XPath 照会を指定し、それをアルゴリズムのサブジェクトにすることができます。
デフォルトでは、本文がサブジェクトです。
- キー
- 暗号化に使用する鍵を選択します。各鍵の詳細は、それぞれ異なります。
- x509 キー: x509 キーの名前とパスワード、およびそれを配置するキー・ストアを指定します。
- 未処理のキー: 鍵の名前とバイト値を 16 進数で指定します。
- ユーザー名トークン・キー: トークンのユーザー名とパスワードを指定します。
- 暗号化キー: セキュリティー・スタックで以前に定義された暗号化キーを指定します。
新規の暗号化キー定義ブロックを作成するには、「新規暗号化キーの挿入」をクリックします。
- キーのエンコード・アルゴリズム
- トランスポート・キーをエンコードするための標準アルゴリズムを指定します。
- XML Signature
- XML シグニチャー・セキュリティー・アルゴリズム。XML 文書の署名方法を指定します。
セキュリティー・アルゴリズムの詳細については、Web サービス・セキュリティーの仕様を参照してください。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを指定します。
- ID タイプ
- 暗号化で使用する鍵 ID のタイプを以下から選択します。
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- KEY_VALUE
- USER_NAME_TOKEN
- CUSTOM_SYMM_SIGNATURE
- ユーザー XPath パーツ選択
- XML 文書の一部を記述した XPart 照会を指定します。これはアルゴリズムのサブジェクトにすることができます。
デフォルトでは、本文がサブジェクトです。
- キー
- 暗号化に使用する鍵を選択します。各鍵の詳細は、それぞれ異なります。
- x509 キー: x509 キーの名前とパスワード、およびそれを配置するキー・ストアを指定します。
- 未処理のキー: 鍵の名前とバイト値を 16 進数で指定します。
- ユーザー名トークン・キー: トークンのユーザー名とパスワードを指定します。
- 暗号化キー: セキュリティー・スタックで以前に定義された暗号化キーを指定します。
新規の暗号化キー定義ブロックを作成するには、「新規暗号化キーの挿入」をクリックします。
- シグニチャー・アルゴリズム名
- シグニチャーに対して使用する標準アルゴリズムを指定します。
- 正規化
- 正規化に使用するアルゴリズムを指定します。
- 暗号化キー
- このブロックは、XML シグニチャーまたは XML 暗号化ブロックで使用可能な暗号化キーを定義します。
暗号化キー・ブロックは、その暗号化キーを使用するブロックの前にある必要があります。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを指定します。
- キー名
- 暗号化キーの名前を指定します。
- ID タイプ
- 暗号化で使用する鍵 ID のタイプを以下から選択します。
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- キー・サイズ
- キーのサイズをビット単位で指定します。
- キーのエンコード・アルゴリズム名
- キーのエンコードに使用するアルゴリズムを指定します。
- キー・ストア
- 新規のキー・ストアを定義するか、既存のキー・ストアを管理するには、キー・ストアを選択するか、「セキュリティーの編集」をクリックします。
- 名前
- 指定のキー・ストアに含まれているキーを選択します。
- パスワード
- 選択したキー名のパスワードを入力します。
- カスタム・セキュリティー・アルゴリズム
- Java クラスをカスタム・セキュリティー・アルゴリズムとして実装している場合には、このスタック・エレメントを使用して、カスタム・アルゴリズムをサービスに適用します。
- 名前
- カスタム・セキュリティー・アルゴリズムの名前を指定します。
- 実装クラス
- カスタム・セキュリティー・アルゴリズムを実装するクラスの名前を指定します。
「参照」をクリックして、ワークスペースから Java クラスを選択します。
- プロパティー
- このテーブルを使用して、特定のプロパティーおよび関連付けられた値をカスタム・セキュリティー・アルゴリズムに送信します。
- WS-Addressing アルゴリズム
- サービスで WS-Addressing 2004/08 標準か WS-Addressing 1.0 Core 標準を使用する場合は、このスタックを追加します。
- 名前空間
- WS-Addressing 2004/08 か WS-Addressing 1.0 Core の名前空間を指定します。
- 要求で WS-Addressing が使用されている場合のアクション
- 要求内に既に WS-Addressing がある場合は、実行するアクションを選択します。
- ReplyTo 内の匿名アドレスを次に置換:
- 匿名アドレスの代わりに、指定のアドレスを ReplyTo ヘッダー内に生成するには、このオプションを選択します。
- 応答から WS-Addressing を除去
- 応答からすべての WS-Addressing ヘッダーを取り除くには、このオプションを選択します。
応答のセキュリティー
セキュリティー・プロトコルが受信後の応答に適用するセキュリティー・アルゴリズム・スタックを編集するには、このページを使用します。
セキュリティー・スタックは、指定の順序で実行される一連のアルゴリズムです。
- WSDL セキュリティー・エディターのオーバーライド
- デフォルトでは、特定の WSDL ファイルに付加されるセキュリティー・アルゴリズム・スタックは、WSDL セキュリティー・エディターで編集します。現在の応答だけを対象として別のセキュリティー・アルゴリズム・スタックを指定するには、このオプションを選択します。
- セキュリティー・アルゴリズムの詳細 (Security Algorithm Details)
- スタック内のセキュリティー・アルゴリズムを追加または除去するには、
「追加」、「挿入」、または「除去」をクリックします。
セキュリティー・スタック内で選択したアルゴリズムの順序を変更するには、
「上へ」と「下へ」をクリックします。
セキュリティー・スタックに追加できるセキュリティー・アルゴリズムを以下に示します。
- XML 暗号化
- XML 暗号化セキュリティー・アルゴリズム。XML 文書の暗号化の方法を指定します。
セキュリティー・アルゴリズムの詳細については、Web サービス・セキュリティーの仕様を参照してください。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを選択します。
- ID タイプ
- 暗号化で使用する鍵 ID のタイプを以下から選択します。
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- ユーザー XPath パーツ選択
- これにより、XML 文書の一部を記述した XPath 照会を指定し、それをアルゴリズムのサブジェクトにすることができます。
デフォルトでは、本文がサブジェクトです。
- キー
- 暗号化に使用する鍵を選択します。各鍵の詳細は、それぞれ異なります。
- x509 キー: x509 キーの名前とパスワード、およびそれを配置するキー・ストアを指定します。
- 未処理のキー: 鍵の名前とバイト値を 16 進数で指定します。
- ユーザー名トークン・キー: トークンのユーザー名とパスワードを指定します。
- 暗号化キー: セキュリティー・スタックで以前に定義された暗号化キーを指定します。
新規の暗号化キー定義ブロックを作成するには、「新規暗号化キーの挿入」をクリックします。
- キーのエンコード・アルゴリズム
- トランスポート・キーをエンコードするための標準アルゴリズムを指定します。
- 暗号化キー
- このブロックは、XML シグニチャーまたは XML 暗号化ブロックで使用可能な暗号化キーを定義します。
暗号化キー・ブロックは、その暗号化キーを使用するブロックの前にある必要があります。
- アクター/ロール名
- アクターの名前を必要に応じて指定します。
- 理解する必要あり
- セキュリティー・アルゴリズムの理解が必要であるかどうかを指定します。
- キー名
- 暗号化キーの名前を指定します。
- ID タイプ
- 暗号化で使用する鍵 ID のタイプを以下から選択します。
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- キー・サイズ
- キーのサイズをビット単位で指定します。
- キーのエンコード・アルゴリズム名
- キーのエンコードに使用するアルゴリズムを指定します。
- キー・ストア
- 新規のキー・ストアを定義するか、既存のキー・ストアを管理するには、キー・ストアを選択するか、「セキュリティーの編集」をクリックします。
- 名前
- 指定のキー・ストアに含まれているキーを選択します。
- パスワード
- 選択したキー名のパスワードを入力します。
- カスタム・セキュリティー・アルゴリズム
- Java クラスをカスタム・セキュリティー・アルゴリズムとして実装している場合には、このスタック・エレメントを使用して、カスタム・アルゴリズムをサービスに適用します。
- 名前
- カスタム・セキュリティー・アルゴリズムの名前を指定します。
- 実装クラス
- カスタム・セキュリティー・アルゴリズムを実装するクラスの名前を指定します。
「参照」をクリックして、ワークスペースから Java クラスを選択します。
- プロパティー
- このテーブルを使用して、特定のプロパティーおよび関連付けられた値をカスタム・セキュリティー・アルゴリズムに送信します。