Contenu des notifications pour la réception d'e-mails via Amazon SES

Toutes les notifications pour la réception d'e-mails sont publiées dans des rubriques Amazon Simple Notification Service (Amazon SNS) au format JavaScript Objet Notation (JSON).

Pour des exemples de notifications, consultez Exemples de notification .

Table des matières

• Objet JSON de niveau supérieur
• Objet receipt
  • Objets action
  • Objet dkimVerdict
  • Objet dmarcVerdict
  • Objet spamVerdict
  • Objet spfVerdict
  • Objet virusVerdict
• Objet mail
  • Objet commonHeaders

Objet JSON de niveau supérieur

L'objet JSON de niveau supérieur contient les champs suivants.

Nom de champ	Description
notificationType	Type de notification. Pour ce type de notification, la valeur est toujours Received.
receipt	Objet qui contient des informations sur la remise de l'e-mail.
mail	Objet qui contient des informations sur l'e-mail auquel la notification est associée.
content	Chaîne qui contient l'e-mail brut non modifié, généralement au format Multipurpose Internet Mail Extensions (MIME). Pour plus de détails sur le format MIME, consultez la spécification RFC 2045. Note Ce champ est disponible uniquement si la notification a été déclenchée par une action SNS. Les notifications déclenchées par toutes les autres actions ne contiennent pas ce champ.

Objet receipt

L'objet receipt comporte les champs suivants.

