Azure Communication Service でメールを送信する

概要

Azure Communication Service でのメール送信

事前準備: メール通信サービスを作成

事前準備: Azure Communication Serviceのリソース作成、メール通信サービスの追加

プログラム

事前準備:パッケージのインストール

UI

コード

using System.Net.Mail;
using Azure.Communication.Email;
using Azure.Communication.Email.Models;

namespace SimpleSendMailDesktopApp
{
  public partial class FormMain : Form
  {
    public FormMain()
    {
      InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
 
    }
    private void Button1_click(object sender, EventArgs e)
    {
      var connectionString = @"(接続文字列)";
      EmailClient emailClient = new EmailClient(connectionString);

      EmailContent emailContent = new EmailContent("テストメールのタイトル");
      emailContent.PlainText = "テストメールの本文";
      List<EmailAddress> emailAddresses = new List<EmailAddress> {
        new EmailAddress("xxxxxx@ipentec.com(送信先メールアドレス)") { DisplayName = "(送信者名)" }
      };
      EmailRecipients emailRecipients = new EmailRecipients(emailAddresses);
      EmailMessage emailMessage = new EmailMessage("[送信者メールアドレス]", emailContent, emailRecipients);
      SendEmailResult emailResult = emailClient.Send(emailMessage, CancellationToken.None);
    }
  }
}

解説

  var connectionString = @"(接続文字列)";
  EmailClient emailClient = new EmailClient(connectionString);

  EmailContent emailContent = new EmailContent("テストメールのタイトル");

  emailContent.PlainText = "テストメールの本文";

  List<EmailAddress> emailAddresses = new List<EmailAddress> {
    new EmailAddress("xxxxxx@ipentec.com(送信先メールアドレス)") { DisplayName = "(送信者名)" }
  };
  EmailRecipients emailRecipients = new EmailRecipients(emailAddresses);

  EmailMessage emailMessage = new EmailMessage("[送信者メールアドレス]", emailContent, emailRecipients);

  SendEmailResult emailResult = emailClient.Send(emailMessage, CancellationToken.None);

実行結果

キー(接続文字列)が間違っている場合

Azure.RequestFailedException
  HResult=0x80131500
  Message=Denied by the resource provider.
Status: 401 (Unauthorized)
ErrorCode: Denied

Content:
{"error":{"code":"Denied","message":"Denied by the resource provider."}}

Headers:
Transfer-Encoding: chunked
X-Cache: REDACTED
X-Azure-Ref: REDACTED
Date: Ddd, 00 Mon 0000 00:00:00 GMT
Content-Type: application/json

送信者のメールアドレスが[送信者のドメイン]のメールアドレスと異なる場合

Azure.RequestFailedException
  HResult=0x80131500
  Message=Email sender's username is invalid. Please use a username from the list of valid usernames configured by your admin.
Status: 400 (Bad Request)
ErrorCode: InvalidSenderUserName
Content:
{"error":{"code":"InvalidSenderUserName","message":"Email sender's username is invalid. Please use a username from the list of valid usernames configured by your admin.","target":null,"details":null,"innererror":null}}

Headers:
mise-correlation-id: REDACTED
Repeatability-Result: REDACTED
x-ms-request-id: 8f25a3b7-9bed-4362-b880-d661b48979cf
x-ms-error-code: REDACTED
api-supported-versions: REDACTED
X-Cache: REDACTED
X-Azure-Ref: REDACTED
Date: Ddd, 00 Mon 0000 00:00:00 GMT
Content-Length: 218
Content-Type: application/json; charset=utf-8

補足:メール送信方式のメリット、デメリット

メール送信の方法

• プロバイダやメールサービスのSMTPサーバーを利用する
• SendGridを利用する (SMTP or API)
• Microsoft Graphを利用する
• Azure Communication Serviceを利用する

プロバイダやメールサービスのSMTPサーバーを利用する方法

メリット

• 古くからの方式のため、実装が多く、実装がこなれている
• 動作方式がシンプル
• メールのFromを送信者のメールアドレスに設定できる
• メール送信数に応じた費用が発生せず

デメリット

• SMTPの標準ポート25がインターネット接続プロバイダによってブロックされている場合がある (OP25B)
• サーバーによってはスパムチェックがあり、送信元のIPを許可する必要がある(spamhausなど)
• サーバーによってはスパムチェックがあり、DNSサーバーへの送信元のIPを登録する必要がある
• SMTP Auth, POP before SMTP など認証やセキュリティ面での追加の実装が必要な場合がある
• SSLによる通信が必要なサーバーがあり、ライブラリによっては対応していない場合がある
• 送信アカウントのメールボックスに有効なライセンスが必要 (Micrsoft Exchange Online)
• 大量のメールを送信するとSMTPサーバ側でスパム判定される可能性あり

SendGridを利用する方法

メリット

• 大量のメールを送信可能
• SMTP, APIどちらの方式でも利用可能

デメリット

• 仕様が変わることがある
• 運営が安定していない? (買収等)
• メール送信数が多い場合は費用が発生
• メールのFromはプロビジョニングしたドメインのメールアドレスのみ設定可能

Microsoft Graphを利用する方法

メリット

• 新しい仕組みのため、セキュリティが強固
• SMTPを利用しない、APIを利用した送信

デメリット

• 実装例が少ない
• 実装が複雑
• Azure Active Directoryへのアプリケーション登録が必要
• Exchange Onlineのライセンスが必要(?)

Azure Communication Serviceを利用する方法

メリット

• 新しい仕組みのため、セキュリティが強固
• SMTPを利用しない、APIを利用した送信
• コードが比較的シンプル

デメリット

• 実装例が少ない
• まだベータ版
• メールのFromはプロビジョニングしたドメインのメールアドレスのみ設定可能
• 1通送信するごとに費用が発生する

著者

Penta

iPentecのメインプログラマー
C#, ASP.NET の開発がメイン、少し前まではDelphiを愛用