Send Email アサーション

Send Email アサーションを使用すると、ポリシーでアサーションが出現するたびに事前設定済みの電子メール メッセージを送信するように Gateway に指示できます。
gateway94
Send Email
アサーションを使用すると、ポリシーでアサーションが出現するたびに事前設定済みの電子メール メッセージを送信するように Gateway に指示できます。
ポリシー パス内のアサーションの配置により、電子メールが送信されるタイミングおよび理由が決まります。 たとえば、Evaluate Response XPath アサーションの後に、「At least one assertion must evaluate to true」アサーション フォルダでアサーションを配置できます。 必要なレスポンス メッセージ エレメントが見つからず、Evaluate Response XPath アサーションが失敗すると、Send Email アサーションが実行されます。
送信電子メール アカウントが正しく設定されていない場合、Send Email アサーションは失敗します。 Send Email アサーションの失敗がポリシー全体の失敗を引き起こさないようにポリシーを設定するには、Continue Processing アサーションにアサーションを配置します。
このアサーションを使用する間に電子メール タイムアウトになる場合は、
mail.outConnectTimeout
および
mail.outTimeout
クラスタ プロパティを調節してみます。 詳細については、「電子メールのクラスタ プロパティ」を参照してください。

アサーションの使用
  1. 以下のいずれかを実行します。
    • アサーションをポリシー作成ウィンドウに追加するには、「アサーションの追加」を参照してください。
    • 既存のアサーションの設定を変更するには、下記の手順 2 に進みます。
  2. アサーションを追加すると、[Email Properties]が自動的に表示されます。アサーションを変更する場合は、ポリシー ウィンドウで[
    Send Email
    ]を右クリックして[
    Email Properties
    ]を選択するか、ポリシー ウィンドウでアサーションをダブルクリックします。 このアサーションのプロパティが表示されます。
  3. 以下のようにプロパティを設定します。
コンテキスト変数は、柔軟性を高めるために、次のフィールドで使用できます。
Host
Port
Username
Password
From
To
Cc
Bcc
Subject
設定
説明
Host
デフォルトとして、送信メール サーバの名前が表示されます。 必要に応じて変更します。 コンテキスト変数を参照することもできます。
Protocol
使用する電子メール プロトコル([
Plain SMTP
](デフォルト)、[
SMTP over SSL
]、または[
SMTP with STARTTLS
])を選択します。 デフォルト設定はほとんどのインスタンスで適切であるはずです。 プロトコルについて不明な場合は、システム管理者にお問い合わせください。
  1. 「SMTP over SSL」または「SMTP with STARTTLS」プロトコルを使用する場合 SMTP サーバの信頼を設定する必要がある場合があります。 詳細については、「証明書の管理」を参照してください。
  2. SMTP with STARTTLS
    プロトコルを使用するときにエラーが発生する場合は、system.properties ファイルでプロパティ
    com.l7tech.server.policy.emailalert.useDefaultSsl=True
    を追加することで、デフォルトの SSL の実装を使用して通信を有効にすることができます。 このファイルは、
    /opt/SecureSpan/Gateway/node/default/etc/conf/
    フォルダに存在します。
    このプロパティの値を True に設定した後に Gateway を再起動したことを確認してください。
    または
    クラスタ全体のプロパティ、
    email.useDefaultSsl
    を追加し、これを
    True
    に設定します。 このプロパティを設定した後に Gateway を再起動する必要はありません。
