はじめに
「Microsoft Azureで購入したドメインへメール送信をし、そのメール内容を指定したAPIへPostする」といった内容を実施する機会がありました。
本記事では以下の項目に分けてその手順を示します。
- Azureでドメインを購入
- SendGridでのWhiteLabel設定
- Azure DNS zoneでのSendGridのWhiteLabel用レコード設定
- SendGridでのメール取り込みWebhook設定
- Azure DNS zoneでのSendGridへのメール取り込み用レコード設定
- メールを送信してテスト
対象者
- Azureを利用し、送信したメール内容を自分らで管理しているAPIへPostしたい人
- 年間$11.99かかるがドメインをAzure上で購入して良い人(別サービスでのドメインもAzure DNSzoneで扱えます)
前提条件
- Azureのアカウントを所持している
設定
Azureでドメインを購入
Azureには"APP SERVICE DOMAIN"というサービスがあり、これを利用することで、Azure内でドメインを購入することができます。
① Azure Portal画面から"App Service Domains"というサービスを選択
② "Add"ボタンをクリック
③ 購入するドメインを決定し購入する
現状(2017年11月)では、Azure内で購入できるドメイン料金は年間一律で$11.99(USD)のようです。また、ドメイン購入後のドメイン管理画面にて、ドメインの自動更新をOFFにすることができます。(デフォルトでは自動更新)
SendGridでのWhiteLabel設定
SendGridを利用する目的は、"Inbound Parse"機能で受信したメール内容を別サービスのAPIへPostすることなのですが、"Inbound Parse"機能を利用するには、WhiteLabel(※)というドメイン元(Azure)が利用先(SendGrid)へドメイン利用を許可する設定をAzureとSendGridで行う必要あります。
※: Whitelabelとは → 【公式ドキュメント】Whitelabel概要
① Azure Portal画面から"SendGrid Accounts"サービスを選択
② "Add"ボタンを選択し、SendGridのアカウントを作成する
このとき、SendGridの料金プランは無料枠(Free)で問題ないです。
③ AzureのSendGridアカウント画面の"Manage"ボタンを選択し、SendGridサービスの管理画面へ遷移する
④ SendGridへログインし"Settings"の"Whitelabels"を選択する
⑤ 新規Whitelebelとして、"em"をサブドメインとしたWhitelabelを作成する
whitelabelのサブドメインは"em"を利用することは強制ではないですが、公式ドキュメントには、以下の様な記載があります。
Domain Whitelabelを設定するドメインの前に、サブドメインを付けます。他で使用していない好きな名前を付けられますが、とくに希望がなければ「em」や「em1」といったサブドメイン名を推奨します。
⑥ 作成したWhitelabel設定に、以下のように3レコード分のレコード設定があることを確認する
このとき、AzureのDNS zone設定前では"VALID"のカラムは"X(invalid)"になっています。これはAzure DNS zoneにて対応のDNSレコード設定を追加するとOKになります。
Azure DNS zoneでのSendGridのWhiteLabel用レコード設定
SendGridにてWhitelabel設定後、DNS zoneという購入したドメインのDNS管理をするサービスにて、Whitelabelドメインの設定をします。
① AzureのApp Service Domainから"DNS zone"を選択する。
② "Record set"ボタンを選択し、SendGridで作成したWhitelabelの3レコード分の設定を行う。
SendGridでのメール取り込みWebhook設定
Whitelabel設定後、SendGridの"Inbound Parse"機能でメール取り込み設定を行います。
はじめにSendGrid側での設定をします。
① SendGridの"Settings"の"Inbound Parse"を選択する。
② Addボタンを選択し、メールの宛先とするサブドメイン名と取り込んだメール内容のPost先(Webhook先)のWeb APIのURLを設定する。
Azure DNS zoneでのSendGridへのメール取り込み用レコード設定
Azure DNS zoneにて、SendGridで設定した"Inbound Parse"に対するDNS設定を行います。
① DNS zone設定にて、作成したメール取り込み用サブドメインとmx.sendgrid.netの対であるMXレコードを設定する。
メールを送信してテスト
以上にてすべての設定が終わったので、メールを送信し、設定が正しく反映されているかを確認します。
① 任意のユーザー名で作成したメール取り込み用サブドメインへメールを送信する。
② SendGridの"Inbound Parse"で設定した、POST先のAPIのURL宛にHTTP POSTリクエストがやってきているか、ログを確認する。
ログが確認できれば成功です！
おわりに
SendGridの設定は少しややこしいと感じました。Whitelabelの設定が複雑さの要因になっています。
AzureのDNS zoneにて各レコードがどの機能を担っているのかを把握しておくことが重要だと思います。