はじめに
今回業務でSendgridを使うことになったのでやるべきこと、やったほうがよさそうなことを机上で調査しWebHookについてはAzureFunctionを作ってみて試してみました。
ドメイン認証
- ドメイン認証は、SendGridがユーザーの許可を得て、ユーザーの代わりにメールを送信していることを証明するもの
- 具体的にはCNAMEを追加する。
- ちょっとお試ししたい場合はメールアドレスでの認証もできるのでご安心を。
SPF、DKIMの設定
- 絶対やっとくべし。
- 設定に必要なDNSレコードはSendGridの管理画面で出力されるので、これをDNSに設定後SendGridの管理画面で「Verify」を押すだけ。
IPアドレスの逆引き設定
- 複数ドメインからメールを送信じゃなくてもやっておいても良いと思う。
IPアドレス制限
- FromのIPアドレスを固定化できるかは要注意。Azureだとプランによって固定化できなかったりするので。
APIキーのパーミッションを限定的にする
- APIキーをローテーションする機能はないので運用でローテーションするしかなさそう
- APIキーは複数登録できる
アラートメールの設定
- 送信通数・・・通数で課金されるので設定しておこう
- メールの統計レポート・・・これはなくてもよいかもしれない。
Email Activity
Bounces, Blocksはアラートを設定するまでではないが定期的に見た方が良いかも。
ActivityはWebhook経由でFunctionなどを経由してBlobStorageなどに保存する必要がある
FunctionでEventHookを取得するのは簡単。少し古い記事だが今も変わらず利用可能。
（追記）AzureFunctionのサンプルも用意しました。こちらを利用してください。
URLの設定画面はこんな感じ
実際に動かしてみるとBounceのログはこんな感じでとれる
[
{
email: 'example@test.com',
timestamp: 1674109954,
'smtp-id': '<14c5d75ce93.dfd.64b469@ismtpd-555>',
event: 'bounce',
category: [ 'cat facts' ],
sg_event_id: 'fjO_iOXzYXsSKWWOR_HUEw==',
sg_message_id: '14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0',
reason: '500 unknown recipient',
status: '5.0.0'
},
{
email: 'example@test.com',
timestamp: 1674109954,
'smtp-id': '<14c5d75ce93.dfd.64b469@ismtpd-555>',
event: 'dropped',
category: [ 'cat facts' ],
sg_event_id: 'dhZLeuQ_cPKJZW0q8Xa_lQ==',
sg_message_id: '14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0',
reason: 'Bounced Address',
status: '5.0.0'
}
]
注意点
- Webhookのイベントは重複する可能性ある。sg_event_idでユニークになるので集計時は注意すること
- 以下の制約は大事。Functionでサーバレスプランで初回起動に時間がかかってもリトライしてくれるので大丈夫そうですね。
- 受けきれないと消えてしまうので絶対消えちゃダメな場合はAPIGateway→Queueで受けるとよいと思います。
SendGridは、HTTPステータスコード 2xx が返されるのを待ちます。 指定されたURLから 2xx 以外のコードが返された場合は、24時間リトライします。 リトライキューの最大数は 100,000 です。キューが一杯になった場合は、 古いリクエストから順に削除されます。リトライ期間内に送信されなかったイベントや、 キューから削除されてしまったイベントは、そのまま失われてしまいます。
サービスステータス・障害情報・メンテナンス情報の受信
下記で登録することでサービスを受けられる。登録必須。