Utilisation AWS CloudTrail pour enregistrer les appels d'API

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 les API du SDK Amazon Chime.

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é.

1. Présentation de la création d’un journal de suivi

2. CloudTrail services et intégrations pris en charge

3. Configuration des notifications Amazon SNS pour CloudTrail

4. Réception de fichiers CloudTrail journaux de plusieurs régions et réception de fichiers CloudTrail journaux de plusieurs comptes

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 au manuel de référence de l'API du SDK Amazon Chime. Par exemple, les appels à l'CreateAttendeeaction génèrent 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 :

• Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou IAM.

• Si la demande a été effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré.

• Si la demande a été faite par un autre AWS service.

Pour plus d'informations, consultez l'élément CloudTrailUserIdentity.

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 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 demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.

Les entrées pour le 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"
      }