Microsoft AzureのMarketplaceでSendGridを利用するまで

Microsoft Azureで構築したシステムからメール送信を行いたい場合、MarketplaceにあるSendGridを利用するのがお手軽です。

Qiitaにある「[AzureのMarketplaceからSendGridを利用してみる](http://qiita.com/yotan/items/e89c6a89b0c2fbec4a4a)」と内容は途中までほぼ同じですが、API Keyを利用した送信が現在だとスタンダードになりつつあるので、その流れで書いてみたいと思います。

ちなみにAzure FunctionからもSendGridは利用できますので、サーバレスアーキテクチャなどの場合は以下が大変参考になると思います。
[Azure Function Appから定期的にメールを送る](http://qiita.com/superriver/items/d245539b7652b7512f9b)

***
1/18追記
今回はMarketplace前提で書いていますが、SendGridの正規代理店である(株)構造計画研究所にてSendGridのアカウントを取得して、Azure上で利用することも可能です。
https://sendgrid.kke.co.jp/
***

# SendGridの利用準備

Marketplaceの「Add-ons」から「SendGrid Email Delivery」を選択します。
![2017-01-17_00h09_31.png](https://qiita-image-store.s3.amazonaws.com/0/47737/bc0cde12-1674-119f-d92c-6ff8d17d485f.png)

Name,Password,Confirm Password,サブスクリプション(自分の場合はMSDN),Resource Groupを設定します。Resource Groupは今回新規に「SampleAppResource」としましたが、既存のものを使用する形でもOKです。
![2017-01-17_00h35_03.png](https://qiita-image-store.s3.amazonaws.com/0/47737/9d7b6100-6e66-df38-34cf-f1bb4629c8d2.png)

Price tierで価格帯を選びます。Freeプランを選択します。月に25,000通までメール送信可能で、その他の機能的にもほぼほぼ有償版と同じレベルで利用できますので、開発のお試しなどであれば十分かと思います。
![2017-01-17_00h35_39.png](https://qiita-image-store.s3.amazonaws.com/0/47737/9518a1d5-4d62-8e9f-3c0d-6e54e9a8359a.png)

Contact Informationに名前やメールアドレスを設定します。会社名やサイト情報は必須ではありません。
![2017-01-17_00h35_56.png](https://qiita-image-store.s3.amazonaws.com/0/47737/eb1d529a-7a70-80dc-b457-8aca2a567340.png)

最後に法律条項で金額が0.00 JPY/月であることを確認します。
![2017-01-17_00h36_11.png](https://qiita-image-store.s3.amazonaws.com/0/47737/2663c2bf-548b-9a68-dfd3-ddc945498d01.png)

以上で設定完了です。「ダッシュボードにピン留めする」場合はチェックを入れて「作成」ボタンを押すとデプロイが開始されます。
![2017-01-17_00h36_18.png](https://qiita-image-store.s3.amazonaws.com/0/47737/e7cea6f6-b956-709a-c4be-cc833c4f93b8.png)

デプロイが完了するのを待ちます。
![2017-01-17_00h12_39.png](https://qiita-image-store.s3.amazonaws.com/0/47737/4ea72bcf-fc04-6120-fd10-7770f736de09.png)

デプロイが完了したらタイルをクリックします。
![2017-01-17_00h13_31.png](https://qiita-image-store.s3.amazonaws.com/0/47737/716fcf04-ce84-3c53-3b79-8e1c75ecfdd8.png)

「Manage」メニューをクリックしてください。
![2017-01-17_00h13_40.png](https://qiita-image-store.s3.amazonaws.com/0/47737/b819cbff-40a8-5df5-7cfe-08db0b85a045.png)

SendGridの管理画面が表示されます。途中で登録したメールアドレスが表示されているので、確認して「Send Confirmation Email」ボタンを押します。
![2017-01-17_00h14_53.png](https://qiita-image-store.s3.amazonaws.com/0/47737/af2bc35b-bc7d-db18-43a3-062ad61c99dd.png)

SendGridから確認メールが送信されるので、メールを確認します。
![2017-01-17_00h15_25.png](https://qiita-image-store.s3.amazonaws.com/0/47737/ef1d97ab-8fbc-3647-c7e5-edb005b9cbca.png)

以下のようなメールが来ていることを確認します。（届いていない場合は念のため迷惑メールの受信箱も確認してください）
![2017-01-17_00h15_47.png](https://qiita-image-store.s3.amazonaws.com/0/47737/bae1ffff-8beb-ebfb-6678-eb2dbd02d9b2.png)

メールを開き「Confirm Email Address」のボタンを押します。
![2017-01-17_00h16_08.png](https://qiita-image-store.s3.amazonaws.com/0/47737/11d6bbf8-a8da-7434-7920-c9d012b4eead.png)

再度管理画面が表示されたら準備完了です。
![2017-01-17_00h16_38.png](https://qiita-image-store.s3.amazonaws.com/0/47737/ae876f97-9d13-06ed-aa63-39dd02ede7ed.png)

本来であれば、まず最初に、Whitelabelで独自ドメインの設定を行うのが良いです(メールの到達率を少しでも上げるため)。とりあえずメール送信を確認してみたい、という場合や独自ドメインを持っていない、といった場合は設定せずに利用することも可能です。今回は設定しない流れとしますが、重要な設定なので以下ドキュメントなど是非参考にしてください。

https://support.sendgrid.kke.co.jp/hc/ja/articles/203703439

# API Keyの発行

SendGridではJavaやC#など様々な言語向けのライブラリが用意されているため、この状態ですぐにプログラムからメール送信することができます。

ライブラリに関しては以下ページに各言語ごとにGitHubのリンクがありますのでご確認ください。
https://sendgrid.kke.co.jp/docs/Integrate/Code_Examples/index.html

メール送信の際、ユーザIDとパスワードを利用した送信が可能ですが、現在ではAPI Keyを発行して利用する流れがセキュリティ的にも推奨されていますので、発行してみます。

管理画面の「Settings」->「API Keys」を選びます。
![2017-01-17_00h17_30.png](https://qiita-image-store.s3.amazonaws.com/0/47737/844d833f-f3ac-46fe-2d1b-8073c0269def.png)

「Create API Key」から「Generate API Key」を選びます。
![2017-01-17_00h17_44.png](https://qiita-image-store.s3.amazonaws.com/0/47737/8e5e1b2d-a56f-2f87-730a-523a1d0a6cda.png)

API Keyに対する名称（単に一覧などで識別するためだけの名前）を入れ、APIのアクセス権限を設定します。検証などで色々試す場合にはすべてFULL ACCESS/READ ACCESSを付与するのが楽です。本番運用では適切な権限に設定してください。
![2017-01-17_00h18_57.png](https://qiita-image-store.s3.amazonaws.com/0/47737/95f3ae47-69d4-eaf6-e64e-b35a611dba00.png)

保存すると、以下のようにAPI Keyが発行されます。この1度きりしか表示されないので、コピーを忘れたり、ブラウザを閉じてしまったりしないようご注意ください。
![2017-01-17_00h19_08.png](https://qiita-image-store.s3.amazonaws.com/0/47737/2c9fb159-50dd-ea80-2adc-0ba5c664cc84.png)

API Keyを利用すれば、[Curlを利用してメール送信](https://sendgrid.com/docs/Classroom/Send/How_Emails_Are_Sent/api_keys.html)することも簡単です。

私は普段よくJavaを利用するのですが、ビルドツールとしてMavenを利用する場合は

```xml:pom.xml
<dependency>
    <groupId>com.sendgrid</groupId>
    <artifactId>sendgrid-java</artifactId>
    <version>3.1.0</version>
</dependency>
```

と依存性を定義して利用可能です。Gradleの場合やJavaから利用する場合のサンプルコードは以下のSendGrid公式のGitHubにのっています。
https://github.com/sendgrid/sendgrid-java