Amazon SES Classic のユーザーガイドです。更新プログラムや新機能は、推奨している新しい Amazon SES デベロッパーガイドに記述されています。
コマンドラインを使用して Amazon SES SMTP インターフェイスへの接続をテストする
Amazon SES SMTP インターフェイスは、オペレーティングシステムのコマンドラインから操作できます。このセクションで説明する方法は、Amazon SES SMTP エンドポイントへの接続のテスト、SMTP 認証情報の検証、および接続問題のトラブルシューティングでの使用を目的としています。以下の手順では、代表的なオペレーティングシステムに搭載されているツールやライブラリを使用します。
SMTP 接続問題のトラブルシューティングの詳細については、「Amazon SES SMTP の問題」を参照してください。
Prerequisites
Amazon SES SMTP インターフェイスに接続するときは、SMTP 認証情報のセットを指定する必要があります。SMTP 認証情報は、標準の AWS 認証情報とは異なります。2 つのタイプの認証情報は、一方をもう一方の代わりに使用することはできません。SMTP 認証情報を取得する方法の詳細については、「Amazon SES SMTP 認証情報を取得」を参照してください。
Amazon SES SMTP インターフェイスへの接続のテスト
コマンドラインを使用すると、認証情報の入力やメッセージの送信を行うことなく、Amazon SES SMTP インターフェイスへの接続をテストできます。この手順は、基本的な接続問題のトラブルシューティングに役立ちます。
このセクションでは、OpenSSL (ほとんどの Linux、macOS、Unix ディストリビューションに搭載され、Windows でも使用可能) と PowerShell
の Test-NetConnection コマンドレット (ほとんどの最新バージョンの Windows に搭載) の両方を使用して接続をテストする手順を示します。
- Linux, macOS, or Unix
-
OpenSSL を使用して Amazon SES SMTP インターフェイスに接続するには、ポート 587 経由で明示的な SSL を使用する方法と、ポート 465 経由で暗黙的な SSL を使用する方法の 2 つがあります。
明示的な SSL を使用して SMTP インターフェイスに接続するには
-
コマンドラインで、次のコマンドを入力して Amazon SES SMTP サーバーに接続します。
openssl s_client -crlf -quiet -starttls smtp -connectemail-smtp.us-west-2.amazonaws.com:587上のコマンドで、
email-smtp.us-west-2.amazonaws.comを、使用する AWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換えます。詳細については、「リージョンと Amazon SES」を参照してください。正常に接続されると次のような出力が表示されます。
depth=2 C = US, O = Amazon, CN = Amazon Root CA 1 verify return:1 depth=1 C = US, O = Amazon, OU = Server CA 1B, CN = Amazon verify return:1 depth=0 CN = email-smtp.us-west-2.amazonaws.com verify return:1 250 Ok約 10 秒間何もしないと、接続は自動的に終了します。
または、暗黙的な SSL を使用して、ポート 465 経由で SMTP インターフェイスに接続することもできます。
暗黙的な SSL を使用して SMTP インターフェイスに接続するには
-
コマンドラインで、次のコマンドを入力して Amazon SES SMTP サーバーに接続します。
openssl s_client -crlf -quiet -connectemail-smtp.us-west-2.amazonaws.com:465上のコマンドで、
email-smtp.us-west-2.amazonaws.comを、使用する AWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換えます。詳細については、「リージョンと Amazon SES」を参照してください。正常に接続されると次のような出力が表示されます。
depth=2 C = US, O = Amazon, CN = Amazon Root CA 1 verify return:1 depth=1 C = US, O = Amazon, OU = Server CA 1B, CN = Amazon verify return:1 depth=0 CN = email-smtp.us-west-2.amazonaws.com verify return:1 220 email-smtp.amazonaws.com ESMTP SimpleEmailService-d-VCSHDP1YZ A1b2C3d4E5f6G7h8I9j0約 10 秒間何もしないと、接続は自動的に終了します。
-
- PowerShell
-
PowerShell の Test-NetConnection
コマンドレットを使用して Amazon SES SMTP サーバーに接続します。 注記 Test-NetConnectionコマンドレットでは、コンピュータが Amazon SES SMTP エンドポイントに接続できるかどうかを判断できます。ただし、コンピュータが SMTP エンドポイントに暗黙的な SSL 接続や明示的な SSL 接続を確立できるかどうかはテストしません。SSL 接続をテストするには、OpenSSL for Windows をインストールするか、「コマンドラインを使用し、Amazon SES SMTP インターフェイスを介して E メールを送信する」の手順を実行して、テスト E メールを送信できます。Test-NetConnectionコマンドレットを使用して SMTP インターフェイスに接続するには-
Amazon SES で、次のコマンドを入力して Amazon SES SMTP サーバーに接続します。
Test-NetConnection -Port587-ComputerNameemail-smtp.us-west-2.amazonaws.com上記のコマンドで、
email-smtp.us-west-2.amazonaws.comを AWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換え、587 をポート番号に置き換えます。Amazon SES のリージョンのエンドポイントの詳細については、の「リージョンと Amazon SES」を参照してください。接続に成功すると、次の例のような出力が表示されます。
ComputerName : email-smtp.us-west-2.amazonaws.com RemoteAddress : 198.51.100.126 RemotePort : 587 InterfaceAlias : Ethernet SourceAddress : 203.0.113.46 TcpTestSucceeded : True
-
コマンドラインを使用し、Amazon SES SMTP インターフェイスを介して E メールを送信する
コマンドラインを使用して、Amazon SES SMTP インターフェイスを介してメッセージを送信することもできます。この手順は、SMTP 認証情報をテストする場合や、Amazon SES を使用して送信するメッセージを特定の受信者が受信できるかどうかをテストする場合に役立ちます。
- Linux, macOS, or Unix
-
E メール送信者が SMTP サーバーに接続すると、クライアントはスタンダードなリクエストのセットを発行し、サーバーは各リクエストにスタンダードのレスポンスで応答します｡ この一連のリクエストとレスポンスは SMTP 対話と呼ばれます。OpenSSL を使用して Amazon SES SMTP サーバーに接続すると、サーバーは SMTP 対話が発生することを予想します｡
OpenSSL を使用して SMTP インターフェイスに接続する場合は、base64 エンコードを使用して SMTP 認証情報をエンコードする必要があります。このセクションでは、base64 を使用して認証情報をエンコードする手順を示します。
SMTP インターフェイスを使用してコマンドラインから E メールを送信するには
-
コマンドラインで、次のコマンドを入力して SMTP ユーザー名をエンコードします。この際、
SMTPUsernameecho -n "SMTPUsername" | openssl enc -base64このコマンド出力を書き留めます。
-
コマンドラインで、次のコマンドを入力して SMTP パスワードをエンコードします。この際、
SMTPPasswordecho -n "SMTPPassword" | openssl enc -base64このコマンド出力を書き留めます。
-
テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。
EHLOexample.comAUTH LOGINBase64EncodedSMTPUserNameBase64EncodedSMTPPasswordMAIL FROM:sender@example.comRCPT TO:recipient@example.comDATA X-SES-CONFIGURATION-SET:ConfigSetFrom:Sender Name<sender@example.com> To:recipient@example.comSubject: Amazon SES SMTP Test This message was sent using the Amazon SES SMTP interface. . QUIT -
前のステップで作成したファイルを次のように変更します。
-
example.comを送信ドメインに置き換えます。 -
Base64EncodedSMTPUserNameをお使いの base64 エンコード SMTP ユーザー名に置き換えます。 -
Base64EncodedSMTPPasswordをお使いの base64 エンコード SMTP パスワードに置き換えます。 -
sender@example.comを送信元 E メールアドレスに置き換えます。この ID は検証する必要があります。 -
recipient@example.comを送信先アドレスに置き換えます。Amazon SES アカウントがサンドボックスにまだある場合は、このアドレスも検証済みである必要があります。 -
ConfigSetを、この E メールを送信する際に使用する設定セットの名前に置き換えます。注記 設定セットを使用しない場合は、
X-SES-CONFIGURATION-SETで始まる行全体を省略できます。
終了したら、
input.txtとしてファイルを保存します。 -
-
コマンドラインで、次のいずれかのオプションを選択します。
-
明示的な SSL を使用してポート 587 経由で送信するには 次のコマンドを入力します。
openssl s_client -crlf -quiet -starttls smtp -connectemail-smtp.us-west-2.amazonaws.com:587 < input.txt -
暗黙的な SSL を使用してポート 465 経由で送信するには 次のコマンドを入力します。
openssl s_client -crlf -quiet -connectemail-smtp.us-west-2.amazonaws.com:465 < input.txt
注記 email-smtp.us-west-2.amazonaws.comAWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換えます。詳細については、「リージョンと Amazon SES」を参照してください。メッセージが Amazon SES によって受け入れられた場合は、次の例のような出力が表示されます。
250 Ok 01010160d7de98d8-21e57d9a-JZho-416c-bbe1-8ebaAexample-000000250 Okに続く数字の文字列とテキストは、E メールのメッセージ ID です。注記 約 10 秒間何もしないと、接続は自動的に終了します。
-
-
- PowerShell
-
Net.Mail.SmtpClient
クラスを使用すると、明示的な SSL を通じてポート 587 経由で E メールを送信できます。 注記 Net.Mail.SmtpClientクラスは正式に廃止されており、Microsoft はサードパーティー製のライブラリを使用することを推奨しています。このコードはテスト専用であり、本番環境用のワークロードには使用しないでください。明示的な SSL を使用して PowerShell 経由で E メールを送信するには
-
テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。
function SendEmail($Server, $Port, $Sender, $Recipient, $Subject, $Body) { $Credentials = [Net.NetworkCredential](Get-Credential) $SMTPClient = New-Object Net.Mail.SmtpClient($Server, $Port) $SMTPClient.EnableSsl = $true $SMTPClient.Credentials = New-Object System.Net.NetworkCredential($Credentials.Username, $Credentials.Password); try { Write-Output "Sending message..." $SMTPClient.Send($Sender, $Recipient, $Subject, $Body) Write-Output "Message successfully sent to $($Recipient)" } catch [System.Exception] { Write-Output "An error occurred:" Write-Error $_ } } function SendTestEmail(){ $Server = "email-smtp.us-west-2.amazonaws.com" $Port = 587 $Subject = "Test email sent from Amazon SES" $Body = "This message was sent from Amazon SES using PowerShell (explicit SSL, port 587)." $Sender = "sender@example.com" $Recipient = "recipient@example.com" SendEmail $Server $Port $Sender $Recipient $Subject $Body } SendTestEmail終了したら、
SendEmail.ps1としてファイルを保存します。 -
前のステップで作成したファイルを次のように変更します。
-
sender@example.comを、メッセージの送信元の E メールアドレスに置き換えます。 -
recipient@example.comをメッセージの送信先アドレスに置き換えます。 -
email-smtp.us-west-2.amazonaws.comwith the URL of the Amazon SES SMTP endpoint for your AWS Region.を AWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換えます。詳細については、「リージョンと Amazon SES」を参照してください。
-
-
PowerShell を使用して、次のコマンドを入力します。
.\path\to\SendEmail.ps1上のコマンドで、
path\to\SendEmail.ps1をステップ 1 で作成したファイルへのパスに置き換えます。 -
プロンプトが表示されたら、SMTP ユーザー名とパスワードを入力します。
または、System.Web.Mail.SmtpMail
クラスを使用して、ポート 465 経由で暗黙的な SSL を通じて E メールを送信することもできます。 注記 System.Web.Mail.SmtpMailクラスは正式に廃止されており、Microsoft はサードパーティー製のライブラリを使用することを推奨しています。このコードはテスト専用であり、本番環境用のワークロードには使用しないでください。暗黙的な SSL を使用して PowerShell 経由で E メールを送信するには
-
テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。
[System.Reflection.Assembly]::LoadWithPartialName("System.Web") > $null function SendEmail($Server, $Port, $Sender, $Recipient, $Subject, $Body) { $Credentials = [Net.NetworkCredential](Get-Credential) $mail = New-Object System.Web.Mail.MailMessage $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpserver", $Server) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpserverport", $Port) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpusessl", $true) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendusername", $Credentials.UserName) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendpassword", $Credentials.Password) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpconnectiontimeout", $timeout / 1000) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendusing", 2) $mail.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpauthenticate", 1) $mail.From = $Sender $mail.To = $Recipient $mail.Subject = $Subject $mail.Body = $Body try { Write-Output "Sending message..." [System.Web.Mail.SmtpMail]::Send($mail) Write-Output "Message successfully sent to $($Recipient)" } catch [System.Exception] { Write-Output "An error occurred:" Write-Error $_ } } function SendTestEmail(){ $Server = "email-smtp.us-west-2.amazonaws.com" $Port = 465 $Subject = "Test email sent from Amazon SES" $Body = "This message was sent from Amazon SES using PowerShell (implicit SSL, port 465)." $Sender = "sender@example.com" $Recipient = "recipient@example.com" SendEmail $Server $Port $Sender $Recipient $Subject $Body } SendTestEmail終了したら、
SendEmail.ps1としてファイルを保存します。 -
前のステップで作成したファイルを次のように変更します。
-
sender@example.comを、メッセージの送信元の E メールアドレスに置き換えます。 -
recipient@example.comをメッセージの送信先アドレスに置き換えます。 -
email-smtp.us-west-2.amazonaws.comwith the URL of the Amazon SES SMTP endpoint for your AWS Region.を AWS リージョンの Amazon SES SMTP エンドポイントの URL に置き換えます。詳細については、「リージョンと Amazon SES」を参照してください。
-
-
PowerShell を使用して、次のコマンドを入力します。
.\path\to\SendEmail.ps1上のコマンドで、
path\to\SendEmail.ps1をステップ 1 で作成したファイルへのパスに置き換えます。 -
プロンプトが表示されたら、SMTP ユーザー名とパスワードを入力します。
-
