Generic Service Client では、サービス呼び出しにコンテンツおよび呼び出しのトランスポート情報が含まれます。 内容は、SOAP エンベロープから構成されます。
トランスポート情報は、選択したプロトコルに応じて、送信/受信および応答に必要な情報を参照します。
メッセージ
このページには、要求の XML コンテンツが表示されます。このページから、データ相関にアクセスできます。同じ 1 つのコンテンツが、3 つの異なる形式で示されます。
- フォーム
- このビューは、XML コンテンツの値の編集に重点を置き、メッセージ
を簡略化して表示します。
- ツリー
このビューは、メッセージの XML 構造の階層を表示します。この表示には、エレメント、名前空間、関連付けられた値が含まれます。ツリー内の XML エレメントと名前空間は、「追加」、「挿入」、「除去」、「上へ」、および「下へ」を使用して編集できます。
必要に応じて名前空間、属性、またはテキスト・ノードの表示と非表示を切り替えるには、「フィルター」をクリックします。
「有効な変更のみを許可」をクリックして、指定された XML スキーマ文書 (XSD) に基づいてスマート編集を使用可能にすることができます。
ワークベンチ用の一連の XSD 文書を指定するには、テスト・ナビゲーターでプロジェクトを右クリックして、「プロパティー」および「スキーマ・カタログ」を選択します。
XSD がない場合、またはスキーマを使用しない場合は、「有効な変更のみを許可」を使用不可にします。
XML エレメントを右クリックして、XML フラグメントに
変換することができます。これを行うと、値に対してではなく XML フラグメント全体に対してデータ相関 (データプールの使用と参照の作成) を実行できます。
- ソース
- このビューには、メッセージのソース XML コンテンツまたはプレーン・テキス
ト・コンテンツが表示されます。
重要: 「ソース」ビューでは、SoaTag で始まるタグは編集しないでください。これらのタグを削除または変更すると、テスト内の参照と置換が壊れてしまいます。これらのタグは、削除した後は再作成できません。
添付
このページには、要求に付加される MIME または DIME 添付がリストされます。
このビューの内容は、Multipurpose Internet Mail Extensions (MIME) 仕様または Direct Internet Message Encapsulation (DIME) 仕様に準拠します。
このページを使用すると、ワークベンチ・リソースを MIME または DIME 添付として追加することや、
プロパティーの変更を行うことができます。
「コンテンツ ID」は、添付を参照するために要求で使用される ID です。
この ID を使用する方法は、サーバーの要件に応じて異なります。
- MIME または DIME
- 添付が準拠する仕様を、Multipurpose Internet Mail Extensions (MIME) にするか Direct Internet Message Encapsulation (DIME) にするかを選択します。
- MTOM 伝送メカニズムの使用
- デフォルトで、要求は SOAP Messages with Attachments (SwA) を使用して添付を処理します。
SOAP Message Transmission Optimization Mechanism (MTOM) で添付を処理するには、このオプションを選択します。
トランスポート
このページでは、要求を送信する際に使用するトランスポート設定を取り扱います。
トランスポート・プロトコル設定はトランスポート構成に適用され、HTTP、Java Message Service (JMS)、WebSphere® MQ のいずれかとなります。プロトコルまたはプロトコルのバリアントを簡単に切り換えることができるように、プロトコルごとに複数の構成を作成できます。
注: IBM Rational AppScan を使用している場合は、JMS および WebSphere MQ のトランスポート構成は使用できません。
- HTTP
- 要求に HTTP トランスポートを使用する場合は、「HTTP」を選択します。
URL または SOAP アクション、およびテストのグローバル構成への参照を要求レベルで更新できます。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。HTTP トランスポート構成には、再利用可能なプロキシーおよび認証設定が含まれています。
- URL
- サービス要求の URL エンドポイントを指定します。
- メソッドおよびバージョン
- サービス要求を呼び出すために使用する HTTP メソッドおよびバージョンを指定します。
- ヘッダー
- サービスで必要なカスタム HTTP ヘッダーの名前および値を指定します。「追加」、「編集」、または「除去」をクリックして、ヘッダー・リストを変更します。
- Cookie
- サービスで必要な Cookie の名前および値を指定します。「追加」、「編集」、または「除去」をクリックして、Cookie リストを変更します。
- JMS
要求に Java Message Service トランスポートを使用する場合は、「JMS」を選択します。
このページでは、JMS 構成に対する要求に添付するストリング・プロパティーを追加できます。
これらは、メッセージ・プロパティーとして JMS 経由で送信されます。
注: IBM® Rational® Appscan を使用している場合、このオプションは使用不可です。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。JMS トランスポート構成には、再利用可能な汎用エンドポイント、受信ポイント、およびアダプター設定が含まれています。
- プロパティー
- 現在の JMS トランスポート構成に対する要求で必要なストリング・プロパティーの名前および値を指定します。
これらは、メッセージ・プロパティーとして JMS を介して送信されます。「追加」、「編集」、または「除去」をクリックして、プロパティー・リストを変更します。
- WebSphere MQ
- 要求に IBM WebSphere MQ トランスポートを使用する場合は、「MQ」を選択します。
このページを使用すれば、SOAP アクションを指定して、テスト・レベルで選択した WebSphere MQ の構成設定をオーバーライドすることができます。
注: IBM Rational Appscan を使用している場合、このオプションは使用不可です。
- プロトコル構成
- 「変更」をクリックして、定義済みトランスポート構成を指定するか、構成を作成します。WebSphere MQ トランスポート構成には、再利用可能な汎用キュー、ヘッダー、および SSL 設定が含まれています。
- SOAP アクション
- WebSphere MQ 要求を呼び出すために使用する SOAP アクションを指定します。
- MQ プロトコル構成値のオーバーライド
- WebSphere MQ メッセージのフィールドを構成する場合に、このオプションを選択します。
MQ メッセージ記述子のサブセットは、他のサーバー・タイプとともに使用するカスタム形式に置き換えることができます (特に XML メッセージ要求を使用する場合)。
- メッセージ・ヘッダーのカスタマイズ
- WebSphere MQ で提供される SOAP over MQ フィーチャー用のトランスポートのカスタム・ヘッダーを指定する場合に、このオプションを選択します。
この機能では、あらかじめ設定された MQ メッセージ形式 (RFH2) が使用されるため、これを選択した場合は、他の「メッセージ記述子」の各オプションは使用不可になります。
- メッセージ記述子
- これらの設定は、MQ プロトコル構成のメッセージ記述子およびヘッダー設定を置き換えます。メッセージ記述子については、WebSphere MQ 資料を参照してください。
要求スタック
送信前のサービス要求にセキュリティーおよびアドレッシングのパラメーターを適用するスタックを指定するには、このページを使用します。
スタックは、指定の順序で実行される一連のアルゴリズムです。各 WSDL にスタックを定義するには、WSDL セキュリティー・エディターを使用します。スタックは、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 プロジェクト
- カスタム Java クラスを実装していない場合は、「Java プロジェクト」を選択し、新しいプロジェクトの名前を入力して、「生成」をクリックすると、カスタム・セキュリティー実装の新しい 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 ヘッダーを取り除くには、このオプションを選択します。
- WS-Policy アルゴリズム
- WS-Policy 仕様に準拠するセキュリティー・ポリシー・ファイルをサービスが使用している場合は、このスタックを追加します。
- WSDL に含まれているポリシーを使用 (WS-PolicyAttachment)
- WS-PolicyAttachment 仕様に記載されているように、WSDL に添付されているセキュリティー・ポリシー構成を使用するには、このオプションを選択します。
- ポリシー
- WS-PolicyAttachment 仕様を使用していない場合に、XML ポリシー・ファイルを指定します。「参照」をクリックして、ワークスペースからポリシー・ファイルを追加するか、ポリシー・ファイルをインポートします。
- シグニチャーの構成
- ポリシーに指定されている署名がある場合に、それに対する鍵ストアを指定するには、このオプションを選択します。「セキュリティーの編集」をクリックして、ワークスペースから鍵ストアを追加するか、鍵ストアをインポートします。
- 暗号化の構成
- ポリシーに指定されている暗号化がある場合に、それに対する鍵ストアを指定するには、このオプションを選択します。「セキュリティーの編集」をクリックして、ワークスペースから鍵ストアを追加するか、鍵ストアをインポートします。
- 復号の構成
- ポリシーに指定されている復号がある場合に、それに対する鍵ストアを指定するには、このオプションを選択します。「セキュリティーの編集」をクリックして、ワークスペースから鍵ストアを追加するか、鍵ストアをインポートします。
- セキュリティー・トークン・サーバーからトークンを取得 (WS-Trust)
- ポリシーで使用するセキュリティー・トークン・サーバー (STS) を指定するには、このオプションを選択して「構成」をクリックします。
- 追加プロパティー
- このテーブルを使用して、WS-Security 仕様の拡張プロパティーまたは特定の実装の設定を指定します。「追加」をクリックし、プロパティー名を追加して値を設定します。
応答スタック
受信後の応答にセキュリティーおよびアドレッシングのパラメーターを適用するスタックを指定するには、このページを使用します。
スタックは、指定の順序で実行される一連のアルゴリズムです。各 WSDL にスタックを定義するには、WSDL セキュリティー・エディターを使用します。スタックは、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 クラスを選択します。
- プロパティー
- このテーブルを使用して、特定のプロパティーおよび関連付けられた値をカスタム・セキュリティー・アルゴリズムに送信します。