Journalisation des AWS Serverless Application Repository appels d'API avec AWS CloudTrail - AWS Serverless Application Repository

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 AWS Serverless Application Repository appels d'API avec AWS CloudTrail

AWS Serverless Application Repositoryest intégré àAWS CloudTrail, qui enregistre les actions effectuées par un utilisateur, un rôle ou unAWSservice dans leAWS Serverless Application Repository. CloudTrailcapture les appels d'API pour leAWS Serverless Application Repositoryen tant qu'événements. Les appels capturés incluent des appels de la console AWS Serverless Application Repository et les appels de code vers les opérations d'API AWS Serverless Application Repository.

Si vous créez un journal de suivi, vous pouvez diffuser en continu lesCloudTrailévénements vers un compartiment Amazon S3, y compris des événements pour leAWS Serverless Application Repository. 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 Historique des événements.

En utilisant les informations collectées par CloudTrail, vous pouvez déterminer quelle demande a été faite à AWS Serverless Application Repository. Vous pouvez aussi déterminer l'adresse IP à partir de laquelle la demande a été faite, qui a effectué la demande, quand elle a eu lieu et autres informations supplémentaires.

Pour en savoir plus sur CloudTrail, veuillez consulter le Guide de l'utilisateur AWS CloudTrail.

Informations AWS Serverless Application Repository dans CloudTrail

CloudTrail est activé sur votre compte AWS lorsque vous créez le compte. Lorsqu'une activité a lieu dans AWS Serverless Application Repository, cette activité est enregistrée dans un événement CloudTrail avec d'autres événements de service AWS dans Historique des événements. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez Affichage des événements avec l'historique des événements CloudTrail.

Pour un enregistrement continu des événements dans votre compte AWS, y compris les événements pour AWS Serverless Application Repository, créez un journal de suivi. UNsentierpermetCloudTrailpour diffuser des fichiers journaux vers un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d'activité dans la console, il s'applique à toutes les régions AWS. Le journal d'activité consigne les événements de toutes les Régions dans la partition AWSAWS et transfère les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d'autres services AWS pour analyser plus en profondeur les données d'événement collectées dans les journaux CloudTrail et agir sur celles-ci. Pour en savoir plus, consultez les ressources suivantes :

Toutes les actions AWS Serverless Application Repository sont consignées par CloudTrail et documentées sur la page Ressources AWS Serverless Application Repository. À titre d'exemple, les appels vers les opérations CreateApplication, UpdateApplications et ListApplications et génèrent des entrées dans les fichiers journaux CloudTrail.

Chaque événement ou entrée du journal contient des informations sur la personne qui a généré 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 plus d'informations, consultez la section Élément userIdentity CloudTrail.

Présentation des entrées des fichiers journaux AWS Serverless Application Repository

Un journal d'activité est une configuration qui permet d'envoyer les événements dans des fichiers journaux à un compartiment Amazon S3 que vous spécifiez. Les fichiers journaux CloudTrail contiennent une ou plusieurs entrées de journal. 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 publics. Ils ne suivent aucun ordre précis.

L'exemple suivant montre une entrée de journal CloudTrail qui illustre l'action CreateApplication.

{ "eventVersion": "1.05", "userIdentity": { "type": "Root", "principalId": "999999999999", "arn": "arn:aws:iam::999999999999:root", "accountId": "999999999999", "accessKeyId": "ASIAUVPLBDH76HEXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-07-30T16:40:42Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2018-07-30T17:37:37Z", "eventSource": "serverlessrepo.amazonaws.com", "eventName": "CreateApplication", "awsRegion": "us-east-1", "sourceIPAddress": "72.21.217.161", "userAgent": "signin.amazonaws.com", "requestParameters": { "licenseBody": "<content of license>", "sourceCodeUrl": "<sample url>", "spdxLicenseId": "<sample license id>", "readmeBody": "<content of readme>", "author": "<author name>", "templateBody": "<content of SAM template>", "name": "<application name>", "semanticVersion": "<version>", "description": "<content of description>", "homePageUrl": "<sample url>", "labels": [ "<label1>", "<label2>" ] }, "responseElements": { "licenseUrl": "<url to access content of license>", "readmeUrl": "<url to access content of readme>", "spdxLicenseId": "<sample license id>", "creationTime": "2018-07-30T17:37:37.045Z", "author": "<author name>", "name": "<application name>", "description": "<content of description>", "applicationId": "arn:aws:serverlessrepo:us-east-1:999999999999:applications/<application name>", "homePageUrl": "<sample url>", "version": { "applicationId": "arn:aws:serverlessrepo:us-east-1:999999999999:applications/<application name>", "semanticVersion": "<version>", "sourceCodeUrl": "<sample url>", "templateUrl": "<url to access content of SAM template>", "creationTime": "2018-07-30T17:37:37.027Z", "parameterDefinitions": [ { "name": "<parameter name>", "description": "<parameter description>", "type": "<parameter type>" } ] }, "labels": [ "<label1>", "<label2>" ] }, "requestID": "3f50d899-941f-11e8-ab18-01063f863be5", "eventID": "a66a6490-d388-4a4f-8c7b-9d6ec61ab262", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "999999999999" }