Configuration des notifications Amazon SNS pour Amazon SES

Amazon SES peut vous informer de vos retours à l'expéditeur, réclamations et remises via Amazon Simple Notification Service (Amazon SNS).

Vous pouvez configurer des notifications dans la console Amazon SES ou à l'aide de l'API Amazon SES.

Prérequis

Complétez les étapes suivantes avant de configurer des notifications Amazon SNS dans Amazon SES :

1. Créez une rubrique dans Amazon SNS. Pour en savoir plus, consultez Création d'une rubrique dans le Manuel du développeur d'Amazon Simple Notification Service.

   Important

   Lorsque vous créez votre rubrique à l'aide d'Amazon SNS, pour Type, choisissez uniquement Standard. (SES ne prend pas en charge les rubriques de type FIFO.)

   Que vous créiez une nouvelle rubrique SNS ou sélectionniez une rubrique existante, vous devez donner un accès à SES pour publier des notifications sur la rubrique.

   Pour donner à Amazon SES la permission de publier des notifications sur la rubrique, sur l'écran Edit topic (Modifier la rubrique) de la console SNS, développez Access policy (Stratégie d'accès) et dans JSON editor (Éditeur JSON), ajoutez la stratégie de l'autorisation suivante :

   {
     "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"
           }
         }
       }
     ]
   }

   Dans l'exemple précédent, apportez les modifications suivantes :

   • Remplacez topic_region par la région dans laquelle vous avez créé le sujet SNS. AWS

   • Remplacez 111122223333 par votre ID de compte AWS .

   • Remplacez topic_name par le nom de votre rubrique SNS.

   • Remplacez identity_name par l'identité vérifiée (adresse e-mail ou domaine) que vous inscrivez à la rubrique SNS.

2. Abonnez au moins un point de terminaison pour la rubrique. Par exemple, si vous voulez recevoir des notifications par SMS, abonnez un point de terminaison SMS (c'est-à-dire, un numéro de téléphone portable) à la rubrique. Pour recevoir des notifications par e-mail, abonnez un point de terminaison de messagerie (une adresse e-mail) à la rubrique.

   Pour en savoir plus, consultez Mise en route dans le Guide du développeur Amazon Simple Notification Service.

3. (Facultatif) Si votre rubrique Amazon SNS utilise AWS Key Management Service (AWS KMS) pour le chiffrement côté serveur, vous devez ajouter des autorisations à la politique clé. AWS KMS Vous pouvez ajouter des autorisations en joignant la politique suivante à la politique AWS KMS clé :

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

Configuration de notifications à l'aide de la console Amazon SES

Pour configurer des notifications à l'aide de la console Amazon SES

1. Ouvrez la console Amazon SES à l'adresse https://console.aws.amazon.com/ses/.

2. Dans le panneau de navigation, sous Configuration, choisissez Verified identities (Identités vérifiées).

3. Dans le conteneur Identities (Identités), sélectionnez l'identité vérifiée pour laquelle vous souhaitez recevoir des notifications de commentaires lorsqu'un message envoyé à partir de cette identité entraîne un retour à l'expéditeur, une réclamation ou une remise.

   Important

   Les paramètres de notification de domaine vérifié s'appliquent à tous les e-mails envoyés depuis les adresses de ce domaine, à l'exception des adresses qui sont également vérifiées.

4. Dans l'écran de détails de l'identité vérifiée que vous avez sélectionnée, choisissez l'onglet Notifications (Notifications) et sélectionnez Edit (Modifier) dans le conteneur Feedback notifications (Notifications de commentaire).

5. Développez la zone de liste des rubriques SNS de chaque type de commentaires pour lequel vous souhaitez recevoir des notifications et sélectionnez soit une rubrique SNS dont vous êtes propriétaire, soit No SNS topic (Aucun sujet SNS), ou SNS topic you don't own (Sujet SNS dont vous n'êtes pas propriétaire).

   1. Si vous avez choisi SNS topic you don't own (Sujet SNS dont vous n'êtes pas propriétaire), le champ ARN de rubrique SNS sera présenté et vous devrez entrer l'ARN de la rubrique SNS partagé avec vous par votre expéditeur délégué. (Seul l'expéditeur délégué recevra ces notifications, car il est propriétaire de la rubrique SNS. Pour en savoir plus sur l'envoi des délégués, consultez Présentation de l'autorisation d'envoi.)

   Important

   Les rubriques Amazon SNS que vous utilisez pour les notifications de rebond, de réclamation et de livraison doivent être identiques à celles dans Région AWS lesquelles vous utilisez Amazon SES.

   De plus, vous devez abonner un ou plusieurs points de terminaison à la rubrique afin de recevoir des notifications. Par exemple, si vous voulez que des notifications soient envoyées à une adresse e-mail, vous devez abonner un point de terminaison de messagerie à la rubrique. Pour en savoir plus, consultez Mise en route dans le Guide du développeur Amazon Simple Notification Service.

