Journalisation des appels d'API MediaLive avec AWS CloudTrail - AWS Elemental MediaLive

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 MediaLive avec AWS CloudTrail

AWS ElementalMediaLiveest intégré àAWS CloudTrail,CloudTrailest un service qui enregistre les actions réalisées par un utilisateur, un rôle ou unAWSservice. CloudTrail capture tous les appels d'API pour MediaLive en tant qu'événements. Les appels capturés incluent des appels de la console MediaLive et les appels de code vers les opérations d'API MediaLive. Si vous créez un journal de suivi, vous pouvez activer la livraison continue deCloudTrailévénements vers un compartiment Amazon S3, y compris des événements pourMediaLive. 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. Les informations collectées par CloudTrail, vous permettent de déterminer quelle demande a été envoyée à MediaLive, l'adresse IP source à partir de laquelle la demande a été effectuée, qui a effectué la demande, quand, ainsi que d'autres informations.

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

MediaLiveInformations dansCloudTrail

CloudTrail est activé sur votre compte AWS lorsque vous créez le compte. Lorsqu'une activité a lieu dans MediaLive, cette activité 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 AWS compte. Pour plus d'informations, consultez Affichage des événements avec l'historique des événements CloudTrail.

Pour enregistrer en continu les événements dans votre compte AWS, y compris les événements d'MediaLive, créez un journal d'activité. UNsentierpermetCloudTrailpour livrer des fichiers journaux à 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 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 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 :

TousMediaLiveles actions sont enregistrées parCloudTrailet sont documentés dans le https://docs.aws.amazon.com/medialive/latest/apireference/.

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 MediaLive entrées des fichiers journaux

Un journal de suivi 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 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 illustre une entrée de journal CloudTrail. L'exemple montre l'entrée pour un appel d'API. L'appel est effectué par l'identité spécifiée dansuserIdentity, dans ce cas, un utilisateur IAM portant le nom d'utilisateursantosp. L'appel était une opération CreateInput provenant de l'AWS CLI (comme indiqué dans userAgent) s'exécutant sur un ordinateur avec l'adresse IP 203.0.113.33 :

{ “eventVersion”: “1.05", “userIdentity”: { “type”: “IAMUser”, “principalId”: “AIDACKCEVSQ6C2EXAMPLE”, “arn”: “arn:aws:iam::111122223333:user/santosp”, “accountId”: “111122223333”, “accessKeyId”: “AKIAOSFODNN7EXAMPLE”, “userName”: “santosp” }, “eventTime”: “2019-01-17T21:21:17Z”, “eventSource”: “medialive.amazonaws.com”, “eventName”: “CreateInput”, “awsRegion”: “us-west-2”, “sourceIPAddress”: “203.0.113.33”, “userAgent”: “aws-cli/1.16.86 Python/2.7.15 Darwin/17.7.0 botocore/1.12.76”, “requestParameters”: { “mediaConnectFlows”: [], “inputSecurityGroups”: [ “9999999” ], “sources”: [], “roleArn”: “MediaLiveAccessRole”, “requestId”: “1111aaaa-9604-4459-a160-46a28ae166", “name”: “live-studio-feed”, “type”: “RTP_PUSH”, } }, “responseElements”: { “input”: { “arn”: “arn:aws:medialive:us-west-2:111122223333:input:7780651”, “id”: “7780651”, “name”: “live-studio-feed”, “type”: “RTP_PUSH”, “sources”: [], “destinations”: [ { “url”: “rtp://198.51.100.10:1935”, “ip”: “198.51.100.10:1935”, “port”: “1935” }, { “url”: “rtp://192.0.2.131:1935”, “ip”: “192.0.2.131:1935”, “port”: “1935” } ], “mediaConnectFlows”: [], “state”: “DETACHED”, “attachedChannels”: [], “securityGroups”: [ “9999999” ], “roleArn”: “” } }, “requestID”: “d2f882ac-1a9d-11e9-a0e5-afe6a8c88993”, “eventID”: “ebbe0290-7a1b-4053-a219-367404e0fe96”, “readOnly”: false, “eventType”: “AwsApiCall”, “recipientAccountId”: “111122223333" }