/var/log/azumakuniyuki

Hainekoの纏まったドキュメントは思いつきで取ったドメインであるhaineko.orgに日本語と英語で書く予定ですが、すぐに出来るわけでもないので、現時点でのHainekoについて、いろいろちょいちょい書いていく過程の二回目、リレーサーバの定義について書きます。

今日書く内容は、Hainekoの要というか基礎となる部分であるリレーサーバをどう定義するかについて、二つのファイル: mailertableとsendermtを中心に紹介しようかと思います。



Hainekoはメールのリレーサーバなので、受けとったメールをどこかのSMTPサーバまたはメールクラウドにリレーします。どのサーバにリレーするかを決定するファイルがetc/mailertableとetc/sendermtの二つです。

mailertable - 宛先メールアドレスでのルーティング

sendermt - 発信者アドレスでのルーティング

評価順序

基本的な書式

gmail.com:
  mailer: 'ESMTP' ← lib/Haineko/SMTPD/Relay/*.pmが呼ばれる
  host: '192.0.2.34' ← ホスト名かIPアドレス
  port: 25 ← ポート番号
  auth: 'GmailAuth' ← SMTP認証が必要な場合、etc/authinfoが参照される。
  retry: 1 ← 相手側サーバが400系エラーの時再試行する回数
  sleep: 5 ← 接続再試行まで待機する秒数
  timeout: 9 ← 接続確立までのタイムアウト秒数
  starttls: 1 ← TLSで接続する
  disable: 0 ← 1にするとこの設定は使用されない

example.com:
  mailer: 'AmazonSES'
  auth: 'AmazonSES'
  timeout: 10
  disabled: 0

上記の設定は****@gmail.comな宛先の場合は192.0.2.34にリレーするという意味です。その下はAmazonSESのWeb-APIを使ったリレー設定です。****@example.comな宛先の場合はAmazonSESにHTTPSでリレーされます。AmazonSESやSendGrid,MandrillのようなWeb-APIでリレーする場合は、APIのサーバが固定値でモジュールに入っているので"host"や"port"の設定は不要です。

@example.comや@gmail.com以外が宛先であるメールは"default"に定義されている設定に従ってリレーされます。

authinfo - SMTP認証またはWeb-APIのキー定義

GmailAuth:
  username: 'Gmailのユーザ名'
  password: 'Gmailのパスワード'

AmazonSES:
  username: 'APIのKeyID'
  password: 'APIのSecret Key'

この記事では"GmailAuth"と"AmazonSES"という名前がそれにあたります。mailertable,sendermtとauthinfoの間で名前が一致していたらキー名は何でも良いです。

まだ手を付けてもいないのですが、このあたりの設定ファイルはRedisに対応しようかと思っています。他の設定ファイルについてはまた今度書きます。