JSON 設定ファイル

Enki Outlook Classic アドインの動作をカスタマイズするには、config.json という名前のファイルを作成し、アドインのインストールフォルダー（既定では Program Files\Eventus\Enki Outlook Add-in）に配置します。このファイルが存在しない場合、または解析できない場合、アドインは既定値にフォールバックします。つまり、設定を行うまではスパム報告と送信前の警告はオフのままになります。

設定ファイルの例

{
  "reportSpam": true,
  "promptSendToExternal": true,
  "spamReportConfig": {
    "buttonText": "Report Spam",
    "contextMenuText": "Report Spam",
    "promptMsg": "Are you sure you want to report this email?",
    "promptType": "simple",
    "completePrompt": "Thank you for reporting this email.",
    "submitTo": "security@yourcompany.com",
    "promptSend": false,
    "deleteSentItem": true,
    "deleteOriginal": true,
    "exportType": "eml"
  },
  "externalPromptConfig": {
    "promptType": "simple",
    "promptMsg": "You are sending this email to $$externalcount$$ external recipient(s). Are you sure you want to send it?",
    "useGALCheck": true,
    "useSmtpDomainCheck": true,
    "externalSmtpDomains": [],
    "internalSmtpDomains": ["yourcompany.com"],
    "resultHeader": "X-Enki-Result"
  }
}

両方のドメインリストを空のままにしないでください

useSmtpDomainCheck が true で、externalSmtpDomains と internalSmtpDomains の両方が空の場合、アドインはすべての受信者を内部とみなします。その結果、送信前の警告はまったく表示されなくなります。上記の例のように、internalSmtpDomains には必ず自社の内部ドメインを最低でも1つ指定してください。

トップレベルのオプション

パラメーター	型	説明
reportSpam	boolean	スパム・フィッシング報告ボタンとコンテキストメニュー項目のオン・オフを切り替えます。既定値: false。
promptSendToExternal	boolean	外部の受信者に対する送信前の警告のオン・オフを切り替えます。既定値: false。
promptExternalUrl	boolean	リンクの書き換えをオンにし、外部メール内でクリックされたリンクを開く前にチェックします。既定値: false。
spamReportConfig	object	スパム・フィッシング報告機能を設定します。スパム報告の設定を参照してください。
spamReportRules	array	報告されたメールのヘッダーに基づいて spamReportConfig を上書きする、メッセージ単位のルールです。スパム報告の上書きルールを参照してください。
externalPromptConfig	object	送信前の外部受信者警告を設定します。送信前プロンプトの設定を参照してください。
externalUrlPromptConfig	object	ユーザーが外部と分類されたリンクをクリックした際に表示される警告を設定します。外部 URL プロンプトの設定を参照してください。

スパム報告の設定

spamReportConfig の下にネストされます。

パラメーター	型	説明
submitTo	string	報告されたメッセージの送信先メールアドレスです。報告機能が動作するために必須であり、未設定の場合、報告メールには送信先がなくなります。
buttonText	string	リボンの報告ボタンに表示されるテキストです。
contextMenuText	string	右クリックのコンテキストメニュー項目に表示されるテキストです。
promptType	string	"simple" の場合はシンプルな確認ダイアログを表示し、それ以外の値の場合はより詳細な報告フォームを表示します。
promptMsg	string	promptType が "simple" のときに表示される確認メッセージです。
completePrompt	string	報告が正常に送信された後に表示されるメッセージです（上書きルールが一致しなかった場合）。
promptSend	boolean	true の場合、作成された報告メールが送信前にユーザーへ確認のために表示されます。false の場合は自動的に送信されます。既定値: false。
deleteSentItem	boolean	true かつ promptSend が false の場合、送信済みの報告メールがユーザーの送信済みアイテムフォルダーから削除されます。既定値: true。
deleteOriginal	boolean	true かつ promptSend が false の場合、報告対象の元のメールがユーザーのメールボックスから削除されます。既定値: true。
exportType	string	"eml" の場合、元のメッセージが .eml ファイルとして添付されます。それ以外の値の場合は .msg として添付されます。既定値: "eml"。
emailSubject	string	報告メールの件名です。$$reason$$ および $$subject$$ のプレースホルダーに対応しています。共通プレースホルダーを参照してください。
includeSmtpHeader	boolean	true の場合、報告されたメッセージの生の SMTP ヘッダーが報告本文に含まれます。既定値: false。
includeSmtpHeaderAsAttachment	boolean	true（かつ includeSmtpHeader も true）の場合、ヘッダーは本文に埋め込まれる代わりにテキストファイルとして添付されます。既定値: false。
additionalInfoContent	string	報告に追加される自由記述の追加内容です。$$reason$$ プレースホルダーに対応しています。

