通知テンプレートでのマクロの使用
マクロは、イベント通知のテンプレートで使用される代替要素です。テンプレートに基づいて生成された通知の本文において、マクロは特定の値に置換されます。
マクロの構文:%MACRO_NAME%
マクロの値は自動的に英語で挿入されます。マクロの言語を切り替えることはできません。
通知を開始するルールの本文では、以下のマクロを使用できます(以下の表を参照)。
通知テンプレートでのマクロ
マクロ
|
説明
|
%NODE_IP%
|
メッセージを処理したクラスタノードの IP アドレス
|
%NODE_PORT%
|
メッセージを処理したクラスタノードの接続ポート
|
%PRODUCT_NAME%
|
製品名 — Kaspersky Secure Mail Gateway
|
%SMTP_MESSAGE_ID%
|
Message-ID メッセージヘッダー。
|
%SENDER%
|
メール送信者のアドレス
|
%SENDER_IP%
|
メッセージ送信者の IP アドレス
|
%ALL_RECIPIENTS%
|
元のメッセージのすべての受信者のアドレス
|
%AFFECTED_RECIPIENTS%
|
通知に記載されているイベントが発生した、元のメッセージ受信者のアドレス
|
%AFFECTED_RULES%
|
開始されたルール ID のリスト
|
%MESSAGE_ID%
|
KSMG によってメッセージに割り当てられた ID。
|
%SUBJECT%
|
元のメッセージの件名
|
%DATE%
|
メッセージの受信日付
|
%MESSAGE_ACTION%
|
メッセージに実行された処理。
設定可能な値:
SkippedDisinfectedAttachmentDeletedDeletedRejected
メッセージがバックアップに保存された場合、処理に続いてカンマと「backed up」というテキストが記載されます。
|
%DATA_BEGIN%
|
添付ファイルのリストの先頭を示すサービスマクロ
|
%DATA_END%
|
添付ファイルのリストの末尾を示すサービスマクロ
|
%OBJECT_NAME%
|
検知されたオブジェクトの名前
マクロの値は、通知本文のどこに位置しているかに応じて異なります:
- %DATA_BEGIN% マクロと %DATA_END% マクロの間:
- コンテンツフィルタリングのモジュール式がトリガーされ、式に添付ファイル種別または添付ファイル名の属性に関する条件が含まれている場合、マクロは「
Message」という値と添付ファイル名に置換されます。 - コンテンツフィルタリングのモジュール式がトリガーされ、式に他の属性に関する条件が含まれている場合、あるいはアンチフィッシングモジュール、リンクスキャンモジュール、または KATA 保護モジュールがトリガーされた場合、マクロは「
Message」という値に置換されます。 - アンチウイルスモジュールがトリガーされ、本製品がメッセージ全体のステータスを取得できたものの、このステータスが割り当てられた特定の添付ファイルを識別できなかった場合、マクロは「
Message」という値に置換されます。 - アンチウイルスモジュールが起動されると、マクロはメッセージの添付ファイルの名前に置換されます。
- %DATA_BEGIN% マクロと %DATA_END% マクロの外側:「
Message」という値が挿入されます。
通知の件名では、マクロは常に「Message」という値に置換されます。
|
%OBJECT_SIZE%
|
メッセージ全体または個別の添付ファイルのサイズ
マクロの値は、通知本文のどこに位置しているかに応じて異なります:
- %DATA_BEGIN% マクロと %DATA_END% マクロの間:
- コンテンツフィルタリングのモジュール式がトリガーされ、式に添付ファイル種別または添付ファイル名の属性に関する条件が含まれている場合、マクロはメッセージ全体のサイズと添付ファイルのサイズに置換されます。
- コンテンツフィルタリングのモジュール式がトリガーされ、式に他の属性に関する条件が含まれている場合、あるいはアンチフィッシングモジュール、リンクスキャンモジュール、または KATA 保護モジュールがトリガーされた場合、マクロはメッセージ全体のサイズに置換されます。
- アンチウイルスモジュールがトリガーされ、本製品がメッセージ全体のステータスを取得できたものの、このステータスが割り当てられた特定の添付ファイルを識別できなかった場合、マクロはメッセージ全体のサイズに置換されます。
- アンチウイルスモジュールが起動されると、マクロはメッセージの添付ファイルのサイズに置換されます。
- %DATA_BEGIN% マクロと %DATA_END% マクロの外側にある場合、メッセージ全体のサイズが挿入されます。
通知の件名では、マクロは常にメッセージ全体のサイズに置換されます。
|
%STATUS%
|
メッセージまたは添付ファイルのスキャン結果
マクロの値は、通知本文のどこに位置しているかに応じて異なります:
- %DATA_BEGIN% マクロと %DATA_END% マクロの間:
- マクロは、メッセージ全体のスキャンの結果と名前または添付ファイル種別による添付ファイルのスキャンの結果に基づいてコンテンツフィルタリングモジュールによって割り当てられたステータスに置換されます。
- マクロは、コンテンツフィルタリングモジュールによる他の基準を使用したメッセージ全体のスキャン結果、およびアンチフィッシングモジュール、リンクスキャンモジュール、または KATA 保護モジュールによるメッセージ全体のスキャン結果に基づいて割り当てられたステータスに置換されます。
- アンチウイルスモジュールがトリガーされ、本製品がメッセージ全体のステータスを取得できたものの、このステータスが割り当てられた特定の添付ファイルを識別できなかった場合、マクロはメッセージ全体のスキャンによって割り当てられたステータスに置換されます。
- アンチウイルスモジュールが起動されると、マクロは添付ファイルのスキャン結果に基づいて割り当てられたステータスに置換されます。
- %DATA_BEGIN% マクロと %DATA_END% マクロの外側:メッセージ全体をスキャンして割り当てられたステータスが挿入されます。
通知の件名では、マクロは常にメッセージ全体のスキャンに基づくステータスに置換されます。
このステータスを割り当てたモジュールの設定で通知が有効になっている場合、マクロの代わりにステータスが挿入されます。複数のステータスがある場合は、カンマ区切りリストとして挿入されます。
|
%OBJECT_ACTION%
|
本製品によりメッセージまたは添付ファイルに対して実行された処理
マクロの値は、通知本文のどこに位置しているかに応じて異なります:
- %DATA_BEGIN% マクロと %DATA_END% マクロの間:
- 本製品が添付ファイル種別または名前によってコンテンツフィルタリングモジュールによるスキャンのステータスを取得できた場合、マクロはメッセージ全体および添付ファイルに対して実行された処理(
Blocked、Not blocked)に置換されます。 - 本製品が他の基準に基づいてコンテンツフィルタリングモジュールによるスキャンのステータスを取得できた場合、またはアンチフィッシング、リンクスキャン、または KATA 保護スキャンのステータスを取得できた場合、マクロはメッセージ全体に対して実行された処理に置換されます。
- 本製品がメッセージ全体に対するアンチウイルスモジュールによるスキャンのステータスを取得できたものの、このステータスが割り当てられた特定の添付ファイルを識別できなかった場合、マクロはメッセージ全体に対して実行された処理に置換されます。
- 本製品が添付ファイルに対するアンチウイルスモジュールによるスキャンのステータスを取得できた場合、マクロは添付ファイルに対して実行された処理(
Blocked、Not blocked、Disinfected)に置換されます。
- %DATA_BEGIN% マクロと %DATA_END% マクロの外側にある場合、メッセージ全体で実行された処理が挿入されます。
通知の件名では、メッセージ全体で実行された処理が常に挿入されます。
|
ページのトップに戻る