コマンドラインを使用して Amazon SES SMTP インターフェイスへの接続をテストする - Amazon Simple Email Service

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

コマンドラインを使用して 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 -connect email-smtp.us-west-2.amazonaws.com:587

    前述のコマンドで、email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域。詳細については、リージョンと 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 -connect email-smtp.us-west-2.amazonaws.com:465

    前述のコマンドで、email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域。詳細については、リージョンと 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 インターフェイスに接続するには

  • PowerShell で、次のコマンドを入力して Amazon SES SMTP サーバーに接続します。

    Test-NetConnection -Port 587 -ComputerName email-smtp.us-west-2.amazonaws.com

    前述のコマンドで、email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域、および置換 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 SESSMTP サーバーに接続すると、サーバーは SMTP 対話が発生することを予想します。

OpenSSL を使用して SMTP インターフェイスに接続する場合は、base64 エンコードを使用して SMTP 認証情報をエンコードする必要があります。このセクションでは、base64 を使用して認証情報をエンコードする手順を示します。

SMTP インターフェイスを使用してコマンドラインから E メールを送信するには

  1. コマンドラインで、次のコマンドを入力して SMTP ユーザー名をエンコードします。この際、SMTPUsername をお使いの SMTP ユーザー名に置き換えます。

    echo -n "SMTPUsername" | openssl enc -base64

    このコマンド出力を書き留めます。

  2. コマンドラインで、次のコマンドを入力して SMTP パスワードをエンコードします。この際、SMTPPassword をお使いの SMTP パスワードに置き換えます。

    echo -n "SMTPPassword" | openssl enc -base64

    このコマンド出力を書き留めます。

  3. テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。

    EHLO example.com AUTH LOGIN Base64EncodedSMTPUserName Base64EncodedSMTPPassword MAIL FROM: sender@example.com RCPT TO: recipient@example.com DATA X-SES-CONFIGURATION-SET: ConfigSet From: Sender Name <sender@example.com> To: recipient@example.com Subject: Amazon SES SMTP Test This message was sent using the Amazon SES SMTP interface. . QUIT
  4. 前のステップで作成したファイルを次のように変更します。

    • 置換 example.com 送信ドメインで。

    • 置換 Base64EncodedSMTPUserName Base64でエンコードされたSMTPユーザー名を使用します。

    • 置換 Base64EncodedSMTPPassword Base64でエンコードされたSMTPパスワードを使用します。

    • 置換 sender@example.com 送信元のメールアドレスで送信します。この ID は検証する必要があります。

    • 置換 recipient@example.com 宛先の電子メールアドレスで指定します。Amazon SES アカウントがサンドボックスにまだある場合は、このアドレスも検証済みである必要があります。

    • 置換 ConfigSet の名前で 構成セット このEメールを送信するときに使用します。

      注記

      設定セットを使用しない場合は、X-SES-CONFIGURATION-SET で始まる行全体を省略できます。

    終了したら、input.txt としてファイルを保存します。

  5. コマンドラインで、次のいずれかのオプションを選択します。

    • 明示的な SSL を使用してポート 587 経由で送信するには – 次のコマンドを入力します。

      openssl s_client -crlf -quiet -starttls smtp -connect email-smtp.us-west-2.amazonaws.com:587 < input.txt
    • 暗黙的な SSL を使用してポート 465 経由で送信するには – 次のコマンドを入力します。

      openssl s_client -crlf -quiet -connect email-smtp.us-west-2.amazonaws.com:465 < input.txt
    注記

    置換 email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域。詳細については、リージョンと Amazon SES を参照してください。

    メッセージが Amazon SES によって受け入れられた場合は、次の例のような出力が表示されます。

    250 Ok 01010160d7de98d8-21e57d9a-JZho-416c-bbe1-8ebaAexample-000000

    250 Ok に続く数字の文字列とテキストは、E メールのメッセージ ID です。

    注記

    約 10 秒間何もしないと、接続は自動的に終了します。

PowerShell

Net.Mail.SmtpClient クラスを使用すると、明示的な SSL を通じてポート 587 経由で E メールを送信できます。

注記

Net.Mail.SmtpClient クラスは正式に廃止されており、Microsoft はサードパーティー製のライブラリを使用することを推奨しています。このコードはテスト専用であり、本番環境用のワークロードには使用しないでください。

明示的な SSL を使用して PowerShell 経由で E メールを送信するには

  1. テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。

    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 としてファイルを保存します。

  2. 前のステップで作成したファイルを次のように変更します。

    • 置換 sender@example.com メッセージの送信元の電子メールアドレス。

    • 置換 recipient@example.com メッセージの送信先の電子メールアドレス。

    • 置換 email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域。詳細については、リージョンと Amazon SES を参照してください。

  3. PowerShell で次のコマンドを入力します。

    .\path\to\SendEmail.ps1

    前述のコマンドで、path\to\SendEmail.ps1 ステップ 1 で作成したファイルへのパス。

  4. プロンプトが表示されたら、SMTP ユーザー名とパスワードを入力します。

または、System.Web.Mail.SmtpMail クラスを使用して、ポート 465 経由で暗黙的な SSL を通じて E メールを送信することもできます。

注記

System.Web.Mail.SmtpMail クラスは正式に廃止されており、Microsoft はサードパーティー製のライブラリを使用することを推奨しています。このコードはテスト専用であり、本番環境用のワークロードには使用しないでください。

暗黙的な SSL を使用して PowerShell 経由で E メールを送信するには

  1. テキストエディタで新規ファイルを作成します。ファイルに次のコードを貼り付けます。

    [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 としてファイルを保存します。

  2. 前のステップで作成したファイルを次のように変更します。

    • 置換 sender@example.com メッセージの送信元の電子メールアドレス。

    • 置換 recipient@example.com メッセージの送信先の電子メールアドレス。

    • 置換 email-smtp.us-west-2.amazonaws.com の URL を含む Amazon SES SMTP エンドポイント AWS 地域。詳細については、リージョンと Amazon SES を参照してください。

  3. PowerShell で次のコマンドを入力します。

    .\path\to\SendEmail.ps1

    前述のコマンドで、path\to\SendEmail.ps1 ステップ 1 で作成したファイルへのパス。

  4. プロンプトが表示されたら、SMTP ユーザー名とパスワードを入力します。