Amazon SESSMTPインターフェイスを介したプログラムによる E メールの送信

Amazon SESSMTPインターフェイスを使用して E メールを送信するには、 SMTPが有効なプログラミング言語、E メールサーバー、またはアプリケーションを使用できます。開始する前に、Amazon Simple Email Service を設定するのタスクを完了します。また、以下の詳細を取得する必要があります。

Amazon SESSMTP認証情報。Amazon SESSMTPエンドポイントに接続できます。Amazon SESSMTP認証情報を取得するには、「」を参照してくださいAmazon SESSMTP認証情報の取得。

重要
SMTP 認証情報がと異なる AWS 認証情報。認証情報の詳細については、「Amazon SES 認証情報の種類」を参照してください。
SMTP エンドポイントアドレス。Amazon SESSMTPエンドポイントのリストについては、「」を参照してくださいAmazon SESSMTPエンドポイントへの接続。
Amazon SESSMTPインターフェイスのポート番号。接続方法によって異なります。詳細については、「Amazon SESSMTPエンドポイントへの接続」を参照してください。

コードの例

SMTPが有効なプログラミング言語を使用して Amazon SESSMTPインターフェイスにアクセスできます。SMTP 認証情報とともに Amazon SESSMTPホスト名とポート番号を指定し、プログラミング言語の汎用SMTP関数を使用して E メールを送信します。

Amazon Elastic Compute Cloud (Amazon EC2) は、デフォルトでポート 25 経由の E メールトラフィックを制限します。Amazon からSMTPエンドポイント経由で E メールを送信する際のタイムアウトを避けるためにEC2、これらの制限の削除をリクエストできます。詳細については、「Amazon EC2インスタンスからポート 25 の制限を削除する方法」または「」を参照してください。 AWS Lambda の関数？ AWS ナレッジセンター。

このセクションの Java とのコード例は、この問題を回避するためにポート 587 PHPを使用します。

注記

このチュートリアルでは、受信を確認できるように自分宛に E メールを送信します。詳細な実験や負荷テストを行うには、Amazon SESメールボックスシミュレーターを使用します。メールボックスシミュレーターに送信される E メールは、送信クォータに加算されず、バウンス率や苦情率の計算にも含まれません。詳細については、手動でメールボックスシミュレーターを使用するを参照ください。

プログラミング言語を選択して、その言語の例を表示します。

警告

Amazon SESでは、静的認証情報の使用はお勧めしません。「」を参照してください。AWS Secrets Manager は、ハードコードされた認証情報をソースコードから削除してセキュリティ体制を改善する方法を説明します。このチュートリアルは、非本番環境で Amazon SESSMTPインターフェイスをテストする目的でのみ提供されています。

Java

この例では、Eclipse IDEとを使用してJavaMail API、 SMTPインターフェイスSESを使用して Amazon 経由で E メールを送信します。

以下の手順を実行する前に、Amazon Simple Email Service を設定するに記載されている作業を完了します。

Java で Amazon SESSMTPインターフェイスを使用して E メールを送信するには

ウェブブラウザで、 JavaMail GitHub ページに移動します。「アセット」で、javax.mail.jar を選択して最新バージョンのをダウンロードします JavaMail。

重要
このチュートリアルでは、 JavaMail バージョン 1.5 以降が必要です。これらの手順は、 JavaMail バージョン 1.6.1 を使用してテストされました。
ウェブブラウザで Jakarta アクティベーション GitHub ページに移動し、JavaBeans アクティベーションフレームワーク 1.2.1 最終リリースで jakarta.activation.jar をダウンロードします。
次のステップを実行し、Eclipse でプロジェクトを作成します。
1. Eclipse を起動します。
2. Eclipse で、ファイルを選択し、新規、Java Project の順に選択します。
3. Create a Java Project ダイアログボックスで、プロジェクト名を入力し、次へを選択します。
4. Java Settings ダイアログボックスのライブラリタブを選択します。
5. Classpath を選択し、外部を追加ボタンを使用して 2 つの外部 jar ファイル javax.mail.jar と jakarta.activation.jar JARsを追加します。
6. 外部を追加 JARsを選択します。
7. をダウンロードしたフォルダを参照します JavaMail。javax.mail.jar ファイルを選択し、開くを選択します。
8. Java Settings ダイアログボックスの終了を選択します。
Eclipse で、Package Explorerウィンドウのプロジェクトを展開します。
プロジェクトの下の src ディレクトリを右クリックし、新規、クラスの順に選択します。
New Java Class ダイアログボックスの名前フィールドに AmazonSESSample と入力し、終了を選択します。

