SMTP経由のメール送信

SMTP (Simple Mail Transfer Protocol)は、インターネット上でメールを送信するために広く使用されている信頼性の高い標準通信プロトコルです。NTT CPaaS SMTP APIは、メールを送信するための安全でスケーラブルなインターフェイスを提供することにより、SMTPの上に構築されています。

このセクションでは、SMTP APIと統合し、SMTP経由でメールを送信する方法に関する包括的なガイドを提供します。

SMTP APIとの統合

SMTP APIと統合するには、該当するSMTPサーバー情報が必要です。次の表は、各地域によって分かれている、SMTPサーバーとポート番号で使用可能なエンドポイントを示しています。

Schrems II に準拠するには、使用可能な標準ポート (587または 465) のいずれかで smtp-api-eu.infobip.com を使用します。

ポート587を使用する場合、明示的なSTARTTLSコマンドが必要であるのに対し、ポート465を介した接続は、TLSハンドシェイクがすでに完了していることを意味します。TLS通信は、どのポートでも必須 です。

SMTP認証

SMTP認証 (SMTP AUTH) は、許可されたユーザーのみがNTT CPaaS SMTP APIを介してメールを送信できるようにします。SMTP AUTHは、メッセージ送信を許可する前に有効な資格情報を適用することで、不正アクセスやサーバーの悪用を防ぐのに役立ちます。

NTT CPaaS SMTPは、PLAIN およびLOGIN 認証メカニズムをサポートしています。

• PLAIN - ユーザー名とパスワードを1つのBase64エンコード文字列で送信します。
• LOGIN - ユーザー名とパスワードを個別に送信し、それぞれBase64文字列としてエンコードします。

認証資格情報は、次の2つの方法で送信できます：

1. 基本認証 - NTT CPaaSアカウントのユーザー名とパスワードを使用します。
2. APIキー認証 - ユーザー名は常に App で、パスワードはNTT CPaaSアカウントで作成されたAPIキーです。

どちらの場合も、ユーザー名とパスワードは Base64でエンコードされた 文字列として送信する必要があります。

APIキーの使用法の詳細については、API認証 について詳述しているドキュメントをご参照ください。

サポートされているSMTPコマンド

NTT CPaaSのSMTPサーバーは、次のコマンドをサポートしています：

オプションのカスタムヘッダー

カスタムヘッダーを使用すると、送信SMTPメールに追加情報を含めることができます。次の表に、メール通信で使用されるカスタム ヘッダー名の一覧を示します。

NTT CPaaS SMTP APIとの統合のセットアップ

ここでは、NTT CPaaS SMTP APIとの統合プロセスについて説明します：

1. セキュアな接続を開く -NTT CPaaS SMTPサーバーへのセキュアな接続を確立します。
2. 新しいSMTPセッションを開始する - メールの送信プロセスを開始する新しいセッションを立ち上げます。
3. SMTP接続を認証する - 接続を認証してSMTPサーバーにアクセスするための資格情報を入力します。
4. エンベロープを定義する - 送信者と受信者のメールアドレスを指定して、メールエンベロープを設定します。
5. メッセージの内容を送信する - SMTPサーバーを介してメールの内容を送信し、受信者にメッセージを配信します。

次のセクションでは、手順について詳しく説明します。

セキュアな接続を開く

openssl を使って、smtp-api.infobip.com への新しいSMTP接続を開始します。ポート587に接続し、コマンドプロンプトで次のように入力して、セキュアなコミュニケーションをリクエストします：

openssl s_client -connect smtp-api.infobip.com:587 -starttls smtp -quiet

-quietオプションを使用すると、入力する内容に特殊文字が含まれている場合でも接続は開いたままにしておけます。例えば、Q文字が含まれている入力の場合、このオプションを使用しないと、接続は閉じられてしまいます。

このコマンドで問題が発生した場合は、-crlfオプションを使用してみてください。これにより、Enter キーを押すと強制的に改行されます。一部のサーバーでは、これが必要になる場合があります。

