Amazon SES の Amazon SNS 通知の設定 - Amazon Simple Email Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon SES の Amazon SNS 通知の設定

Amazon Simple Notification Service (Amazon SNS)を通して、Amazon SES は、バウンス、苦情、配信を通知します。

通知は Amazon SES コンソールで設定するか、Amazon SES API を使用して設定できます。

前提条件

Amazon SES で Amazon SNS 通知を設定する前に、次のステップを完了します。

  1. Amazon SNS トピックを作成します。詳細については、Amazon Simple Notification Service デベロッパーガイドの「トピックの作成」を参照してください。

    重要

    Amazon SNS を使用してトピックを作成する場合、タイプスタンダードを選択します。(SES は FIFO タイプのトピックをサポートしていません。)

    新しい SNS トピックを作成する場合も、既存のトピックを選択する場合も、トピックに通知を発行するために SES へのアクセスを許可する必要があります。

    トピック に通知を発行するためのアクセス許可をAmazon SES に付与するには、SNS コンソールの [トピ追加ックの編集] 画面で [アクセスポリシー] を展開し、[JSON エディタ] に次の許可ポリシーをします。

    { "Version": "2012-10-17", "Id": "notification-policy", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:topic_region:111122223333:topic_name", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name" } } } ] }

    上のポリシー例に、以下の変更を加えます。

    • topic_region を、SNS トピックを作成した AWS リージョンに置き換えます。

    • 111122223333を自分のAWSアカウント ID に置き換えます。

    • topic_nameは、SNS トピックの名前に置き換えます。

    • identity_nameは、SNS トピックにサブスクライブしている確認済みアイデンティティ (E メールアドレスまたはドメイン) に置き換えます。

  2. 少なくとも 1 つのエンドポイントをトピックにサブスクライブします。たとえば、テキストメッセージで通知を受け取る場合は、トピックに SMS エンドポイント (携帯電話番号) をサブスクライブします。E メールで通知を受信するには、E メールエンドポイント (E メールアドレス) をトピックにサブスクライブします。

    詳細については、Amazon Simple Notification Service デベロッパーガイドの「作業スタート」を参照してください。

  3. (オプション) Amazon SNS トピックでサーバー側の暗号化にAWS Key Management Service(AWS KMS)を使用する場合は、 AWS KMSキーポリシーにアクセス許可を追加する必要があります。アクセス権限を追加するには、次のポリシーをAWS KMSキーポリシーにアタッチします。

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESToUseKMSKey", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] }

Amazon SES コンソールを使用した通知の設定

