10) available-countries

この設定ファイル available-countries はbounceHammer 2.4.0から登場しました。この設定ファイルの役割は次の2つです。

世界各国で著名なドメインの分類制御

世界各国でそれぞれ著名なサービスのドメイン(しかし他の国ではそれほど著名でもない、日本であれば携帯電話アドレスのドメインなど)を細かく分類します。例えば、@MAIL.RUはロシアで有名なフリーのWebメールサービスですが、他の国ではGmailやYahoo!、Hotmailほど有名ではないでしょう。この設定ファイルは他の国で有名なドメインを細かく分類するかどうかを制御する為に使います。

特殊なMTAの定義

ごく一部(特定の国または特定の企業・サービス)でしか使われていないMTA用のモジュールを独自に実装した際に、mailboxparserコマンドがそのモジュールを使うかどうかを制御します。ここで言う特殊なMTAとは、そのMTAが返してくるバウンスメールの形式がほかのどれとも違い、解析用のライブラリを独自に実装しなければならないMTA事です。例えば、日本のau by KDDI (@ezweb.ne.jp)はbounceHammerの中では特殊なMTAとして扱われています。

このファイルは作成しなくてもbounceHammerは動作しますので不要な場合はこのページを読み飛ばしてください。

available-countriesの作成

設定ファイル"available-coiuntries"も他の設定ファイルと同様にYAMLフォーマットです。YAMLフォーマットとして無効な記述をした場合はbounceHammerが正しく動作できませんのでご注意下さい。

このファイルはデフォルトの設定値のままでインストールされた全ての国別の分類用ライブラリを読み込みますので、読み込む必要がないライブラリがある場合に、ファイル内容を編集してください。

このファイルはデフォルトのままで充分ですが、細かな国別のドメイン分類や特殊なMTA用ライブラリを読み込まない場合等は、ファイル内で設定する事により、それらのライブラリを読み込みません。読み込まない事によって解析速度とメモリ消費量が少し向上します。

分類用の項目名

それぞれ国名コード(日本=JP, 英国=UK等)毎に上記表の設定項目があり、webmail, smartphone, cellphone の三項目は設定値として0 = 読み込まない、1 = 読み込むとなります。これらの設定値を 0 にした場合は、解析結果の宛先分類(Host Group)はpcに、宛先所属(Provider)はvariousになります。

特殊なMTAの定義

設定項目名 agentsは、bounceHammerが実装している標準の解析ライブラリでは解析できないMTAの名前を定義する為のものです。書式はYAMLの配列としてMTAの名前を列挙します。列挙した名前は、それぞれKanadzuchi::MTA::国名コード::MTAの名前として読み込まれます。 このファイルのデフォルト値では jp の配下に aubyKDDIが定義済みですので、bounceHammerをインストールしたディレクトリ/lib/Kanadzuchi/MTA/JP/aubyKDDI.pm を読み込みます。

例えば、独自のフォーマットのバウンスメールを返す自社のMTA:OurMTA用のライブラリOurMTA.pmを作成し、bounceHammerをインストールしたディレクトリ/lib/Kanadzuchi/MTA/JP/OurMTA.pmとして設置した場合、次のように設定する事で、そのライブラリを読み込みます。

"jp":
  "cellphone": 1
  "smartphone": 1
  "webmail": 1
  "agents": [ "aubyKDDI", "OurMTA" ]

続いて管理画面の設定(すぐに終わります)の為にWebUI/管理画面の準備へ進んでください。