Upload
azuma-kuniyuki
View
609
Download
3
Embed Size (px)
DESCRIPTION
Emailクラウド風メール送信用HTTP API "Haineko" | ``Haineko'' is an HTTP API for sending emails like an email cloud.
Citation preview
Perl and Email #3
@azumakuniyuki Cubicroot Co. Ltd.
Kyoto.pm #05 in 京都::はてなさん 2013/07/13(土)
Emailクラウド風メール送信用HTTP API "Haineko"
七月十七日加筆修正
自己紹介あずま@京都
@azumakuniyuki
鯖管
プログラマ
たまに
Perl
+(猫)
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
2
作ったもの- bounceHammer - バウンスメール解析するやつ - YAML/JSONで出る - http://bouncehammer.jp/
- Acme::Nyaa - 初CPANモジュール/猫系 - 神と和解せよ => ネコと和解せよ - 祇園祭です => 祇園祭ですニャー
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
3
Perl and Email #3Emailクラウド風メール送信用HTTP API "Haineko"
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
4
Haineko``はいねこ''
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
5
HTTPAPIINTOESMTPK=undefO=undef
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
6
- リレーサーバ(キューは持たない)- HTTPでメールを送る => Mojolicious- 他のSMTPサーバかEmailクラウドへリレー- 応答は全てJSON- Hainekoに渡すときの認証は未実装- $REMOTE_ADDRでリレー制限(relayhosts)- 許可された宛先のみに送信(recipients)
Hainekoの概要Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
7
ArchitectureHainekoの処理の流れ、全体図と部分図。
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
10
Table Files各種の制限項目、経路テーブルなど。
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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番に接続して送信(リレー)
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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の時は
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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''で指定したラベル
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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が理解出来る形式で
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
15
- メールを送っても良い宛先のアドレスかドメイン- このファイルに一致しない宛先には送らない- open-relayは危ないので将来削除するかも
open-relay: 0domainpart: - 'example.co.jp'recipients: - '[email protected]' - '[email protected]'
etc/recipients
← ``1''にするとどんな宛先にも送れる(危険)
← 送っても良い宛先をドメインで指定(配列で列挙)
← 送っても良い宛先を個別に指定(配列で列挙)
← *@example.co.jp宛はなんでもOK!
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
16
Sending & Replyメール送信とJSONでの応答
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
21
Repositorygithub.com/azumakuniyuki/Haineko
Kyoto.pm #5 in 京都::はてなさん 2013/07/13(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
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(土)
Perl and Email #3 ``Haineko'' @azumakuniyuki / Cubicroot Co. Ltd.
23
終24