例えば：

openssl s_client -crlf -connect smtp-api.infobip.com:587 -starttls smtp -quiet

サーバーは、証明書に関する情報を含む、末尾が250 OKで終わる応答を返します。

新しいSMTPセッションを開始する

EHLOコマンドを使ってクライアントをNTT CPaaS SMTPサーバーに紹介し、ESMTPセッションを開始します。このコマンドはまたサーバーに対して、サポートされているSMTP拡張機能のリストを返すように促します。

EHLO <client_hostname>

NTT CPaaS SMTPサーバーは、サポートされているSMTP拡張機能のリストを含む、末尾が250 OKで終わる応答を返します。 例えば：

250-smtp.email-messaging.com
250-8BITMIME
250-SIZE 20971520
250-STARTTLS
250-AUTH LOGIN PLAIN
250-ENHANCEDSTATUSCODES
250-PIPELINING
250 OK

SMTPセッションを認証する

許可されたユーザーのみがNTT CPaaS SMTP APIを介してメールを送信できるようにするには、SMTP認証 を使用する必要があります。

1. LOGIN認証メカニズムによって認証プロセスを開始します。
2. 次に、AUTH LOGINコマンドをSMTPサーバーに送信します。
3. その後、サーバーはユーザー名とパスワードを順番に入力するように求め、認証が成功裏に終わると、確認が取れたことを応答します。

次の点にご留意ください：

• SMTPサーバーは、Base64でエンコードされたユーザー名のプロンプトとして334 VXNlcm5hbWU6を応答します。Base64でエンコードされたユーザー名を入力します。
• SMTPサーバーは、Base64でエンコードされたパスワードのプロンプトとして334 UGFzc3dvcmQ6を応答します。Base64でエンコードされたパスワードを入力します。

ユーザー名とパスワードの資格情報が有効な場合、NTT CPaaS SMTPサーバーは235 2.7.0 Authentication successfulと応答します。

エンベロープを定義する

認証が完了したら、送信者と受信者のアドレスを指定して エンベロープ を定義します。

1. 送信者アドレスを指定するには、MAIL コマンドを使用します: MAIL FROM: <sender_address>
2. オプションで、MAILコマンドにSIZEパラメーターを含めて、メッセージサイズをバイト単位で宣言できます: MAIL FROM: <sender_address> SIZE=number_of_bytes
3. SIZEパラメーターを使用すると、サーバーはメッセージを処理できるかどうかを即時にチェックします。メッセージサイズが最大許容限度を超えると、サーバーはメッセージが大きすぎると応答します。SIZEパラメーターを組み込まない場合、このチェックは、後でDATAコマンドの実行中に実際のメッセージ内容で行われます。
4. 送信者が受け入れられると、NTT CPaaS SMTPサーバーは250 2.1.0 Sender <sender_address> OKと応答します。
5. 受信者を指定するには、RCPT コマンドを使用します: RCPT TO: <recipient_address>
6. 受信者が複数いる場合は、受信者ごとにRCPTコマンドを繰り返します。
7. 受信者が受け入れられると、NTT CPaaS SMTPサーバーは250 2.1.5 Recipient <recipient_address> OKと応答します。
8. エンベロープアドレスを正常に送信したら、DATAコマンドを使ってメッセージの内容を送信したいことをアナウンスするプロセスに進みます。

コマンドのパイプライン処理

NTT CPaaS SMTPサーバーは、コマンドのパイプライン処理 をサポートしています。

パイプラインなしでSMTPコマンドを使用する場合、クライアントとサーバー間の対話はリクエスト－レスポンスのサイクルに従います。クライアントは、各コマンドの後にサーバーの応答を待ってから、次のコマンドを送信する必要があります。

パイプライン処理により、クライアントは、各コマンドに対するサーバーの応答を待たずに、MAIL、RCPT、およびDATAコマンドを同時に送信できます。このアプローチにより、トランザクションあたりの往復数と遅延が大幅に削減されます。サーバーは、送信された各コマンドまたはアドレスに対して明確で説明的な応答を提供します。