Nom de champ	Description
action	Objet qui encapsule des informations sur l'action qui a été exécutée. Pour obtenir une liste des valeurs possibles, consultez Objets action.
dkimVerdict	Objet qui indique si le contrôle DKIM (DomainKeys Identified Mail) a réussi. Pour obtenir une liste des valeurs possibles, consultez Objet dkimVerdict.
dmarcPolicy	Indique les paramètres DMARC (Domain-based Message Authentication, Reporting and Conformance) pour le domaine d'envoi. Ce champ apparaît uniquement si le message échoue à l'authentification DMARC. Les valeurs possibles pour ce champ sont les suivantes : none : Le propriétaire du domaine d'envoi demande qu'aucune action spécifique ne soit exécutée sur les messages pour lesquels l'authentification DMARC échoue. quarantine : Le propriétaire du domaine d'envoi demande que les messages pour lesquels l'authentification DMARC échoue soit traités comme étant suspects par les serveurs de messagerie. reject : Le propriétaire du domaine d'envoi demande que les messages pour lesquels l'authentification DMARC échoue soient rejetés.
dmarcVerdict	Objet qui indique si le contrôle DMARC (Domain-based Message Authentication, Reporting and Conformance) a réussi. Pour obtenir une liste des valeurs possibles, consultez Objet dmarcVerdict.
processingTimeMillis	Chaîne qui spécifie le délai, en millisecondes, entre le moment où Amazon SES reçoit le message et le moment où l'action est déclenchée.
recipients	Une liste des destinataires (plus particulièrement les adresses RCPT TO de l'enveloppe) qui ont été retrouvés par la règle de réception active. Les adresses répertoriées ici peuvent être différentes de celles figurant dans le champ destination de l'objet Objet mail.
spamVerdict	Objet qui indique si le message est un courrier indésirable. Pour obtenir une liste des valeurs possibles, consultez Objet spamVerdict.
spfVerdict	Objet qui indique si le contrôle SPF (Sender Policy Framework) a réussi. Pour obtenir une liste des valeurs possibles, consultez Objet spfVerdict.
timestamp	Chaîne qui spécifie la date et l'heure qualifiées auxquelles l'action a été déclenchée, au format ISO 8601.
virusVerdict	Objet qui indique si le message contient un virus. Pour obtenir une liste des valeurs possibles, consultez Objet virusVerdict.

Objets action

L'objet action comporte les champs suivants.

Nom de champ	Description
type	Chaîne qui indique le type d'action exécuté. Les valeurs possibles sont S3, SNS, Bounce, Lambda, Stop et WorkMail.
topicArn	Chaîne qui contient l'ARN (Amazon Resource Name) de la rubrique Amazon SNS où la notification a été publiée.
bucketName	Chaîne qui contient le nom du compartiment Amazon S3 où la notification a été publiée. Présente uniquement pour le type d'action S3.
objectKey	Chaîne qui contient un nom qui identifie l'e-mail dans le compartiment Amazon S3. Cette chaîne est identique à messageId dans l'objet Objet mail. Présente uniquement pour le type d'action S3.
smtpReplyCode	Chaîne qui contient le code de réponse SMTP, tel qu'il a été défini par la spécification RFC 5321. Présente uniquement pour le type de retour à l'expéditeur.
statusCode	Chaîne qui contient le code de statut SMTP amélioré, tel qu'il a été défini par la spécification RFC 3463. Présente uniquement pour le type de retour à l'expéditeur.
message	Chaîne qui contient le texte lisible par l'utilisateur à inclure dans le message de retour à l'expéditeur. Présente uniquement pour le type de retour à l'expéditeur.
sender	Chaîne qui contient l'adresse e-mail de l'expéditeur de l'e-mail renvoyé à l'expéditeur. Il s'agit de l'adresse à partir de laquelle le message de retour à l'expéditeur a été envoyé. Présente uniquement pour le type de retour à l'expéditeur.
functionArn	Chaîne qui contient l'ARN de la fonction Lambda qui a été déclenchée. Présente uniquement pour le type d'action Lambda.
invocationType	Chaîne qui contient le type d'appel de la fonction Lambda. Les valeurs possibles sont RequestResponse et Event. Présente uniquement pour le type d'action Lambda.
organizationArn	Chaîne qui contient l'ARN de l'organisation Amazon WorkMail. Présente uniquement pour le type d'action WorkMail.

Objet dkimVerdict

L'objet dkimVerdict comporte les champs suivants.

Nom de champ

Description

status

Chaîne qui contient le résultat du contrôle DKIM. Les valeurs possibles sont : PASS : Authentification DKIM réussie pour le message. FAIL : Échec de l'authentification DKIM pour le message. GRAY : le message n'est pas signé par DKIM ou le domaine d'origine et le domaine de signature DKIM ne correspondent pas. PROCESSING_FAILED : Un problème empêche Amazon SES de vérifier la signature DKIM. Par exemple, des requêtes DNS sont défaillantes ou l'en-tête de signature DKIM n'est pas formaté correctement.

Objet dmarcVerdict

L'objet dmarcVerdict comporte les champs suivants.

Nom de champ

Description

status

Chaîne qui contient le résultat du contrôle DMARC. Les valeurs possibles sont : PASS : L'authentification DMARC a réussi pour le message. FAIL : L'authentification DMARC a échoué pour le message. GRAY : au moins une authentification SPF ou DKIM a passé l'authentification, mais le domaine d'envoi ne dispose pas d'une politique DMARC ou utilise la politique p=none. PROCESSING_FAILED : Un problème empêche Amazon SES de fournir le résultat d'une authentification DMARC.

Objet spamVerdict

L'objet spamVerdict comporte les champs suivants.

Nom de champ

Description

status

Chaîne qui contient le résultat de la recherche de courrier indésirable. Les valeurs possibles sont : PASS : l'analyse du courrier indésirable a déterminé qu'il était peu probable que le message contienne un courrier indésirable. FAIL : l'analyse du courrier indésirable a déterminé qu'il était probable que le message contienne un courrier indésirable. GRAY : Amazon SES a analysé l'e-mail mais n'a pas pu déterminer avec fiabilité s'il s'agit d'un courrier indésirable. PROCESSING_FAILED : Amazon SES n'a pas pu analyser l'e-mail. Par exemple, l'e-mail n'est pas un message MIME valide.

Objet spfVerdict

L'objet spfVerdict comporte les champs suivants.

Nom de champ	Description
status	Chaîne qui contient le résultat du contrôle SPF. Les valeurs possibles sont : PASS : Authentification SPF réussie pour le message. FAIL : Échec de l'authentification SPF pour le message. GRAY : Le résultat SPF est none, softfail ou neutral. PROCESSING_FAILED : Un problème empêche Amazon SES de vérifier le registre SPF. Par exemple, des requêtes DNS échouent.

Objet virusVerdict

L'objet virusVerdict comporte les champs suivants.

Nom de champ

Description

status

Chaîne qui contient le résultat de la recherche de virus. Les valeurs possibles sont : PASS : Le message ne contient pas de virus. FAIL : Le message contient un virus. GRAY : Amazon SES a analysé l'e-mail mais n'a pas pu déterminer avec fiabilité s'il contient un virus. PROCESSING_FAILED : Amazon SES n'est pas en mesure d'analyser le contenu de l'e-mail. Par exemple, l'e-mail n'est pas un message MIME valide.

Objet mail

L'objet mail comporte les champs suivants.

Nom de champ	Description
destination	Une liste complète de toutes les adresses de destination (y compris des destinataires A : et Cc :) depuis les en-têtes MIME des e-mails entrants.
messageId	Chaîne qui contient l'ID unique attribué à l'e-mail par Amazon SES. Si l'e-mail a été remis à Amazon S3, l'ID de message est également la clé d'objet Amazon S3 qui a été utilisée pour écrire le message dans votre compartiment Amazon S3.
source	Chaîne qui contient l'adresse e-mail (plus spécifiquement l'adresse MAIL FROM de l'enveloppe) à partir de laquelle le message a été envoyé.
timestamp	Chaîne qui contient la date et l'heure auxquelles l'e-mail a été reçu, au format ISO8601.
headers	Les en-têtes Amazon SES et vos en-têtes personnalisés. Chaque en-tête possède les champs suivants : name et value.
commonHeaders	Les en-têtes communs à tous les e-mails. Chaque en-tête possède les champs suivants : name et value.
headersTruncated	Spécifie si les en-têtes ont été tronqués dans la notification, ce qui a lieu si les en-têtes ont une taille supérieure à 10 Ko. Les valeurs possibles sont true et false.

Objet commonHeaders

L'objet commonHeaders peut avoir les champs illustrés dans le tableau suivant. Les champs présents dans cet objet varient selon les champs qui étaient présents dans les e-mails entrants.

Nom de champ	Description
messageId	ID du message original.
date	Date et heure auxquelles Amazon SES a reçu le message.
to	L'en-tête To de l'e-mail.
cc	L'en-tête CC de l'e-mail.
bcc	L'en-tête BCC de l'e-mail.
from	L'en-tête From de l'e-mail.
sender	L'en-tête Sender de l'e-mail.
returnPath	L'en-tête Return-Path de l'e-mail.
replyTo	L'en-tête Reply-To de l'e-mail.
subject	L'en-tête Subject de l'e-mail.