Amazon SES コンソールを使用して通知を設定するには
  1. Amazon SES コンソール (https://console.aws.amazon.com/ses/) を開きます。

  2. ナビゲーションペインの [設定] で、検証済みIDを選択します。

  3. [Identities] (ID) コンテナで、この ID の結果から送信されたメッセージがバウンス、苦情、または配信になったときのフィードバック通知を受信する検証済み ID を選択します。

    重要

    確認済みドメイン通知設定は、同様に確認済みの E メールアドレスを除き、そのドメインの E メールアドレスから送信されるすべてのメールに適用されます。

  4. 選択した検証済み ID の詳細画面で、[Notifications] (通知) タブを選択し、[Feedback notifications] (フィードバック通知) コンテナの [Edit] (編集) を選択します。

  5. 通知を受信する各フィードバックタイプの SNS トピックリストボックスを展開し、[SNS topic you own] (所有する SNS トピック)、[No SNS topic] (SNS トピックなし)、または [SNS topic you don't own] (所有していない SNS トピック) のいずれかを選択します。

    1. [SNS topic you don't own] (所有していない SNS トピック) を選択した場合、SNS トピックの ARN フィールドが表示され、そこで代理送信者が共有する SNS トピックの ARN を入力する必要があります。(代理送信者が SNS トピックを所有するため、これらの通知は代理送信者だけが受け取ります。代理送信の詳細については、「送信承認の概要」を参照してください)。

    重要

    バウンス、苦情、配信の通知に使用する Amazon SNS トピックは、Amazon SES を使用するのと同じAWS リージョンに含まれている必要があります。

    さらに、通知を受け取るには、1 つ以上のエンドポイントをトピックにサブスクライブしている必要があります。たとえば、E メールアドレスに通知を送信する場合は、E メールエンドポイントをそのトピックにサブスクライブする必要があります。詳細については、『Amazon Simple Notification Service デベロッパーガイド』の「作業スタート」を参照してください。

  6. (オプション) 元の E メールのヘッダーをトピック通知に含める場合は、各フィードバックタイプの SNS トピック名のすぐ下にある [Include original email headers] (元の E メールヘッダーを含める) ボックスにチェックを入れます。このオプションは、その通知タイプに Amazon SNS トピックを割り当てている場合にのみ使用できます。元の E メールヘッダーの内容については、通知の内容mail オブジェクトを参照してください。

  7. [Save changes] (変更の保存) をクリックします。通知設定に対する変更は、反映されるまでに数分かかる場合があります。

  8. (オプション) バウンスと苦情の両方で Amazon SNS トピック通知を選択した場合、すべての E メール通知を無効にして、E メール通知と SNS 通知を重複して受け取らないようにすることができます。バウンスや苦情に関する E メール通知を無効にするには、[Email Feedback Forwarding] (E メールのフィードバック転送) コンテナの検証済み ID の詳細画面にある [Notifications] (通知) タブで、[Edit] (編集) を選択し、[Enabled] (有効) ボックスのチェックを外して、[Save changes] (変更を保存) を選択します。

設定の完了後は、返送、苦情、配信の通知が Amazon SNS トピックに送られるようになります。これらの通知は JavaScript Object Notation (JSON) 形式になっており、「通知の内容」で説明されている構造に従っています。

バウンス、苦情、配信の通知には、Amazon SNS のスタンダードレートが課金されます。詳細については、「Amazon SNS 料金ページ」を参照してください。

注記

トピックが削除されたか、AWS アカウント に発行する許可がないため、Amazon SNS トピックへの発行が失敗した場合、設定がバウンスまたは苦情に設定されているとき (配信ではない場合。配信通知の場合、SES は SNS トピックの設定を削除しません) には、Amazon SES がその設定を削除します。さらに、Amazon SES が ID のバウンスと苦情の E メール通知を再度有効にし、ユーザーは変更の通知を E メールで受け取ります。トピックを使用するように複数の ID が設定されている場合、各 ID でトピックへの発行に失敗すると、各 ID のトピック設定が変更されます。

Amazon SES API を使用した通知の設定

バウンス、苦情、配信の通知は、Amazon SES API を使用して設定することもできます。次のオペレーションを使用して通知を設定します。

これらの API アクションを使用して、通知用にカスタマイズしたフロントエンドアプリケーションを作成することができます。通知に関連する API アクションの詳しい説明については、Amazon Simple Email Service API リファレンスを参照してください。

フィードバック通知のトラブルシューティング

通知が送られてこない

通知を受け取っていない場合は、通知が送信されるトピックにエンドポイントをサブスクライブしていることを確認します。E メールエンドポイントをトピックにサブスクライブすると、サブスクリプションの確認を求める E メールが届きます。E メール通知の受信を開始するには、サブスクリプションを確認する必要があります。詳細については、『Amazon Simple Notification Service デベロッパーガイド』の「作業スタート」を参照してください。

InvalidParameterValue トピックを選択する際にエラーが発生する

InvalidParameterValue エラーが発生したことを示すエラーを受け取った場合は、Amazon SNS トピックが AWS KMS を使用して暗号化されているかどうかをチェックします。暗号化されている場合は、その AWS KMS キーのポリシーを変更する必要があります。サンプルポリシーについては、「前提条件」を参照してください。