このセクションの内容:

はじめに

SMTP Listener は、Parasoft Virtualize 用のカスタム メッセージ リスナー拡張です。SMTP Listener は一時的な SMTP サーバーを立ち上げ、メッセージごとに Virtualize に通知を行い、受信メッセージを受け入れまたはカスタム拒否メッセージとともに拒否したり、必要に応じて検証や後処理を行うことを可能にします。

インストール

このツールは UI またはコマンドラインからインストールできます。

UI からのインストール

  1. [Parasoft ] > [設定] を選択し、[システム プロパティ] をクリックします。
  2. [JAR の追加] をクリックし、com.virtualize.listener.smtp-<VERSION>.jar を選択します。
  3. [適用] をクリックします。
  4. Virtualize を再起動します。

コマンド ラインからのインストール

設定プロパティ ファイルの system.properties.classpath プロパティに com.parasoft.virtualize.listener.smtp-<VERSION>.jar ファイルを追加します。例:

system.properties.classpath=<PATH_TO_JAR>/com.parasoft.virtualize.listener.smtp-1.1.0.jar

使用方法

仮想アセットの設定パネルでリスナーを選択し、設定を行います。

  1. Virtualize サーバー ビューで、カスタム メッセージ リスナーを使用したい仮想アセットを選択します。
  2. 仮想アセットのデプロイメント設定で、[トランスポート] > [カスタム] を選択します。複数のリスナーがインストールされている場合、まず [実装の選択] メニューから SMTP リスナーを選択します。
  3. 接続およびセキュリティの設定を行います (「Configuration」を参照)。
     
  4. 変更を保存します。

メッセージ

SMTP リスナーは、受信するメールごとに、応答者に対して 3 つのリクエスト メッセージを作成します。

1 つ目: メールの送信者を詳細に記述した XML ドキュメント。これにより、メールの送信者に基づいて応答者を簡単に設定できます。例:

<SMTP>
 <From>[email protected]</From>
</SMTP>

2 つ目: メールの受信者を詳述する XML ドキュメント。これにより、メールの受信者に基づいて応答者を簡単に設定できます。例:

<SMTP>
 <Recipients>
  <Recipient>[email protected]</Recipient>
 </Recipients>
</SMTP>

3 つ目: 完全なメール。例:

Received: from hostname (localhost [127.0.0.1])
        by hostname
        with SMTP (SubEthaSMTP null) id M4LMIVYQ
        for [email protected];
        Thu, 12 Dec 2024 09:[MASKED]9:22 -0800 (PST)
From: [email protected]
To: [email protected]
Message-ID: <1[MASKED]1973616[MASKED].0.1734026361923.JavaMail.hostname>
Content-Transfer-Encoding: 7bit
Subject: Testing Subject
MIME-Version: 1.0
Content-Type: text/html; charset=us-ascii



This is a Text Message.

レスポンダーはどのステップでも応答を返すことができます。レスポンスはクライアントに返されるエラー メッセージとして扱われ、テキスト メッセージ、エラー コードとテキスト メッセージ、またはエラー コードのみになります。

エラー メッセージの例:

Transaction failed 

コード付きのエラー メッセージ:

450: The requested mail action was not taken because the mailbox is unavailable

設定

受信メッセージを受け入れるには、SMTP リスナーにペイロードが空の Literal Message Responder を設定する必要があります。

リスナー設定については下記を参照してください。

Connection 設定

ホスト名

SMTP サーバーのホスト名を指定します。空の場合、システムのデフォルトのホスト名が使用されます。

ポートSMTP サーバーのポートを指定します。空の場合、リスナーは開始されません。

セキュリティ設定

User Properties File

ユーザー名とパスワードの組み合わせを定義するのに使用するプロパティ ファイルへの絶対パスを指定します。パスワードはプレーン テキストで保存されます。プロパティ ファイルは次のフォーマットを使用する必要があります。

<username>=<password>

このフィールドが空の場合、ユーザー認証は無効になります。

Enable Transport Layer Security

トランスポート層のセキュリティを有効/無効にします。true を設定すると、サーバーへのすべての接続が暗号化されます。TLS を有効にするには、Key Store および Trust Store を適切に設定する必要があります。デフォルトは false です。

Key Store File

キーストア ファイルへのパスを指定します。キーストア ファイルは標準フォーマット (JKS、PKCS12 など) でなければなりません。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.keyStore が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Key Store Type

[Key Store File] オプションで設定されたキーストアのタイプを指定します。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.keyStoreType が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Key Store Password

[Key Store File] オプションで設定されたキーストアのパスワードを指定します。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.keyStorePassword が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Enable Client Authentication

TLS が有効なとき、クライアント認証を有効/無効にします。true を設定すると、すべての接続でサーバーがクライアントの証明書を認証する必要があります。Trust Store File オプションで、クライアント証明書が「信頼された」証明書として適切に設定されている必要があります。デフォルトは false です。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Trust Store File

クライアント証明書が真正であること (「トラスト」)を検証するのに使用されるキーストア ファイルへの絶対パスを指定します。キーストア ファイルは標準フォーマット (JKS、PKCS12 など) でなければなりません。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.trustStore が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Trust Store Type

[Trust Store File] オプションで設定されたキーストアのタイプを指定します。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.trustStoreType が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

Trust Store Password

[Trust Store File ] オプションで設定されたキーストアのパスワードを指定します。TLS が有効化されているが、この値が指定されていない場合、JVM のシステム プロパティ javax.net.ssl.trustStorePassword が使用されます。

このプロパティが効力を持つには、TLS が有効化されている必要があります。

変更ログ

1.2.1

1.0