A.mazonSESSamplejava の内容全体を次のコードに置き換えます。


import java.util.Properties;

import javax.mail.Message;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;

public class AmazonSESSample {

    // Replace sender@example.com with your "From" address.
    // This address must be verified.
    static final String FROM = "sender@example.com";
    static final String FROMNAME = "Sender Name";
    
    // Replace recipient@example.com with a "To" address. If your account 
    // is still in the sandbox, this address must be verified.
    static final String TO = "recipient@example.com";
    
    // Replace smtp_username with your Amazon SES SMTP user name.
    static final String SMTP_USERNAME = "smtp_username";
      
    // The name of the Configuration Set to use for this message.
    // If you comment out or remove this variable, you will also need to
    // comment out or remove the header below.
    static final String CONFIGSET = "ConfigSet";
    
    // Amazon SES SMTP host name. This example uses the US West (Oregon) region.
    // See https://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html#region-endpoints
    // for more information.
    static final String HOST = "email-smtp.us-west-2.amazonaws.com";
    
    // The port you will connect to on the Amazon SES SMTP endpoint. 
    static final int PORT = 587;
    
    static final String SUBJECT = "Amazon SES test (SMTP interface accessed using Java)";
    
    static final String BODY = String.join(
            System.getProperty("line.separator"),
            "<h1>Amazon SES SMTP Email Test</h1>",
            "<p>This email was sent with Amazon SES using the ", 
            "<a href='https://github.com/javaee/javamail'>Javamail Package</a>",
            " for <a href='https://www.java.com'>Java</a>."
        );

    public static void main(String[] args) throws Exception {

        // Create a Properties object to contain connection configuration information.
        Properties props = System.getProperties();
        props.put("mail.transport.protocol", "smtp");
        props.put("mail.smtp.port", PORT); 
        props.put("mail.smtp.starttls.enable", "true");
        props.put("mail.smtp.auth", "true");

        // Create a Session object to represent a mail session with the specified properties. 
        Session session = Session.getDefaultInstance(props);

        // Create a message with the specified information. 
        MimeMessage msg = new MimeMessage(session);
        msg.setFrom(new InternetAddress(FROM,FROMNAME));
        msg.setRecipient(Message.RecipientType.TO, new InternetAddress(TO));
        msg.setSubject(SUBJECT);
        msg.setContent(BODY,"text/html");
        
        // Add a configuration set header. Comment or delete the 
        // next line if you are not using a configuration set
        msg.setHeader("X-SES-CONFIGURATION-SET", CONFIGSET);
            
        // Create a transport.
        Transport transport = session.getTransport();

        // Get the password 
        String SMTP_PASSWORD = fetchSMTPPasswordFromSecureStorage();
                    
        // Send the message.
        try
        {
            System.out.println("Sending...");
            
            // Connect to Amazon SES using the SMTP username and password you specified above.
            transport.connect(HOST, SMTP_USERNAME, SMTP_PASSWORD);
            
            // Send the email.
            transport.sendMessage(msg, msg.getAllRecipients());
            System.out.println("Email sent!");
        }
        catch (Exception ex) {
            System.out.println("The email was not sent.");
            System.out.println("Error message: " + ex.getMessage());
        }
        finally
        {
            // Close and terminate the connection.
            transport.close();
        }
    }

    static String fetchSMTPPasswordFromSecureStorage() {
        /* IMPLEMENT THIS METHOD */
        // For example, you might fetch it from a secure location or AWS Secrets Manager: https://aws.amazon.com/secrets-manager/
    }
}

mazonSESSample.java で、次の E メールアドレスを独自の値に置き換えます。

