Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Options d'action Chaque règle de réception pour la réception d'e-mails via Amazon SES contient une liste ordonnée d'actions. Cette section décrit les options spécifiques pour chaque type d'action. Les types d'action sont les suivants : + [Action d'ajout d'en-tête](receiving-email-action-add-header.md) + [Action de réponse au retour à l'expéditeur](receiving-email-action-bounce.md) + [Invoquer l'action de fonction Lambda](receiving-email-action-lambda.md) + [Livrer à l'action du compartiment S3](receiving-email-action-s3.md) + [Publie dans une action de rubrique Amazon SNS.](receiving-email-action-sns.md) + [Arrêt de l'action de jeu de règles](receiving-email-action-stop.md) + [Intégrer à Amazon WorkMail Action](receiving-email-action-workmail.md) # Action d'ajout d'en-tête L'action **Add Header (Ajouter un en-tête)** ajoute un en-tête personnalisé à l'e-mail reçu. Vous utilisez généralement cette action uniquement en combinaison avec une autre action. Cette action comporte les options suivantes. + **Header name – ** Nom de l'en-tête à ajouter. Il doit comporter entre 1 et 50 caractères, inclus, uniquement des caractères alphanumériques (a-z, A-Z, 0-9) et des tirets. + **Header value – ** Valeur de l'en-tête à ajouter. Celle-ci doit comporter moins de 2048 caractères et ne peut pas contenir de sauts de ligne (« \$1r » ou « \$1n »). # Action de réponse au retour à l'expéditeur L'action **Bounce (Retour à l'expéditeur)** rejette l'e-mail en renvoyant à l'expéditeur une réponse de retour à l'expéditeur et vous avertit le cas échéant via Amazon SNS. Cette action comporte les options suivantes. + **SMTP Reply Code – **Code de réponse SMTP, tel qu'il a été défini par la spécification [RFC 5321](https://tools.ietf.org/html/rfc5321). + **SMTP Status Code – **Code de statut SMTP amélioré, tel qu'il a été défini par la spécification [RFC 3463](https://tools.ietf.org/html/rfc3463). + **Message – **Texte lisible par l'utilisateur à inclure dans l'e-mail de retour à l'expéditeur. + **Reply Sender – **Adresse e-mail de l'expéditeur de l'e-mail retourné à l'expéditeur. Il s'agit de l'adresse à partir de laquelle l'e-mail de retour à l'expéditeur sera envoyé. Celle-ci doit être vérifiée avec Amazon SES. **Note** Les messages Bounce ne sont pas envoyés via votre domaine MAIL FROM personnalisé, mais sont générés en interne par SES et signés uniquement avec la signature `amazonses.com` DKIM. Pour contourner le problème, utilisez l'option **Expéditeur de réponse** pour définir une adresse e-mail pour vos messages de rebond. Consultez cet [AWS re:Post article](https://repost.aws/questions/QURvN-26L_SJOcY9JoSFgCdg/ses-receiving-return-bounce-response-action-not-sending-bounce) pour plus d'informations. + **SNS Topic – **Nom ou ARN de la rubrique Amazon SNS pour éventuellement avertir lorsqu'un e-mail de retour à l'expéditeur est envoyé. Voici un exemple d'ARN de rubrique Amazon SNS *: arn:aws:sns:us-east- 1:123456789012 :*. MyTopic Vous pouvez également créer une rubrique Amazon SNS lorsque vous configurez une action en choisissant **Create SNS Topic (Créer une rubrique SNS)**. Pour de plus amples informations sur les rubriques Amazon SNS, consultez le [guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **Note** La rubrique Amazon SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. Vous pouvez saisir vos propres valeurs pour ces champs, ou choisir un modèle qui remplit les champs SMTP Reply Code, SMTP Status Code et Message avec des valeurs selon la raison du retour à l'expéditeur. Les modèles suivants sont disponibles : + **La boîte de réception n'existe pas –** Code de réponse SMTP = 550, code de statut SMTP = 5.1.1 + **Message trop grand –** Code de réponse SMTP = 552, code de statut SMTP = 5.3.4 + **Message plein –** Code de réponse SMTP = 552, code de statut SMTP = 5.2.2 + **Contenu du message rejeté –** Code de réponse SMTP = 500, code de statut SMTP = 5.6.1 + **Erreur inconnue –** Code de réponse SMTP = 554, code de statut SMTP = 5.0.0 + **Échec temporaire –** Code de réponse SMTP = 450, code de statut SMTP = 4.0.0 Pour obtenir des codes de retour à l'expéditeur supplémentaires que vous pouvez utiliser en saisissant des valeurs personnalisées dans les champs, consultez la spécification [RFC 3463](https://tools.ietf.org/html/rfc3463). # Invoquer l'action de fonction Lambda L'action Lambda appelle votre code via une fonction Lambda et vous avertit éventuellement via Amazon SNS. Cette action a les options et les exigences suivantes. **Options** + **Lambda function (Fonction Lambda)** — L'ARN de la fonction Lambda. Voici un exemple d'ARN de fonction Lambda : *arn:aws:lambda:us-east-1:account-id:function* :. MyFunction + **Invocation type (Type d'invocation)** — Le type d'appel de la fonction Lambda. Un type d'invocation **RequestResponse**signifie que l'exécution de la fonction entraîne une réponse immédiate. Un type d'appel **Event (Événement)** implique que la fonction est appelée de manière asynchrone. Nous vous conseillons d'utiliser le type d'appel **Event (Événement)**, sauf si une exécution synchrone est absolument nécessaire à votre cas d'utilisation. Les appels **RequestResponse** sont soumis à un délai d'expiration de 30 secondes. Pour plus d'informations, veuillez consulter la section [Appeler Lambda avec Step Functions](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html) dans le *Guide du développeur AWS Lambda *. + **SNS Topic (Rubrique SNS) ** — Le nom ou l'ARN de la rubrique Amazon SNS à avertir lorsque la fonction Lambda spécifiée est déclenchée. Voici un exemple d'ARN de rubrique Amazon SNS *: arn:aws:sns:us-east- 1:123456789012 :*. MyTopic Pour plus d'informations, consultez [Création d'une rubrique Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dans le *Guide du développeur Amazon Simple Notification Service*. **Exigences** + La fonction Lambda que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. + La rubrique Amazon SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. ## Écriture de votre fonction Lambda Pour traiter les e-mails, votre fonction Lambda peut être appelée de façon asynchrone (c'est-à-dire, à l'aide du type d'appel `Event`). L'objet d'événement transmis à votre fonction Lambda contient des métadonnées concernant l'événement d'e-mail entrant. Vous pouvez également utiliser les métadonnées pour accéder au contenu du message depuis votre compartiment Amazon S3. Si vous souhaitez réellement contrôler le flux de messagerie, votre fonction Lambda doit être appelée de manière synchrone (c'est-à-dire, à l'aide du type d'appel `RequestResponse`) et votre fonction Lambda doit appeler la méthode `callback` avec deux arguments, le premier argument étant `null` et le deuxième argument, une propriété `disposition` qui est définie sur `STOP_RULE`, `STOP_RULE_SET` ou `CONTINUE`. Si le deuxième argument est `null` ou n'a pas de propriété `disposition` valide, le flux de messagerie continue, et de nouvelles actions et règles sont traitées, ce qui est identique à `CONTINUE`. Par exemple, vous pouvez arrêter l'ensemble de règles de réception en écrivant la ligne suivante à la fin du code de votre fonction Lambda : ``` callback( null, { "disposition" : "STOP_RULE_SET" }); ``` Pour des exemples de AWS Lambda code, voir[Exemples de fonctions Lambda](receiving-email-action-lambda-example-functions.md). Pour obtenir des exemples de cas d'utilisation de haut niveau, consultez [Exemples de cas d'utilisation](receiving-email-action-lambda-example-use-cases.md). ### Format d'entrée Amazon SES transmet des informations à la fonction Lambda au format JSON. L'objet de niveau supérieur contient un tableau `Records` qui est alimenté avec les propriétés `eventSource`, `eventVersion` et `ses`. L'objet `ses` contient des objets `receipt` et `mail` qui sont exactement au même format que dans les notifications Amazon SNS décrites dans [Contenu des notifications ](receiving-email-notifications-contents.md). Les données qu'Amazon SES transmet à Lambda incluent des métadonnées sur le message, ainsi que plusieurs en-têtes de messagerie. Par contre, elles ne contiennent pas le corps du message. Voici une vue d'ensemble de la structure de l'entrée fournie par Amazon SES à la fonction Lambda. ``` { "Records": [ { "eventSource": "aws:ses", "eventVersion": "1.0", "ses": { "receipt": { }, "mail": { } } } ] } ``` ### Valeurs de retour Votre fonction Lambda peut contrôler le flux de messagerie en renvoyant l'une des valeurs suivantes : + `STOP_RULE` – Aucune autre action de la règle de réception actuelle ne sera traitée, mais d'autres règles de réception peuvent être traitées. + `STOP_RULE_SET` – Aucune autre action ou règle de réception ne sera traitée. + `CONTINUE` (ou toute autre valeur non valide) – Signifie que de nouvelles actions et règles de réception peuvent être traitées. **Topics** + [Écriture de votre fonction Lambda](#receiving-email-action-lambda-function) + [Exemple d'événement d'e-mail entrant](receiving-email-action-lambda-event.md) + [Exemples de cas d'utilisation](receiving-email-action-lambda-example-use-cases.md) + [Exemples de fonctions Lambda](receiving-email-action-lambda-example-functions.md) # Exemple d'événement d'e-mail entrant Il existe deux façons d'envoyer des événements d'e-mail entrants à une fonction Lambda. La première méthode consiste à utiliser une action Lambda dans votre règle de réception pour envoyer le registre d'événement directement à la fonction. La deuxième méthode consiste à utiliser une action Amazon SNS dans votre règle de réception pour envoyer les registres d'événement à Amazon SNS, puis à ajouter la fonction Lambda en tant que point de terminaison abonné à la rubrique Amazon SNS. Cette section contient des exemples de registres d'événement pouvant être envoyés à Lambda par Amazon SES. Vous pouvez utiliser ces exemples pour créer et tester des fonctions Lambda. **Note** Les exemples de cette section incluent des sauts de ligne pour faciliter la lecture. Si vous copiez les exemples de cette section, vous devez supprimer les sauts de ligne pour produire des objets JSON valides. ## registres d'événement fournis par l'action Lambda Lorsque vous ajoutez une action Lambda à une règle de réception, Amazon SES envoie un registre d'événement à Lambda chaque fois qu'il reçoit un message entrant. Cet événement contient des informations sur plusieurs des en-têtes d'e-mail pour le message entrant, ainsi que les résultats de plusieurs tests effectués par Amazon SES sur les messages entrants. Cependant, il ne contient pas le corps de l'e-mail entrant. L'exemple suivant montre les valeurs que ces registres d'événement contiennent généralement. ``` { "Records": [{ "eventSource": "aws:ses", "eventVersion": "1.0", "ses": { "mail": { "timestamp": "2019-08-05T21:30:02.028Z", "source": "prvs=144d0cba7=sender@example.com", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": ["recipient@example.com"], "headersTruncated": false, "headers": [{ "name": "Return-Path", "value": "" }, { "name": "Received", "value": "from smtp.example.com [203.0.113.0]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id bsvpsoklfhu7u50iur7h0kk9a2ou0r7iexample for recipient@example.com; Mon, 05 Aug 2019 21:30:02 +0000 (UTC)" }, { "name": "X-SES-Spam-Verdict", "value": "PASS" }, { "name": "X-SES-Virus-Verdict", "value": "PASS" }, { "name": "Received-SPF", "value": "pass (spfCheck: domain of example.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=prvs=144d0cba42=sender@example.com; helo= smtp.example.com;" }, { "name": "Authentication-Results", "value": "amazonses.com; spf=pass (spfCheck: domain of example.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=prvs=144d0cba42= sender@example.com; helo=smtp.example.com; dkim=pass header.i=@example.com; dmarc=none header.from=example.com;" }, { "name": "X-SES-RECEIPT", "value": "AEFBQUFBQUFBQUFHbFo0VU81VzVuYmRDNm51nhTVWpabDh6J4V2l5cG5PSHFtNzlBeUk90example" }, { "name": "X-SES-DKIM-SIGNATURE", "value": "a=rsa-sha256; q=dns/txt; b=Cm1emU30VcD6example=; c=relaxed/simple; s=6gbrjpgwjs 5zn6fwqknexample; d=amazonses.com; t=1567719002; v=1; bh=DSofsjAoUvyZj6YsBDP5en pRO1otGb7Nes0Qexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME-Version: Content-Type:X-SES-RECEIPT;" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com; i=@example.com; q=dns/txt; s=example12345; t=1567719001; x=1599255001; h=from:to:subject:date:message-id: references:in-reply-to:mime-version; bh=sjAoUvyZj6YsBDP5enpRO1otGb7s0Qexample=; b=EQw2D4RLOW2IHE9OgfEA4WXp+AENJtaD2+63wmd5J+d+t/xoaiKUGClOS7WhpyOmlipryOz+iOhxU v350xJIHjLTi9Jsnlw76mRK8o4770TaUz620joCVN21n4cxsrRZpv+1kS0EcAxaF30pmwlni+XT4ems Vxn7zO0I8example=;" }, { "name": "Received", "value": "from mail.example.com (mail.example.com [203.0.113.0]) by email-inbound-relay- 1d-9ec21598.us-east-1.example.com (Postfix) with ESMTPS id 57F83A2042 for ; Mon, 5 Aug 2019 21:29:58 +0000 (UTC)" }, { "name": "From", "value": "\"Doe, John\" " }, { "name": "To", "value": "\"recipient@example.com\" " }, { "name": "Subject", "value": "This is a test" }, { "name": "Thread-Topic", "value": "This is a test" }, { "name": "Thread-Index", "value": "AQHVZDAaQ58yKI8q7kaAjkhC5stGexample" }, { "name": "Date", "value": "Mon, 5 Aug 2019 21:29:57 +0000" }, { "name": "Message-ID", "value": "" }, { "name": "References", "value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>" }, { "name": "In-Reply-To", "value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>" }, { "name": "Accept-Language", "value": "en-US" }, { "name": "Content-Language", "value": "en-US" }, { "name": "X-MS-Has-Attach", "value": "" }, { "name": "X-MS-TNEF-Correlator", "value": "" }, { "name": "x-ms-exchange-messagesentrepresentingtype", "value": "1" }, { "name": "x-ms-exchange-transport-fromentityheader", "value": "Hosted" }, { "name": "x-originating-ip", "value": "[203.0.113.0]" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"_000_F8098FDD49A344F6112B195BDAexamplecom_\"" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Precedence", "value": "Bulk" }], "commonHeaders": { "returnPath": "prvs=144d0cba7=sender@example.com", "from": ["\"Doe, John\" "], "date": "Mon, 5 Aug 2019 21:29:57 +0000", "to": ["\"recipient@example.com\" "], "messageId": "", "subject": "This is a test" } }, "receipt": { "timestamp": "2019-08-05T21:30:02.028Z", "processingTimeMillis": 1205, "recipients": ["recipient@example.com"], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "PASS" }, "dmarcVerdict": { "status": "GRAY" }, "action": { "type": "Lambda", "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:IncomingEmail", "invocationType": "Event" } } } }] } ``` ## registres d'événement fournis par l'action Amazon SNS Lorsque vous ajoutez une action Amazon SNS à votre règle de réception, la notification contient l'ensemble du contenu de l'e-mail. Si vous souhaitez qu'une fonction Lambda traite le corps de l'e-mail, vous devez ajouter une action Amazon SNS à la règle de réception, puis, souscrivez votre fonction Lambda à la fonction Amazon SNS dans Amazon SNS. Cette configuration entraîne l'activation de votre fonction Lambda lorsque celle-ci reçoit une notification de la rubrique Amazon SNS. ``` { 'Records': [ { 'EventSource': 'aws:sns', 'EventVersion': '1.0', 'EventSubscriptionArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail:12345678', 'Sns': { 'Type': 'Notification', 'MessageId': 'EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000', 'TopicArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail', 'Subject': 'Amazon SES Email Receipt Notification', 'Message': , 'Timestamp': '2019-09-06T18:52:16.076Z', 'SignatureVersion': '1', 'Signature': '012345678901example==', 'SigningCertUrl': 'https://sns.us-east-1.amazonaws.com/SimpleNotificationService -01234567890123456789012345678901.pem', 'UnsubscribeUrl': 'https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe& SubscriptionArn=arn:aws:sns:us-east-1:0123456789012:IncomingEmail: 0b863538-3f32-462e-9c89-8d8e0example', 'MessageAttributes': {} } } ] } ``` L'attribut `Message` contient une chaîne codée en JSON. La chaîne contient les en-têtes et le contenu du message. Le corps du message lui-même est codé en base64. Si vous souhaitez utiliser le corps du message dans votre fonction Lambda, vous devez d'abord décoder l'attribut `Message`, puis décoder l'objet `Content`. L'exemple suivant présente les valeurs contenues dans l'attribut `Message`. ``` { "notificationType": "Received", "mail": { "timestamp": "2019-09-06T18:52:14.965Z", "source": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com", "messageId": "12345678901example", "destination": ["recipient@example.com"], "headersTruncated": false, "headers": [{ "name": "Return-Path", "value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com>" }, { "name": "Received", "value": "from a1-23.smtp-out.amazonses.com (a1-23.smtp-out.amazonses.com [203.0.113.0]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id 12345678901example for recipient@example.com; Fri, 06 Sep 2019 18:52:14 +0000 (UTC)" }, { "name": "X-SES-Spam-Verdict", "value": "PASS" }, { "name": "X-SES-Virus-Verdict", "value": "PASS" }, { "name": "Received-SPF", "value": "pass (spfCheck: domain of amazonses.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example -000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com;" }, { "name": "Authentication-Results", "value": "amazonses.com; spf=pass (spfCheck: domain of amazonses.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce -475e-4e4b-89cb-example-000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com; dkim=pass header.i=@amazonses.com; dmarc=none header.from=example.com;" }, { "name": "X-SES-RECEIPT", "value": "AEFBQUFBQUFBQUFFQkx0QUJZZENEXAMPLE=" }, { "name": "X-SES-DKIM-SIGNATURE", "value": "a=rsa-sha256; q=dns/txt; b=d5azwgA2iBqAjA4NBm1ARzjJ95raRmy4G84iVdd3x2JzSHeUnQuTuLmJ AqRrYY3WpMIVRFy01hITaguCVjUPWBR0xF6fCEXH85cf3RNeFQyLfWZqoXKfBdjFRV+13troDterH2MxBUL 8rjzcvdHetl0ImwlaK2PGmePTexample=; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02 f9-4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795935; v=1; bh=CZ1SghsYaA 6SSCbitzsLISeFoNlpdtH1Pyiexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME- Version:Content-Type:X-SES-RECEIPT;" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02f9- 4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795934; h=From:To:Subject: MIME-Version:Content-Type:Message-ID:Date:Feedback-ID; bh=CZ1SghsYaA6SSCbitzsLISeFo NlpdtH1Pyiexample=; b=L6VXqR1PSN/FYqJI/VAfPRKFgtakcHCYJvuJqVYbuJT8I3FOhqOvkbcgHxOgs woxPfvGrL6S53H8Er5Do/CPvOM4Tx3ilE+a0GTYVLjKmwltNeN09YWlJAoqG5KMQPZUxRYaNvYPInLzUdGi rdjkbSIgZEnrvq5MzaMWexample=" }, { "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon SES Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_869787_396523212.15677example\"" }, { "name": "Message-ID", "value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>" }, { "name": "Date", "value": "Fri, 6 Sep 2019 18:52:14 +0000" }, { "name": "X-SES-Outgoing", "value": "2019.09.06-203.0.113.0" }, { "name": "Feedback-ID", "value": "1.us-east-1.ZitRoTk0xziun8WEJevt+cSJ17QNuCwulg2D2v3nrT0=:AmazonSES" }], "commonHeaders": { "returnPath": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com", "from": ["sender@example.com"], "date": "Fri, 6 Sep 2019 18:52:14 +0000", "to": ["recipient@example.com"], "messageId": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>", "subject": "Amazon SES Test" } }, "receipt": { "timestamp": "2019-09-06T18:52:14.965Z", "processingTimeMillis": 1098, "recipients": ["recipient@example.com"], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "GRAY" }, "dmarcVerdict": { "status": "GRAY" }, "action": { "type": "SNS", "topicArn": "arn:aws:sns:us-east-1:123456789012:IncomingEmail", "encoding": "BASE64" } }, "content": "UmV0dXJuLVBhdGg6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtM DAwMDAwQGFtYXpvbnNlcy5jb20+ClJlY2VpdmVkOiBmcm9tIGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb2 0gKGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb20gWzIwMy4wLjExMy4wXSkKIGJ5IGluYm91bmQtc210cC5 1cy1lYXN0LTEuYW1hem9uYXdzLmNvbSB3aXRoIFNNVFAgaWQgZW5xMTBpYW1lMXFjdTMxamg1ZGEyZ244OWlt dm90Mms2ZXhhbXBsZQogZm9yIHJlY2lwaWVudEBleGFtcGxlLmNvbTsKIEZyaSwgMDYgU2VwIDIwMTkgMTg6N TI6MTQgKzAwMDAgKFVUQykKWC1TRVMtU3BhbS1WZXJkaWN0OiBQQVNTClgtU0VTLVZpcnVzLVZlcmRpY3Q6IF BBU1MKUmVjZWl2ZWQtU1BGOiBwYXNzIChzcGZDaGVjazogZG9tYWluIG9mIGFtYXpvbnNlcy5jb20gZGVzaWd uYXRlcyAyMDMuMC4xMTMuMCBhcyBwZXJtaXR0ZWQgc2VuZGVyKSBjbGllbnQtaXA9MjAzLjAuMTEzLjA7IGVu dmVsb3BlLWZyb209MDEwMDAxNmQwN2ViNzQ3Ny04ZTE5MzhjZS00NzVlLTRlNGItODljYi1leGFtcGxlLTAwM DAwMEBhbWF6b25zZXMuY29tOyBoZWxvPWExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb207CkF1dGhlbnRpY2 F0aW9uLVJlc3VsdHM6IGFtYXpvbnNlcy5jb207CiBzcGY9cGFzcyAoc3BmQ2hlY2s6IGRvbWFpbiBvZiBhbWF 6b25zZXMuY29tIGRlc2lnbmF0ZXMgMjAzLjAuMTEzLjAgYXMgcGVybWl0dGVkIHNlbmRlcikgY2xpZW50LWlw PTIwMy4wLjExMy4wOyBlbnZlbG9wZS1mcm9tPTAxMDAwMTZkMDdlYjc0NzctOGUxOTM4Y2UtNDc1ZS00ZTRiL Tg5Y2ItZXhhbXBsZS0wMDAwMDBAYW1hem9uc2VzLmNvbTsgaGVsbz1hMS0yMy5zbXRwLW91dC5hbWF6b25zZX MuY29tOwogZGtpbT1wYXNzIGhlYWRlci5pPUBhbWF6b25zZXMuY29tOwogZG1hcmM9bm9uZSBoZWFkZXIuZnJ vbT1leGFtcGxlLmNvbTsKWC1TRVMtUkVDRUlQVDogQUVGQlFVRkJRVUZCUVVGRlFreDBRVUpaWkVORVhBTVBM RT0KWC1TRVMtREtJTS1TSUdOQVRVUkU6IGE9cnNhLXNoYTI1NjsgcT1kbnMvdHh0OyBiPWQ1YXp3Z0EyaUJxQ WpBNE5CbTFBUnpqSjk1cmFSbXk0Rzg0aVZkZDN4Mkp6U0hlVW5RdVR1TG1KQXFScllZM1dwTUlWUkZ5MDFoSV RhZ3VDVmpVUFdCUjB4RjZmQ0VYSDg1Y2YzUk5lRlF5TGZXWnFvWEtmQmRqRlJWKzEzdHJvRHRlckgyTXhCVUw 4cmp6Y3ZkSGV0bDBJbXdsYUsyUEdtZVBUZXhhbXBsZT07IGM9cmVsYXhlZC9zaW1wbGU7IHM9RVhBTVBMRTdj MTkxYmU0NS1lOWFlZGI5YS0wMmY5LTRkMTItYTg3ZC1kZDAwOTlhMDdmOGEtMDAwMDAwOyBkPWFtYXpvbnNlc y5jb207IHQ9MTU2Nzc5NTkzNTsgdj0xOyBiaD1DWjFTZ2hzWWFBNlNTQ2JpdHpzTElTZUZvTmxwZHRIMVB5aW V4YW1wbGU9OyBoPUZyb206VG86Q2M6QmNjOlN1YmplY3Q6RGF0ZTpNZXNzYWdlLUlEOk1JTUUtVmVyc2lvbjp Db250ZW50LVR5cGU6WC1TRVMtUkVDRUlQVDsKREtJTS1TaWduYXR1cmU6IHY9MTsgYT1yc2Etc2hhMjU2OyBx PWRucy90eHQ7IGM9cmVsYXhlZC9zaW1wbGU7CglzPUVYQU1QTEU3YzE5MWJlNDUtZTlhZWRiOWEtMDJmOS00Z DEyLWE4N2QtZGQwMDk5YTA3ZjhhLTAwMDAwMDsgZD1hbWF6b25zZXMuY29tOyB0PTE1Njc3OTU5MzQ7CgloPU Zyb206VG86U3ViamVjdDpNSU1FLVZlcnNpb246Q29udGVudC1UeXBlOk1lc3NhZ2UtSUQ6RGF0ZTpGZWVkYmF jay1JRDsKCWJoPUNaMVNnaHNZYUE2U1NDYml0enNMSVNlRm9ObHBkdEgxUHlpTWV4YW1wbGU9OwoJYj1leGFt cGxlPQpGcm9tOiBzZW5kZXJAZXhhbXBsZS5jb20KVG86IHJlY2lwaWVudEBleGFtcGxlLmNvbQpTdWJqZWN0O iBBbWF6b24gU0VTIFRlc3QKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UeXBlOiBtdWx0aXBhcnQvYWx0ZX JuYXRpdmU7IAoJYm91bmRhcnk9Ii0tLS09X1BhcnRfODY5Nzg3XzM5NjUyMzIxMi4xNTY3N2V4YW1wbGUiCk1 lc3NhZ2UtSUQ6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAw MDAwQGVtYWlsLmFtYXpvbnNlcy5jb20+CkRhdGU6IEZyaSwgNiBTZXAgMjAxOSAxODo1MjoxNCArMDAwMApYL VNFUy1PdXRnb2luZzogMjAxOS4wOS4wNi0yMDMuMC4xMTMuMApGZWVkYmFjay1JRDogMS51cy1lYXN0LTEuWm l0Um9UazB4eml1bjhXRUpldnQrZXhhbXBsZT06QW1hem9uU0VTCgotLS0tLS09X1BhcnRfODY5Nzg3XzM5NjU yMzIxMi4xNTY3N2V4YW1wbGUKQ29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PVVURi04CkNvbnRl bnQtVHJhbnNmZXItRW5jb2Rpbmc6IDdiaXQKCkFtYXpvbiBTRVMgVGVzdApUaGlzIGVtYWlsIHdhcyBzZW50I HdpdGggQW1hem9uIFNFUy4KLS0tLS0tPV9QYXJ0Xzg2OTc4N18zOTY1MjMyMTIuMTU2NzdleGFtcGxlCkNvbn RlbnQtVHlwZTogdGV4dC9odG1sOyBjaGFyc2V0PVVURi04CkNvbnRlbnQtVHJhbnNmZXItRW5jb2Rpbmc6IDd iaXQKCjxodG1sPgo8aGVhZD48L2hlYWQ+Cjxib2R5PgogIDxoMT5BbWF6b24gU0VTIFRlc3Q8L2gxPgogIDxw PlRoaXMgZW1haWwgd2FzIHNlbnQgd2l0aCBBbWF6b24gU0VTLjwvcD4KPGltZyBhbHQ9IiIgc3JjPSJodHRwO i8vZXhhbXBsZS5yLnVzLWVhc3QtMS5hd3N0cmFjay5tZS9JMC8wMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLT Q3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAwMDAwL3UtWUphaHRkTTJTclhZQ2QiIHN0eWxlPSJkaXNwbGF5OiB ub25lOyB3aWR0aDogMXB4OyBoZWlnaHQ6IDFweDsiPgo8L2JvZHk+CjwvaHRtbD4KICAgICAgICAgICAgCi0t LS0tLT1fUGFydF84Njk3ODdfMzk2NTIzMjEyLjE1Njc3ZXhhbXBsZS0tCg==" } ``` # Exemples de cas d'utilisation Les exemples suivants décrivent certaines règles que vous pouvez configurer pour utiliser les résultats d'une fonction Lambda afin de contrôler votre flux de messagerie. À des fins de démonstration, de nombreux exemples utilisent l'action S3 comme le résultat. ## Cas d'utilisation 1 : Supprimer le courrier indésirable pour tous les domaines Cet exemple illustre une règle globale qui supprime le courrier indésirable dans l'ensemble de vos domaines. Les règles 2 et 3 sont incluses pour montrer que vous pouvez appliquer des règles spécifiques au domaine une fois le courrier indésirable supprimé dans tous les domaines. ### Règle 1 *Liste des destinataires : *Vide. Cette règle s'applique donc à tous les destinataires sous tous vos domaines vérifiés. *Actions* 1. Action Lambda (synchrone) qui renvoie `STOP_RULE_SET` si l'e-mail est un courrier indésirable. Sinon, la valeur renvoyée est `CONTINUE`. Consultez l'exemple de fonction Lambda pour la suppression du courrier indésirable dans [Exemples de fonctions Lambda](receiving-email-action-lambda-example-functions.md). ### Règle 2 *Liste des destinataires : *exemple1.com *Actions* 1. Toute action. ### Règle 3 *Liste des destinataires : *exemple2.com *Actions* 1. Toute action. ## Cas d'utilisation 2 : Retourner à l'expéditeur le courrier indésirable pour tous les domaines Cet exemple illustre une règle globale qui retourne à l'expéditeur le courrier indésirable pour l'ensemble de vos domaines. Les règles 2 et 3 sont incluses pour montrer que vous pouvez appliquer des règles spécifiques au domaine une fois le courrier indésirable renvoyé à l'expéditeur pour tous les domaines. ### Règle 1 *Liste des destinataires : *Vide. Cette règle s'applique donc à tous les destinataires sous tous vos domaines vérifiés. *Actions* 1. Action Lambda (synchrone) qui renvoie `CONTINUE` si l'e-mail est un courrier indésirable. Sinon, la valeur renvoyée est `STOP_RULE`. 1. Action de retour à l'expéditeur (« 500 5.6.1. Contenu du message rejeté »). 1. Action d'arrêt. ### Règle 2 *Liste des destinataires : *exemple1.com *Actions* 1. Toute action ### Règle 3 *Liste des destinataires : *exemple2.com *Actions* 1. Toute action ## Cas d'utilisation 3 : Appliquer la règle la plus spécifique Cet exemple montre comment utiliser l'action d'arrêt pour empêcher que des e-mails soient traités par plusieurs règles. Dans cet exemple, vous disposez d'une règle pour une adresse spécifique et d'une autre règle pour toutes les adresses e-mail sous le domaine. En utilisant l'action d'arrêt, vous faites en sorte que les messages qui correspondent à la règle pour l'adresse e-mail spécifique ne soient pas traités par la règle plus générique qui s'applique au domaine. ### Règle 1 *Liste des destinataires : *utilisateur@exemple.com *Actions* 1. Action Lambda (asynchrone). 1. Action d'arrêt. ### Règle 2 *Liste des destinataires : *exemple.com *Actions* 1. Toute action. ## Cas d'utilisation 4 : Consigner les événements de messagerie à CloudWatch Cet exemple montre comment conserver un journal d'audit de tous les messages transitant par votre système avant d'enregistrer les messages dans Amazon SES. ### Règle 1 *Liste des destinataires : *exemple.com *Actions* 1. Action Lambda (asynchrone) qui écrit l'objet de l'événement dans un journal. CloudWatch Les exemples de fonctions Lambda dans [Exemples de fonctions Lambda](receiving-email-action-lambda-example-functions.md) log to. CloudWatch 1. Action S3. ## Cas d'Application 5 : Supprimer les messages pour lesquels le contrôle DKIM échoue Cet exemple montre comment enregistrer tous les messages entrants dans un compartiment Amazon S3, mais envoyer uniquement les e-mails destinés à une adresse e-mail spécifique et pour lesquels le contrôle DKIM réussit à votre application de messagerie automatisée. ### Règle 1 *Liste des destinataires : *exemple.com *Actions* 1. Action S3. 1. Action Lambda (synchrone) qui renvoie `STOP_RULE_SET` si le contrôle DKIM échoue pour le message. Sinon, la valeur renvoyée est `CONTINUE`. ### Règle 2 *Liste des destinataires : *support@exemple.com *Actions* 1. Action Lambda (asynchrone) qui déclenche l'application automatisée. ## Cas d'application 6 : Filtrer les messages en fonction de l'objet Cet exemple montre comment supprimer tous les messages entrants d'un domaine contenant le mot « remise » dans l'objet, puis traiter les messages destinés à un système automatisé d'une façon et traiter les e-mails adressée à tous les autres destinataires du domaine de manière différente. ### Règle 1 *Liste des destinataires : *exemple.com *Actions* 1. Action Lambda (synchrone) qui renvoie `STOP_RULE_SET` si l'objet contient le mot « remise ». Sinon, la valeur renvoyée est `CONTINUE`. ### Règle 2 *Liste des destinataires : *support@exemple.com *Actions* 1. Action S3 avec le compartiment 1. 1. Action Lambda (asynchrone) qui déclenche l'application automatisée. 1. Action d'arrêt. ### Règle 3 *Liste des destinataires : *exemple.com *Actions* 1. Action S3 avec le compartiment 2. 1. Action Lambda (asynchrone) qui traite les e-mails pour le reste du domaine. # Exemples de fonctions Lambda Cette rubrique contient des exemples de fonctions Lambda qui contrôlent le flux de messagerie. ## Exemple 1 : Suppression du courrier indésirable Cet exemple arrête de traiter les messages qui ont au moins un indicateur de courrier indésirable. ``` export const handler = async (event, context, callback) => { console.log('Spam filter'); const sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Check if any spam check failed if (sesNotification.receipt.spfVerdict.status === 'FAIL' || sesNotification.receipt.dkimVerdict.status === 'FAIL' || sesNotification.receipt.spamVerdict.status === 'FAIL' || sesNotification.receipt.virusVerdict.status === 'FAIL') { console.log('Dropping spam'); // Stop processing rule set, dropping message callback(null, {'disposition':'STOP_RULE_SET'}); } else { callback(null, {'disposition':'CONTINUE'}); } }; ``` ## Exemple 2 : Continuer si un en-tête spécifique est trouvé Cet exemple continue de traiter la règle actuelle uniquement si l'e-mail contient une valeur d'en-tête spécifique. ``` export const handler = async (event, context, callback) => { console.log('Header matcher'); const sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Iterate over the headers for (let index in sesNotification.mail.headers) { const header = sesNotification.mail.headers[index]; // Examine the header values if (header.name === 'X-Header' && header.value === 'X-Value') { console.log('Found header with value.'); callback(null, {'disposition':'CONTINUE'}); return; } } // Stop processing the rule if the header value wasn't found callback(null, {'disposition':'STOP_RULE'}); }; ``` ## Exemple 3 : Récupération de l'e-mail depuis Amazon S3 Cet exemple extrait l'e-mail brut d'Amazon S3 et le traite. **Note** Vous devez d'abord écrire l'e-mail dans Amazon S3 à l'aide d'une action S3. [Assurez-vous que la fonction Lambda dispose des autorisations IAM pour récupérer des objets depuis le compartiment S3. Reportez-vous à cet article de Re:Post pour plus d'informations.AWS](https://repost.aws/knowledge-center/lambda-execution-role-s3-bucket) Il est possible que les délais d'exécution Lambda par défaut soient trop courts pour votre flux de travail. Pensez à les augmenter. ``` import { S3Client, GetObjectCommand } from "@aws-sdk/client-s3"; const bucketName = ''; export const handler = async (event, context, callback) => { const client = new S3Client(); console.log('Process email'); var sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); console.log("MessageId: " + sesNotification.mail.messageId) const getObjectCommand = new GetObjectCommand({ Bucket: bucketName, Key: sesNotification.mail.messageId }); try { const response = await client.send(getObjectCommand); const receivedMail = await response.Body.transformToString(); console.log(receivedMail); callback(null, {'disposition':'CONTINUE'}) } catch (e) { // Perform error handling here console.log("Encountered S3 client error: "+ e, e.stack); callback(null, {'disposition':'STOP_RULE_SET'}) } }; ``` ## Exemple 4 : Retour à l'expéditeur des messages pour lesquels l'authentification DMARC échoue Cet exemple envoie un message de retour à l'expéditeur si l'authentification DMARC échoue pour des e-mails entrants. **Note** Lorsque vous utilisez cet exemple, définissez la valeur de la variable d'environnement `emailDomain` sur votre domaine de réception des e-mails. Assurez-vous que la fonction Lambda dispose des `ses:SendBounce` autorisations nécessaires pour l'identité SES qui envoie les messages de rebond. ``` import { SESClient, SendBounceCommand } from "@aws-sdk/client-ses"; const sesClient = new SESClient(); // Assign the emailDomain environment variable to a constant. const emailDomain = process.env.emailDomain; export const handler = async (event, context, callback) => { console.log('Spam filter starting'); const sesNotification = event.Records[0].ses; const messageId = sesNotification.mail.messageId; const receipt = sesNotification.receipt; console.log('Processing message:', messageId); // If DMARC verdict is FAIL and the sending domain's policy is REJECT // (p=reject), bounce the email. if (receipt.dmarcVerdict.status === 'FAIL' && receipt.dmarcPolicy.status === 'REJECT') { // The values that make up the body of the bounce message. const sendBounceParams = { BounceSender: `mailer-daemon@${emailDomain}`, OriginalMessageId: messageId, MessageDsn: { ReportingMta: `dns; ${emailDomain}`, ArrivalDate: new Date(), ExtensionFields: [], }, // Include custom text explaining why the email was bounced. Explanation: "Unauthenticated email is not accepted due to the sending domain's DMARC policy.", BouncedRecipientInfoList: receipt.recipients.map((recipient) => ({ Recipient: recipient, // Bounce with 550 5.6.1 Message content rejected BounceType: 'ContentRejected', })), }; console.log('Bouncing message with parameters:'); console.log(JSON.stringify(sendBounceParams, null, 2)); const sendBounceCommand = new SendBounceCommand(sendBounceParams); // Try to send the bounce. try { const response = await sesClient.send(sendBounceCommand); console.log(response); console.log(`Bounce for message ${messageId} sent, bounce message ID: ${response.MessageId}`); // Stop processing additional receipt rules in the rule set. callback(null, {disposition: 'STOP_RULE_SET'}); } catch (e) { // If something goes wrong, log the issue. console.log(`An error occurred while sending bounce for message: ${messageId}`, e); // Perform any additional error handling here callback(e) } // If the DMARC verdict is anything else (PASS, QUARANTINE or GRAY), accept // the message and process remaining receipt rules in the rule set. } else { console.log('Accepting message:', messageId); callback(null, {disposition: 'CONTINUE'}); } }; ``` # Livrer à l'action du compartiment S3 L'action **Livrer au compartiment S3** envoie le courrier à un compartiment S3 et peut éventuellement vous avertir via SNS et plus encore. Cette action comporte les options suivantes. + **Compartiment S3** : nom du compartiment S3 dans lequel enregistrer les e-mails reçus. Vous pouvez également créer un nouveau compartiment S3 lorsque vous configurez votre action en choisissant **Create S3 Bucket**. Amazon SES vous fournit 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](https://tools.ietf.org/html/rfc2045). **Important** Le compartiment Amazon S3 doit exister dans une région où SES [Réception d'e-mails](regions.md#region-receive-email) est disponible ; sinon, vous devez utiliser l'option de rôle IAM expliquée ci-dessous. Lorsque vous enregistrez vos e-mails dans un compartiment S3, la taille maximale par défaut (en-têtes compris) est de 40 Mo. SES ne prend pas en charge les règles de réception qui chargent vers S3 des compartiments avec le verrouillage d'objets activé et configuré avec une période de rétention par défaut. Si vous appliquez le chiffrement à votre compartiment S3 en spécifiant votre propre clé KMS, veillez à utiliser l'ARN de clé KMS complet, et non l'alias de clé KMS. L'utilisation de l'alias peut entraîner le chiffrement des données avec une clé KMS appartenant au demandeur, et non à l'administrateur du compartiment. Veuillez consulter [Utilisation du chiffrement pour les opérations inter-comptes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html#bucket-encryption-update-bucket-policy). + **Préfixe de clé d'objet : préfixe** de nom de clé facultatif à utiliser dans le compartiment S3. Les préfixes de nom de clé vous permettent d'organiser votre compartiment S3 dans une structure de dossiers. *Par exemple, si vous utilisez *Email* comme **préfixe de clé d'objet**, vos e-mails apparaîtront dans votre compartiment S3 dans un dossier nommé Email.* + **Chiffrement des messages** : option permettant de chiffrer les e-mails reçus avant de les envoyer dans votre compartiment S3. + **Clé de chiffrement KMS** — (Disponible si *le chiffrement des messages* est sélectionné.) La AWS KMS clé que SES doit utiliser pour chiffrer vos e-mails avant de les enregistrer dans le compartiment S3. Vous pouvez utiliser la clé KMS par défaut ou une clé gérée par le client que vous avez créée dans KMS. **Note** La clé KMS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison SES que vous utilisez pour recevoir des e-mails. + Pour utiliser la clé KMS par défaut, choisissez **aws/ses** lorsque vous configurez la règle de réception dans la console SES. Si vous utilisez l'API SES, vous pouvez spécifier la clé KMS par défaut en fournissant un ARN sous la forme de`arn:aws:kms:REGION:AWSACCOUNTID:alias/aws/ses`. Par exemple, si votre identifiant de AWS compte est 123456789012 et que vous souhaitez utiliser la clé KMS par défaut dans la région us-east-1, l'ARN de la clé KMS par défaut serait. `arn:aws:kms:us-east-1:123456789012:alias/aws/ses` Si vous utilisez la clé KMS par défaut, vous n'avez pas besoin d'effectuer d'étapes supplémentaires pour autoriser SES à utiliser la clé. + Pour utiliser une clé gérée par le client que vous avez créée dans KMS, fournissez l'ARN de la clé KMS et assurez-vous d'ajouter une déclaration à la politique de votre clé pour autoriser SES à l'utiliser. Pour en savoir plus sur l'octroi d'autorisations, consultez [Attribution d'autorisations à Amazon SES pour la réception d'e-mails](receiving-email-permissions.md). Pour plus d'informations sur l'utilisation de KMS avec SES, consultez le [manuel du AWS Key Management Service développeur](https://docs.aws.amazon.com/kms/latest/developerguide/services-ses.html). Si vous ne spécifiez pas de clé KMS dans la console ou dans l'API, SES ne chiffrera pas vos e-mails. **Important** Votre courrier est crypté par SES à l'aide du client de chiffrement S3 avant qu'il ne soit envoyé à S3 pour stockage. Il n'est pas chiffré à l'aide du chiffrement S3 côté serveur. Cela signifie que vous devez utiliser le client de chiffrement S3 pour déchiffrer le courrier électronique après l'avoir récupéré auprès de S3, car le service n'a pas accès à vos clés KMS pour le déchiffrement. Ce client de chiffrement est disponible dans le kit [AWS SDK pour Java](https://aws.amazon.com/sdk-for-java/) et le kit [AWS SDK pour Ruby](https://aws.amazon.com/sdk-for-ruby/). Pour en savoir plus, veuillez consulter [Guide de l'utilisateur Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingClientSideEncryption.html). + Rôle **IAM : rôle** IAM utilisé par SES pour accéder aux ressources de l'action *Deliver to S3* (compartiment Amazon S3, rubrique SNS et clé KMS). Si ce n'est pas le cas, vous devrez explicitement autoriser SES à accéder à chaque ressource individuellement [Attribution d'autorisations à Amazon SES pour la réception d'e-mails](receiving-email-permissions.md) (voir. Si vous souhaitez écrire dans un compartiment S3 qui existe dans une région où la *réception d'e-mails* SES n'est pas disponible, vous devez utiliser un rôle IAM doté de la politique d'autorisation d'écriture dans S3 comme politique intégrée du rôle. Vous pouvez appliquer la politique d'autorisation pour cette action directement depuis la console : 1. Choisissez **Créer un nouveau rôle** dans le champ **Rôle IAM** et entrez un nom suivi de **Créer un rôle**. (La politique de confiance IAM pour ce rôle sera automatiquement générée en arrière-plan.) 1. Comme la politique de confiance IAM a été générée automatiquement, il vous suffit d'ajouter la politique d'autorisation de l'action au rôle. Sélectionnez **Afficher le rôle dans le champ Rôle** **IAM pour ouvrir la console IAM**. 1. Sous l'onglet **Autorisations**, choisissez **Ajouter des autorisations**, puis sélectionnez **Créer une politique intégrée**. 1. Sur la page **Spécifier les autorisations**, sélectionnez **JSON** dans l'**éditeur de politiques**. 1. Copiez et collez la politique d'autorisation depuis [Autorisations de rôle IAM pour l'action S3](receiving-email-permissions.md#receiving-email-permissions-s3-iam-role) l'**éditeur de politique** et remplacez les données en texte rouge par les vôtres. (Assurez-vous de supprimer tout exemple de code dans l'éditeur.) 1. Choisissez **Suivant**. 1. Passez en revue et créez votre politique d'autorisation pour le rôle IAM en choisissant **Créer une politique**. 1. Sélectionnez l'onglet de votre navigateur où la page SES **Create rule** — **Add actions** est ouverte et poursuivez les étapes restantes pour créer des règles. + **Rubrique SNS** : nom ou ARN de la rubrique Amazon SNS à avertir lorsqu'un e-mail est enregistré dans le compartiment S3. Voici un exemple d'ARN de rubrique SNS *: arn:aws:sns:us-east* - 1:123456789012 :. MyTopic Vous pouvez également créer un sujet SNS lorsque vous configurez votre action en choisissant **Créer un sujet SNS**. Pour plus d'informations sur les sujets liés aux réseaux sociaux, consultez le [guide du développeur Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **Note** La rubrique SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison SES que vous utilisez pour recevoir des e-mails. N'utilisez *le chiffrement des clés KMS géré par le client* qu'avec les rubriques SNS que vous associez aux règles de réception de SES, car vous devrez modifier la politique des clés KMS pour autoriser SES à publier sur SNS. Cela contraste avec les politiques clés KMS *AWS gérées* qui ne peuvent pas être modifiées dès leur conception. # Publie dans une action de rubrique Amazon SNS. L'action **SNS** publie les messages à l'aide d'une notification Amazon SNS. La notification comprend la totalité du contenu de l'e-mail. Cette action comporte les options suivantes. + **SNS Topic – **Nom ou ARN de la rubrique Amazon SNS dans laquelle vous voulez publier les e-mails. Les notifications Amazon SNS contiennent une copie brute non modifiée de l'e-mail, qui est 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](https://tools.ietf.org/html/rfc2045). **Important** Si vous décidez de recevoir vos messages via des notifications Amazon SNS, la taille maximale des e-mails est de 150 Ko, en-têtes compris. Les e-mails plus volumineux seront renvoyés à l'expéditeur. Si vous prévoyez de recevoir des e-mails d'une taille supérieure, enregistrez-les plutôt dans un compartiment Amazon S3. Voici un exemple d'ARN de rubrique Amazon SNS *: arn:aws:sns:us-east- 1:123456789012 :*. MyTopic Vous pouvez également créer une rubrique Amazon SNS lorsque vous configurez une action en choisissant **Create SNS Topic (Créer une rubrique SNS)**. Pour de plus amples informations sur les rubriques Amazon SNS, consultez le [guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **Note** La rubrique Amazon SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. N'utilisez *le chiffrement des clés KMS géré par le client* qu'avec les rubriques SNS que vous associez aux règles de réception de SES, car vous devrez modifier la politique des clés KMS pour autoriser SES à publier sur SNS. Cela contraste avec les politiques clés KMS *AWS gérées* qui ne peuvent pas être modifiées dès leur conception. + **Encoding – **Encodage à utiliser pour l'e-mail dans la notification Amazon SNS. UTF-8 est plus facile à utiliser, mais risque de ne pas conserver tous les caractères spéciaux lorsqu'un message a été codé avec un format d'encodage différent. Base64 conserve tous les caractères spéciaux. Pour en savoir plus sur UTF-8 et Base64, consultez les spécifications [RFC 3629](https://tools.ietf.org/html/rfc3629) et [RFC 4648](https://tools.ietf.org/html/rfc4648), respectivement. Lorsque vous recevez un e-mail, Amazon SES exécute les règles dans le jeu de règles de réception actif. Vous pouvez configurer des règles de réception de façon à recevoir des notifications à l'aide d'Amazon SNS. Vos règles de réception peuvent envoyer deux types de notifications différents : + **Notifications envoyées par les actions SNS** - Lorsque vous ajoutez une action [SNS](#receiving-email-action-sns) à une règle de réception, elle envoie des informations sur l'e-mail ainsi que sur son contenu. Si le message fait 150 Ko ou moins, ce type de notification comprend également le corps MIME complet de l'e-mail. + **Notifications envoyées depuis d'autres types d'actions** : lorsque vous ajoutez un autre type d'action (notamment [Bounce](receiving-email-action-bounce.md), [Lambda](receiving-email-action-lambda.md)[, Stop Rule](receiving-email-action-stop.md) Set [WorkMail](receiving-email-action-workmail.md)ou actions) à une règle de réception, vous pouvez éventuellement spécifier une rubrique Amazon SNS. Le cas échéant, vous recevrez des notifications lors de l'exécution de ces actions. Ces notifications comportent des informations sur l'e-mail, mais pas sur son contenu. **Topics** + [Contenu des notifications pour la réception d'e-mails via Amazon SES](receiving-email-notifications-contents.md) + [Exemples de notifications pour la réception d'e-mails via Amazon SES](receiving-email-notifications-examples.md) # Contenu des notifications pour la réception d'e-mails via Amazon SES Toutes les notifications relatives à la réception d'e-mails sont publiées dans les rubriques Amazon Simple Notification Service (Amazon SNS) JavaScript au format JSON (Object Notation). Pour des exemples de notifications, consultez [Exemples de notification ](receiving-email-notifications-examples.md). **Contents** + [Objet JSON de niveau supérieur](#receiving-email-notifications-contents-top-level-json-object) + [Objet receipt](#receiving-email-notifications-contents-receipt-object) + [Objets action](#receiving-email-notifications-contents-action-object) + [Objet dkimVerdict](#receiving-email-notifications-contents-dkimverdict-object) + [Objet dmarcVerdict](#receiving-email-notifications-contents-dmarcverdict-object) + [Objet spamVerdict](#receiving-email-notifications-contents-spamverdict-object) + [Objet spfVerdict](#receiving-email-notifications-contents-spfverdict-object) + [Objet virusVerdict](#receiving-email-notifications-contents-virusverdict-object) + [Objet mail](#receiving-email-notifications-contents-mail-object) + [Objet commonHeaders](#receiving-email-notifications-contents-mail-object-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`](#receiving-email-notifications-contents-receipt-object) | Objet qui contient des informations sur la remise de l'e-mail. | | [`mail`](#receiving-email-notifications-contents-mail-object) | 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](https://tools.ietf.org/html/rfc2045). 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`](#receiving-email-notifications-contents-action-object) | Objet qui encapsule des informations sur l'action qui a été exécutée. Pour obtenir une liste des valeurs possibles, consultez [Objets action](#receiving-email-notifications-contents-action-object). | | [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object) | Objet qui indique si le contrôle du courrier DomainKeys identifié (DKIM) a réussi. Pour obtenir une liste des valeurs possibles, consultez [Objet dkimVerdict](#receiving-email-notifications-contents-dkimverdict-object). | | 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 :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | | [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | 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](#receiving-email-notifications-contents-dmarcverdict-object). | | 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](receiving-email-receipt-rules-console-walkthrough.md) active. Les adresses répertoriées ici peuvent être différentes de celles figurant dans le champ `destination` de l'objet [Objet mail](#receiving-email-notifications-contents-mail-object). | | [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object) | Objet qui indique si le message est un courrier indésirable. Pour obtenir une liste des valeurs possibles, consultez [Objet spamVerdict](#receiving-email-notifications-contents-spamverdict-object). | | [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object) | Objet qui indique si le contrôle SPF (Sender Policy Framework) a réussi. Pour obtenir une liste des valeurs possibles, consultez [Objet spfVerdict](#receiving-email-notifications-contents-spfverdict-object). | | 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](https://en.wikipedia.org/wiki/ISO_8601). | | [virusVerdict](#receiving-email-notifications-contents-virusverdict-object) | Objet qui indique si le message contient un virus. Pour obtenir une liste des valeurs possibles, consultez [Objet virusVerdict](#receiving-email-notifications-contents-virusverdict-object). | ### 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](#receiving-email-notifications-contents-mail-object). 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](https://tools.ietf.org/html/rfc5321). 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](https://tools.ietf.org/html/rfc3463). 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 contenant l'ARN de l' WorkMailorganisation Amazon. Présent uniquement pour le type WorkMail d'action. | ### 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | ### 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | ### 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | ### 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | ### 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/receiving-email-notifications-contents.html) | ## 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 contenant l'heure à laquelle l'e-mail a été reçu, au ISO8601 format. | | 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`](#receiving-email-notifications-contents-mail-object-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. | # Exemples de notifications pour la réception d'e-mails via Amazon SES Cette section inclut des exemples des trois types de notification suivants : + [Notification envoyée à la suite d'une action sur le réseau social.](#receiving-email-notifications-examples-sns-action) + [Une notification envoyée à la suite d'un autre type d'action](#receiving-email-notifications-examples-alert) (une *notification d'alerte*). ## Notification d'une action SNS Cette section contient un exemple d'une notification d'action SNS. Contrairement à la notification d'alerte illustrée précédemment, cette notification inclut une section `content` contenant l'e-mail, généralement au format Multipurpose Internet Mail Extensions (MIME). ``` { "notificationType":"Received", "receipt":{ "timestamp":"2015-09-11T20:32:33.936Z", "processingTimeMillis":222, "recipients":[ "recipient@example.com" ], "spamVerdict":{ "status":"PASS" }, "virusVerdict":{ "status":"PASS" }, "spfVerdict":{ "status":"PASS" }, "dkimVerdict":{ "status":"PASS" }, "action":{ "type":"SNS", "topicArn":"arn:aws:sns:us-east-1:012345678912:example-topic" } }, "mail":{ "timestamp":"2015-09-11T20:32:33.936Z", "source":"61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com", "messageId":"d6iitobk75ur44p8kdnnp7g2n800", "destination":[ "recipient@example.com" ], "headersTruncated":false, "headers":[ { "name":"Return-Path", "value":"<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name":"Received", "value":"from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name":"DKIM-Signature", "value":"v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name":"From", "value":"sender@example.com" }, { "name":"To", "value":"recipient@example.com" }, { "name":"Subject", "value":"Example subject" }, { "name":"MIME-Version", "value":"1.0" }, { "name":"Content-Type", "value":"text/plain; charset=UTF-8" }, { "name":"Content-Transfer-Encoding", "value":"7bit" }, { "name":"Date", "value":"Fri, 11 Sep 2015 20:32:32 +0000" }, { "name":"Message-ID", "value":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>" }, { "name":"X-SES-Outgoing", "value":"2015.09.11-54.240.9.183" }, { "name":"Feedback-ID", "value":"1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" } ], "commonHeaders":{ "returnPath":"0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "from":[ "sender@example.com" ], "date":"Fri, 11 Sep 2015 20:32:32 +0000", "to":[ "recipient@example.com" ], "messageId":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>", "subject":"Example subject" } }, "content":"Return-Path: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nReceived: from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183])\r\n by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800\r\n for recipient@example.com;\r\n Fri, 11 Sep 2015 20:32:33 +0000 (UTC)\r\nDKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;\r\n\ts=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552;\r\n\th=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID;\r\n\tbh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=;\r\n\tb=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF\r\n\thlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX\r\n\t4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=\r\nFrom: sender@example.com\r\nTo: recipient@example.com\r\nSubject: Example subject\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\nDate: Fri, 11 Sep 2015 20:32:32 +0000\r\nMessage-ID: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nX-SES-Outgoing: 2015.09.11-54.240.9.183\r\nFeedback-ID: 1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES\r\n\r\nExample content\r\n" } ``` ## Notification d'alerte Cette section contient un exemple d'une notification Amazon SNS qui peut être déclenchée par une action S3. Les notifications déclenchées par des actions Lambda, des actions de retour à l'expéditeur, des actions d'arrêt et des actions WorkMail sont similaires. Si la notification contient des informations sur l'e-mail, elle ne contient pas le contenu de l'e-mail lui-même. ``` { "notificationType": "Received", "receipt": { "timestamp": "2015-09-11T20:32:33.936Z", "processingTimeMillis": 406, "recipients": [ "recipient@example.com" ], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "PASS" }, "action": { "type": "S3", "topicArn": "arn:aws:sns:us-east-1:012345678912:example-topic", "bucketName": "my-S3-bucket", "objectKey": "\email" } }, "mail": { "timestamp": "2015-09-11T20:32:33.936Z", "source": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "messageId": "d6iitobk75ur44p8kdnnp7g2n800", "destination": [ "recipient@example.com" ], "headersTruncated": false, "headers": [ { "name": "Return-Path", "value": "<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name": "Received", "value": "from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Example subject" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/plain; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" }, { "name": "Date", "value": "Fri, 11 Sep 2015 20:32:32 +0000" }, { "name": "Message-ID", "value": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>" }, { "name": "X-SES-Outgoing", "value": "2015.09.11-54.240.9.183" }, { "name": "Feedback-ID", "value": "1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" } ], "commonHeaders": { "returnPath": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "from": [ "sender@example.com" ], "date": "Fri, 11 Sep 2015 20:32:32 +0000", "to": [ "recipient@example.com" ], "messageId": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>", "subject": "Example subject" } } } ``` # Arrêt de l'action de jeu de règles L'action **Stop** (Arrêt) met fin à l'évaluation de l'ensemble de règles de réception et vous avertit éventuellement via Amazon SNS. Cette action comporte les options suivantes. + **SNS Topic – **Nom ou ARN de la rubrique Amazon SNS à avertir lorsque l'action d'arrêt est exécutée. Voici un exemple d'ARN de rubrique Amazon SNS *: arn:aws:sns:us-east- 1:123456789012 :*. MyTopic Vous pouvez également créer une rubrique Amazon SNS lorsque vous configurez une action en choisissant **Create SNS Topic (Créer une rubrique SNS)**. Pour de plus amples informations sur les rubriques Amazon SNS, consultez le [guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **Note** La rubrique Amazon SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. # Intégrer à Amazon WorkMail Action L'**WorkMail**action s'intègre à Amazon WorkMail. Si Amazon WorkMail effectue l'ensemble du traitement de vos e-mails, vous n'utiliserez généralement pas cette action directement, car Amazon WorkMail s'occupe de la configuration. Cette action comporte les options suivantes. + **ARN de l'organisation** : ARN de l' WorkMailorganisation Amazon. WorkMail L'organisation Amazon ARNs se présente sous la forme`arn:aws:workmail:region:account_ID:organization/organization_ID`, où : + `region`est la région dans laquelle vous utilisez Amazon SES et Amazon WorkMail. (Vous devez les utiliser depuis la même région.) Par exemple, us-east-1. + `account_ID`est l'identifiant du AWS compte. Vous trouverez votre identifiant de AWS compte sur la page [Compte](https://console.aws.amazon.com/billing/home?#/account) de la console de AWS gestion. + `organization_ID`est un identifiant unique WorkMail généré par Amazon lorsque vous créez une organisation. Vous pouvez trouver l'identifiant de l'organisation dans la WorkMail console Amazon sur la page des paramètres de votre organisation. Voici un exemple d'ARN complet d'une WorkMail organisation Amazon *: arn:aws:workmail:us-east- 1:123456789012:organization/m-68755160c4cb4e29a2b2f8fb58f359d7*. Pour plus d'informations sur WorkMail les organisations Amazon, consultez le [guide de WorkMail l'administrateur Amazon](https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html). + **Rubrique SNS :** nom ou ARN de la rubrique Amazon SNS à avertir lorsque l'action WorkMail Amazon est entreprise. Voici un exemple d'ARN de rubrique Amazon SNS *: arn:aws:sns:us-east- 1:123456789012 :*. MyTopic Vous pouvez également créer une rubrique Amazon SNS lorsque vous configurez une action en choisissant **Create SNS Topic (Créer une rubrique SNS)**. Pour de plus amples informations sur les rubriques Amazon SNS, consultez le [guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **Note** La rubrique Amazon SNS que vous choisissez doit se trouver dans la même AWS région que le point de terminaison Amazon SES que vous utilisez pour recevoir des e-mails. **Note** Amazon SES ne prend en charge les WorkMail actions que dans les régions où WorkMail elles sont disponibles. Consultez les [ WorkMail points de terminaison et les quotas Amazon](https://docs.aws.amazon.com/general/latest/gr/workmail.html) dans le Références générales AWS.