問題
- ESET Endpoint Encryption Server のメールテンプレートを変更したい。
解決方法
EEEサーバーは、ユーザーに送信する電子メールを作成するために、いくつかのテンプレートを使用します。テンプレートファイルとリソースは、EEE ServerインストールフォルダのTemplatesサブフォルダに格納されています。たとえば
バージョン 2.5.0～3.7.0 では、C:˶Program FilesEnterpriseConsole ˶Templates
バージョン3.8.2以降では、C:◆Program Files (x86)◆ESETエンドポイント暗号化サーバーのテンプレート。
テンプレートを直接編集することはお勧めしません。将来 EEE Server をインストールすると、これらのファイルが上書きされる可能性があります。ファイルを追加して、3.8.2 以降のカスタム電子メールテンプレート、またはバージョン 2.5.0 から 3.7.0 までのカスタムテンプレート参照オブジェクトを変更することをお勧めします。
ESET Endpoint Server バージョン 3.8.2 以降
カスタムメールテンプレート
テンプレートのファイルとリソースは、EEE Server インストールフォルダのTemplates サブフォルダに格納されます。例えば例：C:㊟Program Files (x86)㊟ESET Endpoint Encryption Server㊟Templates。カスタム・テンプレートを作成するには、以下のメッセージ・タイプのいずれかをコピーし、そのコピーの接尾辞を_customに変更します。例えば、textmessage_custom.htmlまたはtextmessage_custom.txtです。これらのファイルは内蔵ファイルよりも優先されます。
これらのファイルは、簡単なテキストエディタを使って手で簡単に編集することができます。各テンプレートにはHTMLとプレーンテキストのフォーマットがあります。
| メッセージの種類 | テンプレート |
テストメッセージ； | EEE Serverコントロールパネルからのテストメッセージ |
| activation_windows； | Windows用のアクティベーションコードメッセージ |
activation_ios； | iOS 用のアクティベーションコードメッセージ |
| initiate_fde； | ワークステーションでFDEを開始する |
| modify_fde_login； | ユーザーの FDE (Full Disk Encryption) ログインを変更する |
| add_fde_login； | ユーザーの FDE ログインを追加する |
- zh-CN-Chinese - 中国語
- zh-TW-中国語 - 台湾
- nl-NL-Dutch - オランダ語
- en-US-English - 米国
- fr-FR-フランス語 - フランス
- de-DE-ドイツ語 - ドイツ
- ja-JP-日本語
- ko-KR-韓国語
- pl-PL-ポーランド語
- es-ES-スペイン語 - スペイン
電子メールテンプレートに使用する言語は、［アクティベーションコードの生成 ］ウィンドウで設定します。Send users Activation Code in an Email（電子メールでアクティベーションコードを送信しますか）］の 横にあるチェックボックスを選択し、言語を選択します。
メールテンプレートのタグ
電子メールテンプレートではいくつかのタグを使用できます。これらのタグを EEE サーバーに追加すると、サーバーがメッセージを生成するときに適切なテキストに置き換わります。テンプレートには、基本的なテキストファイルであるテキストコンポーネントと、HTMLコンポーネントの両方を含めることができます。
汎用タグ
アクティベーションタグ
フルディスク暗号化（FDE）タグ
画像を含む
テンプレートには、基本的なテキストファイルであるテキスト・コンポーネントと、グラフィック画像を含むことができるHTMLコンポーネントの両方を含めることができます。画像はテンプレートと同じフォルダに配置し、テンプレート内で直接参照する必要があります。EEE サーバがテンプレートをロードして解析すると、リンクされた画像をインラインでメッセージに追加しようとします。
URLの埋め込み
HTMLでは、<a href="URL">リンクテキスト</a>を使用してURLリンクを含めることができます。基本的なテキストファイルでは、https://www.eset.com/ のようにテキスト形式で URL を追加します。
ESET Endpoint Encryption Server バージョン 2.5.0 ～ 3.7.0
カスタムテンプレート参照オブジェクトの編集
EEE Server が新しいテンプレートをロードして使用できるように、参照オブジェクトを編集します。このファイルは、EEE Server の scripts フォルダにあります。例えばJSON 言語がこのオブジェクトを定義するので、ファイル名はEmailTemplatesCustom.json にします。
このフォーマットには、既存のテンプレートに関連する5つのルート・メッセージ・タイプが記述されています：
| ルート・メッセージ・タイプ | テンプレート |
テストメッセージ； | EEE Server コントロールパネルからのテストメッセージ |
| アクティベーション； | アクティベーションコードメッセージ |
| initiatefde； | ワークステーションでFDEを開始する |
| modifyfdelogin; ユーザのFDEログインを変更する； | ユーザーの FDE ログインを変更する |
| addfdelogin； | ユーザーの FDE ログインを追加する |
これらの各ノードの下には、異なる言語用のサブノードがあります。en 言語は、選択した言語が見つからない場合のデフォルトなので、常に存在する必要があります。言語は、標準の ISO 639-1 2 文字コードとオプションのバリアントコードのいずれかを使用して指定できます。たとえば、EEE サーバはコードen を英語として解釈します。あるいは、コードen-GBとen-USは、それぞれ異なるイギリス英語とアメリカ英語のテンプレートを提供する。
EEE Serverで提供されるデフォルトの翻訳は、以下のとおりです：
- en-英語
- de-DE - ドイツ語
- es-ES - スペイン語
- fr-FR - フランス語
- ja-JP - 日本語
- nl-NL - オランダ語
- pl-PL - ポーランド語
アクティベーション・メッセージは、Windowsまたはモバイル・デバイスに関連する異なるプラットフォーム用に個別のテンプレートを定義できます。
各言語ノード内で、HTMLとプレーンテキストのテンプレートファイル名、メッセージの件名、必要なフレーズを定義できます。
メールテンプレートのタグ
Eメールテンプレートでは、いくつかのタグを使用できます。これらのタグをEEEサーバーに追加すると、サーバーがメッセージを生成するときに適切なテキストに置き換わります。
一般的なタグ
| タグ名 | 説明 |
| 管理者名 | EEE サーバで定義されている管理者の名前。 |
| ユーザ名 | EEE Serverで定義されている、ユーザの名前。 |
| メッセージの作成日。 | メッセージが作成された日付 |
| メッセージの作成時刻。 | メッセージが作成された時刻 |
| メッセージの作成時刻。 | テンプレート参照オブジェクトで定義されたカスタム URL |
アクティベーション・タグ
| タグ名 | 説明 |
| アクティベーションコード | アクティベーション画面に入力するアクティベーション・コードのテキスト |
| アクティベーションURL | クリックしてアクティベーションするためのアクティベーションコードのURL |
| ライセンスタイプ | ライセンスの種類 |
| ライセンス日付 | アクティベーションコードが生成された日時 |
FDEタグ
| タグ名 | 説明 |
| ワークステーション名 | ワークステーションの名前 |
| ワークステーションID | ワークステーションのID |
| ログインタイプ | ログインのタイプ; Normal あるいはSSO*1です。 |
| fdeLoginUsername | FDE ログインユーザー名 |
| fdeLoginPassword | FDE ログインパスワード |
| canChangePassword。 | パスワードを変更できるかできないかのブール値*1 |
| 再起動回数 | 許可される再起動回数*2 |
| スタートモード | 選択された開始モード（1-4）*1 |
*1テンプレート参照オブジェクトは、実際に追加されるテキストを定義します。
*2 このタグは、デフォルトでは$startMode のテキスト内に存在する。値が数字の場合、単数または複数を示す可能性があります。曖昧さを避けたり、reboot(s) のような用語を使用したりするには、特別なタグを使用して、正しい単数形または複数形が自動的に使用されるようにします。rebootcount|reboot|reboots}という形式を使用すると、$rebootCountの実際の値に応じて、メールに1 rebootsまたは2 rebootsというテキストが正しく含まれることになります。
画像を含める
テンプレートには、基本的なテキストファイルであるテキストコンポーネントと、グラフィカルな画像を含むことができるHTMLコンポーネントの両方を持つことができます。画像は、テンプレートと同じフォルダに配置し、テンプレート内で直接参照する必要があります。EEE サーバがテンプレートを読み込んで解析すると、リンクされた画像をメッセージにインラインで追加しようとします。
メッセージへのURLの追加
配列の各要素は、$messageURL1 、$messageURL2などのタグに関連付けられます。messageURL 配列で指定する各オブジェクトは、リンクテキスト、 実際の URL (href)、alt テキスト、そしてターゲットを指定することができます。href は必須で、それ以外は省略可能です。プレーンテキストのメッセージでは、href 属性と text 属性のみが使用されます。textが指定された場合はhrefの前に追加され、hrefは括弧で囲まれます。
例えば、次のようなJSONを考えてみましょう：
"messageURL"：[
{
"href"："http://www.eset.com/"、
"text"："EEEウェブサイト"
},
{
"href"："https://support.eset.com/"
}
]
タグ$messageURL1はEEEウェブサイト (http://www.eset.com/)に展開され、$messageURL2はhttps://support.eset.com。
HTML テンプレートにのみ適用されるテキストを指定するには、texthtml 要素を使用します。これは、text タグに HTML や画像を含めたい場合に便利です。
カスタムテンプレートの追加
独自のカスタムテンプレートを実装する場合、EmailTemplatesCustom.jsonにカスタム変更のみを実装します。EmailTemplates.json を編集すると、EEE Server のアップグレード時にこのファイルが上書きされます。lintを使用して、JSON が有効であることを確認してください。ファイルが有効でない場合、EEE Server によって無視されます。