次の例は、パイプラインを使用しない場合とパイプラインを使用する場合のコマンドの順序とサーバーの応答を示しています。

メッセージ内容の送信

DATAコマンドを送信することで、メッセージ内容の送信をリクエストできます。以前に送信したエンベロープアドレスとすべてが一致している場合、サーバーは次のように応答します：

354 End data with <CR><LF>.<CR><LF>

サーバーからステイタスコード354の応答を受信したら、メッセージ内容のMIMEバージョン (以下「MIMEコンテンツ」) を送信できるようになります。

許容される未加工メールのMIMEメッセージの最も単純な例を以下で示します：

From: "Sender Name" <sender@example.com>
To: recipient@example.com
Subject: Simple subject
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="example_boundary"
 
--example_boundary
Content-Type: text/plain; charset="utf-8"
 
This is the plain text content.
--example_boundary--

これは、フル機能のMIME例です：

Subject: Fully Featured SMTP Example
From: "Sender Name" <sender@example.com>
Reply-To: reply-to@example.com
To: recipient_1@example.com, recipient_2@example.com
Cc: recipient_cc@example.com
Message-ID: <custom-message-id@example.com>
X-IB-Bulk-Id: 1234567890
X-IB-Tracking-Url: https://www.example.com/email/webhook/server
X-IB-Intermediate-Report: true
X-IB-Notify-Url: https://www.example.com/email/delivery/server
X-IB-Notify-Content-Type: application/json
X-IB-Callback-Data: [{"id": 1, "desc": "Callback Data Example as JSON"}]
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="example_boundary"
 
--example_boundary
Content-Type: text/html; charset=UTF-8
 
<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>Hello world from Infobip! Happy testing :)</p>
    <img src="cid:pixel_cid" alt="Pixel as the inline image">
  </body>
</html>
--example_boundary
Content-Type: image/png
Content-Id: <pixel_cid>
Content-Disposition: inline; filename="pixel.png"
Content-Transfer-Encoding: base64
 
iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mPkT1GpBwACOQEYP+FHpAAAAABJRU5ErkJggg==
--example_boundary
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="simple.pdf"
Content-Transfer-Encoding: base64
 
JVBERi0xLjEKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHMgWzMgMCBSXS9Db3VudCAxPj5lbmRvYmoKMyAwIG9iajw8L1R5cGUvUGFnZS9QYXJlbnQgMiAwIFIvTWVkaWFCb3hbMCAwIDMwMCAyMF0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YwIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNjM+PnN0cmVhbQpCBiAwIFRMIDAgMCAxMCAxMCAwIDAKL0YwIDEyIFRmCjI1IDAgVGQKKCJTaW1wbGUgUERGIC0gRnVsbHkgRmVhdHVyZWQgU01UUCIpIFRqCkUKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqPDwvVHlwZS9Gb250L1N1YnR5cGUvVHlwZTEvTmFtZS9GMC9CYXNlRm9udC9IZWx2ZXRpY2EvRW5jb2RpbmcvV2luQW5zaUVuY29kaW5nPj5lbmRvYmoKeHJlZgowIDYKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMTAwIDAwMDAwIG4gCjAwMDAwMDA2MDggMDAwMDAgbiAKMDAwMDAwMTcyOSAwMDAwMCBuIAowMDAwMDAxOTMxIDAwMDAwIG4gCnRyYWlsZXI8PC9Sb290IDEgMCBSL1NpemUgNj4+CnN0YXJ0eHJlZgoyMDQxCiUlRU9GCg==
--example_boundary--

メッセージの終了を知らせるには、<CRLF>.<CRLF> MIME コンテンツの後。メッセージが受け入れられると、NTT CPaaS SMTP APIは 250 2.6.0 メッセージがキューに登録されました<message_id> で応答します 。

SMTPセッションを終了し、接続を閉じるには、QUITコマンドを送信します。