重要
E メールアドレスでは、大文字と小文字は区別されます。検証したアドレスと完全に一致することを確認してください。
- sender@example.com – を「From」メールアドレスに置き換えます。このアドレスを確認してから、プログラムを実行してください。詳細については、「Amazon SES の検証済みID」を参照してください。
- recipient@example.com – を「To」メールアドレスに置き換えます。アカウントがサンドボックスにまだある場合は、このアドレスを使用前に確認する必要があります。詳細については、「本番稼働用アクセスをリクエストする (Amazon SESサンドボックスからの移動）」を参照してください。
mazonSESSample.java では、以下を独自の値に置き換えます。
- smtp_username – をSMTPユーザー名認証情報に置き換えます。SMTP ユーザー名の認証情報は 20 文字の文字と数字の文字列であり、わかりやすい名前ではないことに注意してください。
- smtp_password - パスワードを取得`fetchSMTPPasswordFromSecureStorage`するためにを実装します。
（オプション) で Amazon SESSMTPエンドポイントを使用する場合 AWS リージョン以外の email-smtp.us-west-2.amazonaws.com、変数の値を、使用するHOSTエンドポイントに変更します。Amazon がSES利用可能なリージョンのリストについては、「」の「Amazon Simple Email Service (Amazon SES）」を参照してください。 AWS 全般のリファレンス.
（オプション) この E メールを送信するときに設定セットを使用する場合は、変数の値を変更します。ConfigSet を構成セットの名前に。設定セットの詳細については、Amazon での設定セットの使用 SESを参照ください。
mazonSESSample.java を保存します。
プロジェクトを構築するため、プロジェクト、プロジェクトの構築の順に選択します。(このオプションが無効の場合、自動構築が有効になっている可能性があります。)
プログラムを開始して E メールを送信するため、実行を選択した後、もう一度実行を選択します。
出力を確認します。E メールが正常に送信された場合は、コンソールに「E メール送信済み！」と表示されます。それ以外の場合は、エラーメッセージが表示されます。
受信者のアドレスの E メールクライアントにサインインします。送信した E メールメッセージを確認します。

PHP

この例では、 PHPMailer クラスを使用して、 SMTPインターフェイスSESを使用して Amazon 経由で E メールを送信します。

以下の手順を実行する前に、Amazon Simple Email Service を設定するのタスクを完了する必要があります。Amazon の設定に加えて、で E メールを送信するには、次の前提条件を満たすSES必要がありますPHP。

前提条件:

インストール PHP — PHPは http://php.net/downloads.php で入手できます。をインストールしたらPHP、任意のコマンドプロンプトPHPからを実行できるように、環境変数PHPにへのパスを追加します。
Composer 依存関係マネージャーをインストールする – Composer 依存関係マネージャーをインストールしたら、 PHPMailer クラスとその依存関係をダウンロードしてインストールできます。Composer をインストールするには、https://getcomposer.org/download のインストール手順に従ってください。
PHPMailer クラスのインストール – Composer をインストールしたら、次のコマンドを実行してをインストールしますPHPMailer。
```
path/to/composer require phpmailer/phpmailer
```
上記のコマンドで、path/to/ Composer をインストールしたパスを含む。

で Amazon SESSMTPインターフェイスを使用して E メールを送信するには PHP

amazon-ses-smtp-sample.php という名前のファイルを作成します。テキストエディタでファイルを開き、次のコードを貼り付けます。


<?php

// Import PHPMailer classes into the global namespace
// These must be at the top of your script, not inside a function
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

// If necessary, modify the path in the require statement below to refer to the
// location of your Composer autoload.php file.
require 'vendor/autoload.php';

// Replace sender@example.com with your "From" address.
// This address must be verified with Amazon SES.
$sender = 'sender@example.com';
$senderName = 'Sender Name';

// Replace recipient@example.com with a "To" address. If your account
// is still in the sandbox, this address must be verified.
$recipient = 'recipient@example.com';

// Replace smtp_username with your Amazon SES SMTP user name.
$usernameSmtp = 'smtp_username';

// Specify a configuration set. If you do not want to use a configuration
// set, comment or remove the next line.
$configurationSet = 'ConfigSet';

// If you're using Amazon SES in a region other than US West (Oregon),
// replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP
// endpoint in the appropriate region.
$host = 'email-smtp.us-west-2.amazonaws.com';
$port = 587;

// The subject line of the email
$subject = 'Amazon SES test (SMTP interface accessed using PHP)';

// The plain-text body of the email
$bodyText =  "Email Test\r\nThis email was sent through the
    Amazon SES SMTP interface using the PHPMailer class.";

