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.
Journalisation des appels d'API Amazon SES avec AWS CloudTrail
Amazon S3 est intégré à AWS CloudTrail, service qui enregistre les actions effectuées par un utilisateur, un rôle ou un service AWS dans Amazon SES. CloudTrail capture les appels d'API pour Amazon SES en tant qu'événements. Ces captures incluent les appels de la console Amazon SES et les appels de code vers les opérations d'API Amazon SES. Si vous créez un journal d'activité, vous pouvez activer la livraison continue des événements CloudTrail dans un compartiment Amazon S3, y compris les événements pour Amazon SES. Si vous ne configurez pas de journal d'activité, vous pouvez toujours afficher les événements les plus récents dans la console CloudTrail dans Event history (Historique des événements). Avec les informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été envoyée à Amazon SES, l'adresse IP à partir de laquelle la demande a été effectuée, l'auteur et la date de la demande, ainsi que d'autres détails.
Pour en savoir plus sur CloudTrail, y compris la façon de le configurer et de l'activer, consultez le AWS CloudTrail Guide de l'utilisateur.
Informations relatives à Amazon SES dans CloudTrail
CloudTrail est activé dans votre Compte AWS lors de la création de ce dernier. Quand une activité d'événement prise en charge a lieu dans Amazon SES, elle est enregistrée dans un événement CloudTrail avec d'autres événements de service AWS dans Event history (Historique des événements). Vous pouvez afficher, rechercher et télécharger les événements récents dans votre Compte AWS. Pour de plus amples informations, veuillez consulter Affichage des événements avec l'historique des événements CloudTrail.
Pour un registre continu des événements dans votre Compte AWS, y compris les événements pour Amazon SES, créez un journal d'activité. Un journal d'activité permet à CloudTrail de distribuer les fichiers journaux vers Simple Storage Service (Amazon S3) bucket. Par défaut, lorsque vous créez un journal d'activité dans la console, il s'applique à toutes les régions Régions AWS. Le journal de suivi consigne les événements de toutes les Régions dans la partition AWS et livre les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d'autres services AWS pour analyser et agir sur les données d'événements collectées dans les journaux CloudTrail. Pour en savoir plus, consultez les ressources suivantes :
Amazon SES prend en charge la journalisation de toutes les actions répertoriées dans la Référence d'API SES et la Référence d'API SES v2en tant qu'événements dans les fichiers journaux CloudTrail, sauf ceux indiqués dans la zone de notes ci-dessous :
Note
Amazon SES fournit des événements de gestion à CloudTrail. Les événements de gestion incluent les actions qui sont liées à la création et à la gestion des ressources dans votre Compte AWS. Dans Amazon SES, les événements de gestion incluent des actions telles que la création et la suppression d'identités ou de règles de réception.
Les événements de gestion sont différents des événements de données. Les événements de données sont des événements qui sont liés à l'accès des données et à l'interaction avec celles-ci au sein de votre Compte AWS. Dans Amazon SES, les événements de données incluent des actions telles que l'envoi d'e-mails.
Comme Amazon SES fournit uniquement des événements de gestion à CloudTrail, les événements suivants ne sont pas enregistrés dans CloudTrail :
-
SendEmail
-
SendRawEmail
-
SendTemplatedEmail
-
SendBulkTemplatedEmail
Vous pouvez utiliser la publication d'événements pour enregistrer les événements liés à l'envoi d'e-mails. Pour de plus amples informations, veuillez consulter Surveillance de l'envoi d'e-mails à l'aide de la publication d'événements Amazon SES.
Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l'identité permettent de déterminer les éléments suivants :
-
Si la demande a été effectuée avec les informations d'identification utilisateur racine ou AWS Identity and Access Management (IAM).
-
Si la demande a été effectuée avec les informations d'identification de sécurité temporaires d'un rôle ou d'un utilisateur fédéré.
-
Si la requête a été effectuée par un autre service AWS.
Pour en savoir plus, consultez l'élément userIdentity CloudTrail.
Exemple : entrées du fichier journal Amazon SES
Un journal d'activité est une configuration qui permet d'envoyer des événements sous forme de fichiers journaux à un compartiment Simple Storage Service (Amazon S3) que vous spécifiez. Les fichiers journaux CloudTrail peuvent contenir une ou plusieurs entrées. Un événement représente une demande unique provenant de n'importe quelle source et comprend des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la requête, etc. Les fichiers journaux CloudTrail ne constituent pas une série ordonnée retraçant les appels d'API publiques. Ils ne suivent aucun ordre précis.
L'exemple suivant montre une entrée de journal CloudTrail qui illustre les actions DeleteIdentity et VerifyEmailIdentity.
{ "Records":[ { "awsRegion":"us-west-2", "eventID":"0ffa308d-1467-4259-8be3-c749753be325", "eventName":"DeleteIdentity", "eventSource":"ses.amazonaws.com", "eventTime":"2018-02-02T21:34:50Z", "eventType":"AwsApiCall", "eventVersion":"1.02", "recipientAccountId":"111122223333", "requestID":"50b87bfe-ab23-11e4-9106-5b36376f9d12", "requestParameters":{ "identity":"amazon.com" }, "responseElements":null, "sourceIPAddress":"192.0.2.0", "userAgent":"aws-sdk-java/unknown-version", "userIdentity":{ "accessKeyId":"AKIAIOSFODNN7EXAMPLE", "accountId":"111122223333", "arn":"arn:aws:iam::111122223333:root", "principalId":"111122223333", "type":"Root" } }, { "awsRegion":"us-west-2", "eventID":"5613b0ff-d6c6-4526-9b53-a603a9231725", "eventName":"VerifyEmailIdentity", "eventSource":"ses.amazonaws.com", "eventTime":"2018-02-04T01:05:33Z", "eventType":"AwsApiCall", "eventVersion":"1.02", "recipientAccountId":"111122223333", "requestID":"eb2ff803-ac09-11e4-8ff5-a56a3119e253", "requestParameters":{ "emailAddress":"sender@example.com" }, "responseElements":null, "sourceIPAddress":"192.0.2.0", "userAgent":"aws-sdk-java/unknown-version", "userIdentity":{ "accessKeyId":"AKIAIOSFODNN7EXAMPLE", "accountId":"111122223333", "arn":"arn:aws:iam::111122223333:root", "principalId":"111122223333", "type":"Root" } } ] }