既知の命名の不整合について

現行リリースの不具合により、exportType は現状ここに示す通り正確に入力する必要がありますが——exportType という名前自体は正しいものの——アドイン内部の JSON バインディングキーにスペルミスがあります。exportType を設定したにもかかわらず、報告メッセージが期待通りに .msg ではなく .eml としてエクスポートされる（あるいはその逆）場合は、Eventus サポートまでお問い合わせください。この問題は今後のリリースで修正される予定です。

スパム報告の上書きルール

spamReportRules は、記載された順序で評価されるルールのリストです。最初に一致したルールが、その報告について spamReportConfig の該当するフィールドを上書きします。これは、メールセキュリティ製品が付加するヘッダーに基づいて報告の振り分け先を変える場合などに便利です（例: フィッシング訓練で検知が確定したものを、一般的なスパム報告とは別のメールボックスへ送るなど）。

パラメーター	型	説明
type	string	評価する条件です。"headerexists" または "headernotexists" を指定します。
value	string	チェック対象となるヘッダー名です。
submitTo	string	このルールに対して spamReportConfig.submitTo を上書きします。
completePrompt	string	このルールに対して spamReportConfig.completePrompt を上書きします。
emailSubject	string	このルールに対して spamReportConfig.emailSubject を上書きします。
additionalInfoContent	string	このルールに対して spamReportConfig.additionalInfoContent を上書きします。

送信前プロンプトの設定

externalPromptConfig の下にネストされます。これは、ユーザーが組織外の受信者へメールを送信しようとしたときに表示される警告を制御します。

パラメーター	型	説明
promptType	string	"simple" の場合はシンプルな確認ダイアログを表示し、それ以外の値の場合はより詳細なプロンプトを表示します。
promptMsg	string	ユーザーに表示されるメッセージです。$$externalcount$$、$$internalcount$$、$$totalcount$$ のプレースホルダーに対応しています。送信前プロンプトのプレースホルダーを参照してください。
expandGroup	boolean	true の場合、受信者が内部か外部かを判定する前に、配布リストがメンバーのアドレスへ展開されます。既定値: true。
useGALCheck	boolean	true の場合、組織のグローバルアドレス一覧（GAL）に見つからない受信者は外部とみなされます。既定値: true。
useSmtpDomainCheck	boolean	true の場合、受信者のドメインが GAL チェックの代わりに（または併用して）externalSmtpDomains／internalSmtpDomains と比較されます。既定値: false。
externalSmtpDomains	array	他のチェックの結果にかかわらず、常に外部として扱われるドメインです。
internalSmtpDomains	array	内部として扱われるドメインです。useSmtpDomainCheck が true の場合は必須です — 上記の注意事項を参照してください。
resultHeader	string	送信済みメッセージに書き込まれるカスタムヘッダー名（例: X-Enki-Result）で、外部受信者へ送信されたかどうかを記録します。後続のメールフロールールや監査に活用できます。

外部 URL プロンプトの設定

externalUrlPromptConfig の下にネストされます。promptExternalUrl が有効な場合に、ユーザーが Enki によって外部と分類されたリンクをクリックした際に表示される警告を制御します。

パラメーター	型	説明
promptType	string	"simple" の場合はシンプルな確認ダイアログを表示し、それ以外の値の場合はより詳細なプロンプトを表示します。
promptMsg	string	リンクを開く前に表示されるメッセージです。
useDomainCheck	boolean	true の場合、リンクのドメインが externalDomains／internalDomains と比較され、プロンプトを表示するかどうかが判定されます。既定値: false。
externalDomains	array	常に外部リンクとして扱われるドメインです。
internalDomains	array	内部（信頼済み）リンクとして扱われるドメインです。

共通プレースホルダー

spamReportConfig.emailSubject および spamReportConfig.additionalInfoContent（および spamReportRules 内のルールごとの上書き設定）で使用できます。

プレースホルダー	説明
$$subject$$	報告対象となった元のメールの件名です。
$$reason$$	報告時にユーザーが入力または選択した理由のテキストです。

送信前プロンプトのプレースホルダー

externalPromptConfig.promptMsg で使用できます。

プレースホルダー	説明
$$externalcount$$	外部と分類された受信者の数です。
$$internalcount$$	内部と分類された受信者の数です。
$$totalcount$$	受信者の総数です。