Enregistrement des API appels Amazon Translate avec AWS CloudTrail

Amazon Translate est intégré à AWS CloudTrail, un service qui fournit un enregistrement des actions entreprises par une IAM entité ou AWS service dans Amazon Translate. CloudTrail capture tous les API appels pour Amazon Translate sous forme d'événements. Cela inclut les appels depuis la console Amazon Translate et les appels de code vers les API opérations Amazon Translate. Si vous créez un suivi CloudTrail , vous pouvez activer la diffusion continue des CloudTrail événements, y compris des événements pour Amazon Translate, vers un bucket Amazon Simple Storage Service (Amazon S3). Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans Historique des événements. Vous pouvez utiliser les informations collectées par CloudTrail pour déterminer la demande envoyée à Amazon Translate, l'adresse IP à partir de laquelle la demande a été faite, l'auteur de la demande, la date à laquelle elle a été faite, ainsi que des informations supplémentaires.

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

Informations Amazon Translate en CloudTrail

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

Pour un enregistrement continu des événements survenus dans votre AWS compte, y compris les événements pour Amazon Translate, créez un parcours. Un suivi permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un parcours avec la console, celui-ci s'applique à toutes les AWS régions. Le sentier enregistre les événements de toutes les régions du AWS partitionne et envoie les fichiers journaux dans le compartiment S3 que vous spécifiez. Vous pouvez configurer d'autres AWS des services permettant d'analyser plus en profondeur et d'agir sur les données d'événements collectées dans CloudTrail les journaux. Pour plus d’informations, consultez les ressources suivantes :

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

• CloudTrail Services et intégrations pris en charge

• Configuration des SNS notifications Amazon pour CloudTrail

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

Toutes les actions Amazon Translate sont enregistrées CloudTrail et documentées dans la section API de référence. Par exemple, les appels au DeleteTerminology ImportTerminology et les TranslateText actions génèrent des entrées dans les fichiers CloudTrail journaux.

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Cette information permet de déterminer les éléments suivants :

• Si la demande a été faite avec les informations d'identification de l'utilisateur root

• 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 web

Pour plus d'informations, consultez l'CloudTrail userIdentityélément.

Comprendre les entrées du fichier journal Amazon Translate

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 inclut 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 API appels publics, ils n'apparaissent donc pas dans un ordre spécifique.

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'TranslateTextaction.

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AIDACKCEVSQ6C2EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/Administrator",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "Administrator"
    },
    "eventTime": "2019-09-03T20:32:50Z",
    "eventSource": "translate.amazonaws.com",
    "eventName": "TranslateText",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "192.0.2.0",
    "userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197",
    "requestParameters": {
        "text": "HIDDEN_DUE_TO_SECURITY_REASONS",
        "sourceLanguageCode": "en",
        "targetLanguageCode": "fr"
    },
    "responseElements": {
        "translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS",
        "sourceLanguageCode": "en",
        "targetLanguageCode": "fr"
    },
    "requestID": "f56da956-284e-4983-b6fc-59befa20e2bf",
    "eventID": "1dc75278-84d7-4bb2-861a-493d08d67391",
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}