Perl and Email #3 ``Haineko''/Kyoto.pm #5

Perl and Email #3

@azumakuniyuki Cubicroot Co. Ltd.

Kyoto.pm #05 in 京都::はてなさん 2013/07/13(土)

Emailクラウド風メール送信用HTTP API "Haineko"

七月十七日加筆修正

自己紹介あずま＠京都

@azumakuniyuki

鯖管

プログラマ

たまに

Perl

+(猫)


Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.

2

作ったもの- bounceHammer - バウンスメール解析するやつ - YAML/JSONで出る - http://bouncehammer.jp/

- Acme::Nyaa - 初CPANモジュール/猫系 - 神と和解せよ => ネコと和解せよ - 祇園祭です => 祇園祭ですニャー



3

Perl and Email #3Emailクラウド風メール送信用HTTP API "Haineko"



4

Haineko``はいねこ''



5

HTTPAPIINTOESMTPK=undefO=undef



6

- リレーサーバ(キューは持たない)- HTTPでメールを送る => Mojolicious- 他のSMTPサーバかEmailクラウドへリレー- 応答は全てJSON- Hainekoに渡すときの認証は未実装- $REMOTE_ADDRでリレー制限(relayhosts)- 許可された宛先のみに送信(recipients)

Hainekoの概要Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


7

ArchitectureHainekoの処理の流れ、全体図と部分図。



8

Haineko Flow

Haineko

HTTP Request

HTTP Request

ESMTP Relay

Email Cloud

SendGrid(実装済)Postmark(まだ)MailChimp(まだ)

AmazonSES(まだ)

HTTP Listen on 2794

HTTPS Listen on 2894

mailertable/sendermt

HTTP Response

ESMTP ResponseHTTP Response

POST

HTTP CLIENTBrowser / wget / curl

to JSON

Any SMTP Server

smtp.example.jp:25tls.example.com:465smtp.gmail.com:587

AnotherHaineko Server

SMTP

HTTP / HTTPS

SMTP-AUTHSTARTTLS

PIPELININGCheck REMOTE_ADDR

Check RCPT_TORejected

Cannot connect

JSON

JSON

JSON

JSON

JSON



9

ESMTP Relay

Haineko

ESMTP or HTTP Response

etc/mailertable

etc/sendermt

etc/mailertable:default

宛先アドレスのドメインに一致

発信アドレスのドメインに一致

一致するドメインなしdefaultの定義がない

127.0.0.1:25にリレー

一致する発信アドレスのドメインなし

一致する宛先アドレスのドメインなし

to JSON

127.0.0.1でSMTPdが動いていない

127.0.0.1:25 SMTP

SMTP

HTTP / HTTPS

HTTP/HTTPS



10

Table Files各種の制限項目、経路テーブルなど。



11

- 宛先ドメインでのルーティングテーブル(YAML)

default: mailer: 'ESMTP' host: '192.0.2.22' port: 25

example.com: mailer: 'ESMTP' host: 'smtp.gmail.com' port: 587 auth: 'Google' starttls: 1

etc/mailertable

← 宛先が *@example.comの時は← ESMTPで

← Gmailの587番ポートに接続

← etc/authinfoの"Google"認証情報を使う← SMTPセッションでSTARTTLSを使う

← mailertable, sendermtのどちらにも一致しない場合

← このSMTPサーバの25番に接続して送信(リレー)



12

- 発信ドメインでのルーティングテーブル(YAML)- mailertableと同じ書式

example.jp: mailer: 'ESMTP' host: '192.0.2.253' port: 25

example.org: mailer: 'SendGrid' auth: 'SendGrid'

etc/sendermt

← 発信者が *@example.jpの時は

← Haineko::Relay::SendGridを使う(Web API)← etc/authinfoの"SendGrid"認証情報を使う

← このSMTPサーバの25番に接続して送信(リレー)

← 発信者が *@example.orgの時は



13

- SMTP-AUTH, EmailクラウドのAPI用認証情報(YAML)- ファイルのパーミッションに注意

Google: username: '******@gmail.com' password: 'nekochan22'

SendGrid: username: 'kijitora' password: 'nyanko22'

etc/authinfo

← mailertable, sendermtの``auth''で指定したラベル

← SendGrid APIのパスワード(API_KEY)

← Gmailのユーザ名とパスワード

← SendGrid APIのユーザ名(API_USER)← mailertable, sendermtの``auth''で指定したラベル



14

- メールのリレーを許可するクライアントのIPアドレス- IPアドレスかネットワーク帯域を記述(YAML)- open-relayは危ないので将来削除するかも

open-relay: 0relayhosts: - 127.0.0.1 - 192.0.2.22/32 - 168.254.0.0/16

etc/relayhosts

← ``1''にするとIPアドレスのチェックをしない(危険)

← 許可するIPアドレスかネットワークを配列で列挙

← Net::CIDR::Liteが理解出来る形式で



15

- メールを送っても良い宛先のアドレスかドメイン- このファイルに一致しない宛先には送らない- open-relayは危ないので将来削除するかも

open-relay: 0domainpart: - 'example.co.jp'recipients: - '[email protected]' - '[email protected]'

etc/recipients

← ``1''にするとどんな宛先にも送れる(危険)

← 送っても良い宛先をドメインで指定(配列で列挙)

← 送っても良い宛先を個別に指定(配列で列挙)

← *@example.co.jp宛はなんでもOK!



16

Sending & Replyメール送信とJSONでの応答



17

- sbin/hainekod サンプルスクリプト

$ sbin/hainekod -d start (morboが起動する)$ sbin/hainekod start (hypnotoadが起動する)

$ morbo --listen 'http://*.2794' script/haineko$ hypnotoad script/haineko

- psgiファイルを書けばPlackでも動く、たぶん。

Start HainekoKyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


18

$ curl 'http://127.0.0.1:2794/submit' -X POST -H 'Content-Type: application/json' -d '{ ehlo: "ホスト名", mail: "[email protected]", rcpt: [ "[email protected]", "[email protected]" ], body: "ネコと和解せよ", header: { subject: "ニャー!!", … } }'

メール送信(curl)Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


19

{ "smtp.queueid":"r6DCXsV00649aTl2", "smtp.response": { "dsn": "2.0.0", "error": 0, "message":[ "Accept for delivery" ], "command": "QUIT", "code": "221" }, "smtp.useragent": "ユーザエージェント(USER_AGENT)", "smtp.recipient": [ "[email protected]"], "smtp.addresser": "[email protected]", "smtp.remotehost": "127.0.0.1", "smtp.remoteport":49989}

正常応答(JSON)Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


20

{ "smtp.queueid":"r6DCXsV00649aTl2", "smtp.response": { "dsn": "5.7.1", "error":1, "message":[ "Recipient address not permitted" ], "command": "RCPT", "code": "533" }, "smtp.useragent": "ユーザエージェント(USER_AGENT)", "smtp.recipient": [ "[email protected]"], "smtp.addresser": "[email protected]", "smtp.remotehost": "127.0.0.1", "smtp.remoteport":49989}

エラー応答(JSON)Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


21

Repositorygithub.com/azumakuniyuki/Haineko



22

- Perl and SMTP | Mojoliciousでメール送信APIを作った話 | HTTP-API for sending email- http://yapcasia.org/2013/talk/show/ f023c72c-dfd4-11e2-8f00-96816aeab6a4

- 夏のうちにもう少し開発をする予定- 採用されたらHainekoの話をします!

YAPC::Asia Tokyo 2013Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)


23

終24

Technology

Perl and Email #3 ``Haineko''/Kyoto.pm #5