Port
デフォルトのメール サーバによって使用されるポートが表示されます。 必要に応じて変更します。 コンテキスト変数を参照することもできます。
Server Requires Authentication
ユーザ名およびパスワードが電子メール サーバにログオンするために必要な場合は、このチェック ボックスをオンにします。
Username
Password
認証が必要な場合は、ユーザ名とパスワードを[Username]と[Password]に入力します。 コンテキスト変数を参照することもできます。
Context variable in password
このチェック ボックスをオンにすると、アサーションがパスワード フィールドで使用されるコンテキスト変数を正しく認識することができます。たとえば、
${secpass.*}
コンテキスト変数を使用します。 詳細については、「保存されたパスワードのプロパティ」を参照してください。
From
差出人の電子メール アドレスを入力します。 コンテキスト変数を参照することもできます。
To
受信者の電子メール アドレスを入力します。 複数のアドレスは、カンマで区切ります。 コンテキスト変数を参照することもできます。
Cc
(オプション) CC (カーボン コピー)受信者の電子メール アドレスを入力します。 複数のアドレスは、カンマで区切ります。 コンテキスト変数を参照することもできます。
Bcc
(オプション) BCC(ブラインド カーボン コピー)受信者の電子メール アドレスを入力します。 複数のアドレスは、カンマで区切ります。 「To」および「CC」リスト内の受信者には、「Bcc」リスト内の受信者は表示されません。 コンテキスト変数を参照することもできます。
Subject
電子メールを説明する件名を入力します。 コンテキスト変数を参照することもできます。
Format
電子メール テキストの形式を選択します。
Plain Text
: メッセージ本文にフォーマット設定のない単純な電子メールを作成するには、このオプションを選択します。 これは、デフォルトのオプションです。
HTML
: HTML 形式で電子メールを送信するには、このオプションを選択して HTML タグを使用します。
重要:
Java スクリプトを避けてインライン CSS を使用することをお勧めします。 一部の電子メール クライアントは、
<head>
または
<style>
タグで定義されている CSS を破棄する場合があります。
<body style="background-color: lightblue;">
<h1>Hello world!</h1>
</body>
[Format]プロパティの下にあるテキスト領域に電子メールを入力します。 必要な場合、メッセージ内にコンテキスト変数を含めることもできます。
添付ファイルの管理
電子メールと共に送信される 1 つまたは複数の添付ファイルを設定します。 すべての添付ファイルは、電子メール本文の下の[Attachments]セクションにカンマ区切りのファイル名としてリスト表示されます。 詳細については、後述の「添付ファイルの管理」を参照してください。
Send Test Email
受信者にテスト電子メールを送信します。 これを使用して、設定が正しいことを確認します。
  1. コンテキスト変数が[Email Properties]で使用されている場合、
    [Send Test Email]
    ボタンは動作しません。
  2. テスト電子メールが送信される場合、添付ファイルは無視されます。
4.
[OK]
をクリックします。
添付ファイルの管理
Email Properties
]ダイアログ ボックスの[
Manage Attachments
]をクリックして、電子メールに対する複数の添付ファイルを追加、編集、または削除できます。
  1. Email Properties
    ]ダイアログ ボックスで、[
    Manage Attachments
    ]をクリックします。
  2. 添付ファイルを管理するには、[
    追加
    ]をクリックするか、既存の添付ファイルを選択して[
    編集
    ]/[
    削除
    ]をクリックします。
    1. Name
      : 添付ファイル名を指定します。
    2. Source Variable
      : 添付ファイルの設定の詳細を指定します。 これは、単純な MESSAGE タイプ変数か、MESSAGE の MIME パートまたはマルチ MIME パートです。
    3. 添付ファイルを追加する場合
      1. Manage Attachments
        ]ダイアログ ボックスで、[
        Add
        ]をクリックします。
      2. 添付ファイル名と設定の詳細を入力します。
      3. OK
        ]をクリックします。
    4. 添付ファイルを編集する場合
      1. Manage Attachments
        ]ダイアログ ボックスで、添付ファイルを選択します。
      2. [Edit]
        をクリックします。
      3. 選択した添付ファイルの設定を編集します。
      4. [Source Variable]が MIME パート メッセージと見なされるようにするには、[
        MIME Part(s) Variable
        ]チェックボックスをオンにします。 ファイル名が無効になり、パートの Content-Disposition ヘッダから取得されます。
        以下に例を示します。
        • メッセージ: request.parts.1, response
        • マルチ MIME パート: request.parts
      5. OK
        ]をクリックします。
    5. 添付ファイルを削除する場合
      1. Manage Attachments
        ]ダイアログ ボックスで、添付ファイルを選択します。
      2. Remove
        ]をクリックします。
      3. OK
        ]をクリックします。
添付ファイルを組み込むことができない場合、アサーションが失敗して警告メッセージが表示されます。