6. (Facultatif) Si vous souhaitez que votre notification de rubrique inclue les en-têtes de l'e-mail d'origine, cochez la case Include original email headers (Incluez les en-têtes d'e-mail d'origine) située directement sous le nom de rubrique SNS de chaque type de commentaires. Cette option est disponible uniquement si vous avez affecté une rubrique Amazon SNS au type de notification associé. Pour en savoir plus sur le contenu des en-têtes de l'e-mail d'origine, consultez l'objet mail dans Contenu des notifications .

7. Sélectionnez Enregistrer les modifications. L'application des modifications que vous apportez à vos paramètres de notification peut prendre quelques minutes.

8. (Facultatif) Si vous avez choisi les notifications de rubriques Amazon SNS à la fois pour les retours à l'expéditeur et les réclamations, vous pouvez désactiver entièrement les notifications par e-mail afin de ne pas recevoir de doubles notifications par e-mail et par SNS. Pour désactiver les notifications par e-mail pour les retours à l'expéditeur et les réclamations, sous l'onglet Notifications (Notifications) sur l'écran de détails de l'identité vérifiée, dans le conteneur Email Feedback Forwarding (Transfert de commentaires par e-mail), choisissez Edit (Modifier), décochez la case Enabled (Activé), et choisissez Save changes (Enregistrer les modifications).

Une fois que vous avez configuré vos paramètres, vous allez commencer à recevoir des notifications de retour à l'expéditeur, de réclamation et/ou de remise, dans vos rubriques Amazon SNS. Ces notifications sont au format JSON ( JavaScriptObject Notation) et suivent la structure décrite dansContenu des notifications .

Vous serez facturé selon les tarifs Amazon SNS standard pour les notifications de retour à l'expéditeur, de réclamation et de remise. Pour en savoir plus, consultez la page Tarification d'Amazon SNS.

Note

Si une tentative de publication sur votre rubrique Amazon SNS échoue parce que la rubrique a été supprimée ou que vous Compte AWS n'êtes plus autorisé à publier sur cette rubrique, Amazon SES supprime la configuration de cette rubrique si elle a été configurée pour les rebonds ou les réclamations (et non pour les livraisons. Pour les notifications de livraison, SES ne supprimera pas le paramètre de configuration de la rubrique SNS). De plus, Amazon SES réactive les notifications par e-mail de retour à l'expéditeur et de réclamation pour l'identité, et vous recevez une notification de modification par e-mail. Si plusieurs identités sont configurées pour utiliser la rubrique, la configuration de rubrique de chaque identité est modifiée lorsque l'identité ne parvient pas à publier dans la rubrique.

Configuration de notifications à l'aide de l'API Amazon SES

Vous pouvez également configurer des notifications de retour à l'expéditeur, de réclamation et de remise à l'aide de l'API Amazon SES. Utilisez les opérations suivantes pour configurer des notifications :

• SetIdentityNotificationTopic

• SetIdentityFeedbackForwardingEnabled

• GetIdentityNotificationAttributes

• SetIdentityHeadersInNotificationsEnabled

Vous pouvez utiliser ces actions d'API pour écrire une application frontale personnalisée pour les notifications. Pour une description complète des actions d'API liées aux notifications, consultez le document Amazon Simple Email Service API Reference.

Dépannage des notifications de commentaire

Pas de réception de notifications

Si vous ne recevez pas de notifications, vérifiez que vous avez abonné un point de terminaison à la rubrique via laquelle les notifications sont envoyées. Lorsque vous abonnez un point de terminaison de messagerie à une rubrique, vous recevez un e-mail vous demandant de confirmer votre abonnement. Vous devez confirmer votre abonnement avant de commencer à recevoir des notifications par e-mail. Pour en savoir plus, consultez Mise en route dans le Guide du développeur Amazon Simple Notification Service.

InvalidParameterValueErreur lors du choix d'une rubrique

Si vous recevez une erreur indiquant qu'une erreur InvalidParameterValue s'est produite, vérifiez la rubrique Amazon SNS pour voir si elle est chiffrée via AWS KMS. Si c'est le cas, vous devez modifier la politique de la AWS KMS clé. Consultez Prérequis pour obtenir un exemple de stratégie.