Utilisation AWS CloudTrail pour enregistrer les appels d'API

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.

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.

Le SDK Amazon Chime est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions effectuées dans le SDK Amazon Chime par un utilisateur, un rôle ou un service. AWS CloudTrail capture tous les appels d'API pour le SDK Amazon Chime sous forme d'événements, y compris les appels depuis la console du SDK Amazon Chime et les appels de code vers le SDK Amazon Chime. APIs

Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrailévénements vers un compartiment Amazon S3, y compris des événements pour le SDK Amazon Chime. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console sur la page Historique des événements. Les informations incluent chaque demande, les adresses IP à partir desquelles les demandes ont été effectuées et l'auteur de la demande.

CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsque la console d'administration Amazon Chime effectue un appel d'API, elle CloudTrail enregistre cette activité dans le cadre d'un événement. Pour voir les événements, démarrez la CloudTrail console et accédez à Historique des événements. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements.

Pour en savoir plus CloudTrail, consultez le guide de AWS CloudTrail l'utilisateur.

Création d’un journal de suivi

Les rubriques suivantes expliquent comment utiliser la CloudTrail console pour créer un parcours. Par défaut, lorsque vous créez un journal dans la console, celui-ci enregistre les événements de toutes les régions de la AWS partition et transmet les fichiers journaux au compartiment Amazon S3 que vous spécifiez.

Suivez ces sujets dans l'ordre indiqué.

Données capturées par un sentier

CloudTrail enregistre toutes les actions du SDK Amazon Chime. Pour plus d'informations sur les actions, reportez-vous à la référence d'API du SDK Amazon Chime. Par exemple, les appels au CreateAttendee, action génère des entrées dans les fichiers CloudTrail journaux. Chaque événement 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 :

Pour de plus amples informations, veuillez consulter l'élément userIdentity CloudTrail.

Comprendre les entrées du fichier journal du SDK Amazon Chime

Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande individuelle à partir d'une source quelconque et comprend des informations sur l'action demandée, la date et l'heure, les paramètres de la demande, etc. Les fichiers journaux CloudTrail ne sont pas des séries ordonnées retraçant les appels d'API publics. Ils ne suivent aucun ordre précis.

Les entrées du SDK Amazon Chime sont identifiées par la source d'événements chime.amazonaws.com.

Si vous avez configuré Active Directory pour votre compte Amazon Chime SDK, consultez Logging AWS Directory Service API calls using. CloudTrail Cela décrit comment détecter les problèmes susceptibles d'affecter la capacité des utilisateurs de votre SDK Amazon Chime à se connecter.

L'exemple suivant montre une entrée de CloudTrail journal pour le SDK Amazon Chime :

{"eventVersion":"1.05",
         "userIdentity":{  
            "type":"IAMUser",
            "principalId":"AAAAAABBBBBBBBEXAMPLE",
            "arn":"arn:aws:iam::123456789012:user/Alice",
            "accountId":"0123456789012",
            "accessKeyId":"AAAAAABBBBBBBBEXAMPLE",
            "sessionContext":{  
               "attributes":{  
                  "mfaAuthenticated":"false",
                  "creationDate":"2017-07-24T17:57:43Z"
               },
               "sessionIssuer":{  
                  "type":"Role",
                  "principalId":"AAAAAABBBBBBBBEXAMPLE",
                  "arn":"arn:aws:iam::123456789012:role/Joe",
                  "accountId":"123456789012",
                  "userName":"Joe"
               }
            }
         } ,
         "eventTime":"2017-07-24T17:58:21Z",
         "eventSource":"chime.amazonaws.com",
         "eventName":"AddDomain",
         "awsRegion":"us-east-1",
         "sourceIPAddress":"72.21.198.64",
         "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36",
         "errorCode":"ConflictException",
         "errorMessage":"Request could not be completed due to a conflict",
         "requestParameters":{  
            "domainName":"example.com",
            "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00"
         },
         "responseElements":null,
         "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1",
         "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
      }