// The HTML-formatted body of the email
$bodyHtml = '<h1>Email Test</h1>
    <p>This email was sent through the
    <a href="https://aws.amazon.com/ses">Amazon SES</a> SMTP
    interface using the <a href="https://github.com/PHPMailer/PHPMailer">
    PHPMailer</a> class.</p>';

$mail = new PHPMailer(true);

try {
    // Specify the SMTP settings.
    $mail->isSMTP();
    $mail->setFrom($sender, $senderName);
    $mail->Username   = $usernameSmtp;
    $mail->Password   = fetchSMTPPasswordFromSecureStorage();
    $mail->Host       = $host;
    $mail->Port       = $port;
    $mail->SMTPAuth   = true;
    $mail->SMTPSecure = 'tls';
    $mail->addCustomHeader('X-SES-CONFIGURATION-SET', $configurationSet);

    // Specify the message recipients.
    $mail->addAddress($recipient);
    // You can also add CC, BCC, and additional To recipients here.

    // Specify the content of the message.
    $mail->isHTML(true);
    $mail->Subject    = $subject;
    $mail->Body       = $bodyHtml;
    $mail->AltBody    = $bodyText;
    $mail->Send();
    echo "Email sent!" , PHP_EOL;
} catch (phpmailerException $e) {
    echo "An error occurred. {$e->errorMessage()}", PHP_EOL; //Catch errors from PHPMailer.
} catch (Exception $e) {
    echo "Email not sent. {$mail->ErrorInfo}", PHP_EOL; //Catch errors from Amazon SES.
}
function fetchSMTPPasswordFromSecureStorage() {
/* IMPLEMENT THIS METHOD */
// For example, you might fetch it from a secure location or AWS Secrets Manager: https://aws.amazon.com/secrets-manager/
}

?>

amazon-ses-smtp-sample.php では、以下を独自の値に置き換えます。
- sender@example.com – Amazon で検証した E メールアドレスに置き換えますSES。詳細については、「検証済みID」を参照してください。Amazon の E メールアドレスでは、大文字と小文字SESが区別されます。検証したアドレスと完全に一致するアドレスを入力してください。
- recipient@example.com – 受信者のアドレスに置き換えます。アカウントがサンドボックスにまだある場合は、このアドレスを使用前に確認する必要があります。詳細については、「本番稼働用アクセスをリクエストする (Amazon SESサンドボックスからの移動）」を参照してください。検証したアドレスと完全に一致するアドレスを入力してください。
- smtp_username – を、Amazon SESコンソールSMTPの設定ページから取得したSMTPユーザー名認証情報に置き換えます。これはと同じではありません。 AWS アクセスキー ID。SMTP ユーザー名の認証情報は 20 文字の文字と数字の文字列であり、わかりやすい名前ではないことに注意してください。
- smtp_password - パスワードを取得`fetchSMTPPasswordFromSecureStorage`するためにを実装します。
- (オプション) ConfigSet – この E メールを送信するときに設定セットを使用する場合は、この値を設定セットの名前に置き換えます。設定セットの詳細については、Amazon での設定セットの使用 SESを参照ください。
- (オプション) email-smtp.us-west-2.amazonaws.com – 米国西部 (オレゴン) 以外のリージョンで Amazon SESSMTPエンドポイントを使用する場合は、使用するリージョンの Amazon SESSMTPエンドポイントに置き換えます。のSMTPエンドポイントのリスト URLs AWS リージョン Amazon SES が利用可能な場所については、「」の「Amazon Simple Email Service (Amazon SES）」を参照してください。 AWS 全般のリファレンス.
amazon-ses-smtp-sample.php を保存します。
プログラムを実行するには、amazon-ses-smtp-sample.php と同じディレクトリでコマンドプロンプトを開き、と入力しますphp amazon-ses-smtp-sample.php。
出力を確認します。E メールが正常に送信された場合は、コンソールに「E メール送信済み！」と表示されます。それ以外の場合は、エラーメッセージが表示されます。
受信者のアドレスの E メールクライアントにサインインします。送信した E メールメッセージを確認します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ソフトウェアパッケージを使用し、E メールを送信する

既存の E メールサーバーと統合する

Amazon SESSMTPインターフェイスを介したプログラムによる E メールの送信

重要

コードの例

注記

警告

Java で Amazon SESSMTPインターフェイスを使用して E メールを送信するには

重要

重要

前提条件:

で Amazon SESSMTPインターフェイスを使用して E メールを送信するには PHP