カスタム・セキュリティー・アルゴリズムの実装

/**
* ***************************************************************
* IBM Confidential
* 
* (c) Copyright IBM Corporation. 2008. All Rights Reserved.
* (C) Copyright IBM Japan 2007
* 
* このプログラムのソース・コードは、営業機密保護のため、
* アメリカ合衆国の著作権事務所に届け出済のものにかかわりなく、
* 公表されていません。
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * 以下の各メソッドは、次の両方のケースで使用することができます。
	 * ワークベンチ内での実行とテストの実行。
	 */
	
	
	/**
	 * トランスポートを介して送信される文書を処理するために呼び出されます。
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * サーバーから受信した文書を処理前の状態に戻すために呼び出されます。
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * CustomSecurityAlgorithm の UI で定義されたプロパティー。
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * 以下の各メソッドは、サービス・インターフェースのテストのためのキャストに関して、
	 * またはカスタム・セキュリティー・アルゴリズムが含まれた jar が Performance Test プロジェクトに
	 * デプロイされる場合の、前の XML 情報へのアクセスに関してしか使用できません。 この場合、
	 * このアルゴリズムをワークベンチから直接使用することはできません。
	 */
	
	/**
	 * このオブジェクトは、ITestExecutionService オブジェクトに一致します。
	 * このオブジェクトは、テストの実行にリンクする必要があるアルゴリズムのみに適用されます。
	 * このオブジェクトを使用する場合は、この実装が含まれた jar を
	 * JRE に直接ではなく、Performance Test プロジェクトにデプロイする必要があります。
	 * 
	 * 実行から受信された前の xml 文書が必要な場合は、 
	 * 以下を使用して値を取得できます。
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);

process メソッドでは、XML がサーバーに送信される前に XML が変更されます。

unprocess メソッドでは、XML がサーバーから受信された後に XML が変更されます。

setProperties メソッドでは、このカスタム・セキュリティー・インターフェース用のセキュリティー・エディター内で定義されたすべてのプロパティーが取得されます。

setExecutionContext メソッドは、テスト時に、このカスタム・セキュリティー・インターフェースを使用して、メッセージに対応する ITestExecutionServices オブジェクトによって呼び出されます。

• WSDL ベースの Web サービスをテストしている場合は、テスト・ナビゲーターまたはプロジェクト・エクスプローラー内の WSDL ファイルを右クリックして WSDL セキュリティー・エディターを開き、「セキュリティー・アルゴリズム」ページを選択します。次に、「選択されたセキュリティー・アルゴリズム・スタックの詳細」の下で、「追加」 > 「カスタム・セキュリティー・アルゴリズム」をクリックします。
• XML 呼び出しをテストしている場合は、テスト・エディター内の XML 呼び出しエレメントを開き、「ローカル XML セキュリティー」タブを選択した後、「追加」 > 「カスタム・セキュリティー・アルゴリズム」とクリックします。