Journalisation des appels d'API Amazon Comprehend avec AWS CloudTrail

Amazon Comprehend est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans Amazon Comprehend. CloudTrail capture les appels d'API pour Amazon Comprehend sous forme d'événements. Les appels capturés incluent des appels provenant de la console Amazon Comprehend et des appels de code vers les opérations de l'API Amazon Comprehend. 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 Amazon Comprehend. 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. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande envoyée à Amazon Comprehend, 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, notamment comment le configurer et l'activer, consultez le guide de AWS CloudTrail l'utilisateur.

Informations sur Amazon Comprehend dans CloudTrail

CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. Lorsqu'une activité événementielle prise en charge se produit dans Amazon Comprehend, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans l'historique des événements. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements.

Pour un enregistrement continu des événements de votre entrepriseCompte AWS, y compris des événements pour Amazon Comprehend, 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 journal de suivi 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 AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour en savoir plus, 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 notifications Amazon SNS pour CloudTrail

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

Amazon Comprehend prend en charge l'enregistrement des actions suivantes sous forme d'événements dans des fichiers CloudTrail journaux :

• BatchDetectDominantLanguage

• BatchDetectEntities

• BatchDetectKeyPhrases

• BatchDetectSentiment

• BatchDetectSyntax

• ClassifyDocument

• CreateDocumentClassifier

• CreateEndpoint

• CreateEntityRecognizer

• DeleteDocumentClassifier

• DeleteEndpoint

• DeleteEntityRecognizer

• DescribeDocumentClassificationJob

• DescribeDocumentClassifier

• DescribeDominantLanguageDetectionJob

• DescribeEndpoint

• DescribeEntitiesDetectionJob

• DescribeEntityRecognizer

• DescribeKeyPhrasesDetectionJob

• DescribePiiEntitiesDetectionJob

• DescribeSentimentDetectionJob

• DescribeTargetedSentimentDetectionJob

• DescribeTopicsDetectionJob

• DetectDominantLanguage

• DetectEntities

• DetectKeyPhrases

• DetectPiiEntities

• DetectSentiment

• DetectSyntax

• ListDocumentClassificationJobs

• ListDocumentClassifiers

• ListDominantLanguageDetectionJobs

• ListEndpoints

• ListEntitiesDetectionJobs

• ListEntityRecognizers

• ListKeyPhrasesDetectionJobs

• ListPiiEntitiesDetectionJobs

• ListSentimentDetectionJobs

• ListTargetedSentimentDetectionJobs

• ListTagsForResource

• ListTopicsDetectionJobs

• StartDocumentClassificationJob

• StartDominantLanguageDetectionJob

• StartEntitiesDetectionJob

• StartKeyPhrasesDetectionJob

• StartPiiEntitiesDetectionJob

• StartSentimentDetectionJob

• StartTargetedSentimentDetectionJob

• StartTopicsDetectionJob

• StopDominantLanguageDetectionJob

• StopEntitiesDetectionJob

• StopKeyPhrasesDetectionJob

• StopPiiEntitiesDetectionJob

• StopSentimentDetectionJob

• StopTargetedSentimentDetectionJob

• StopTrainingDocumentClassifier

• StopTrainingEntityRecognizer

• TagResource

• UntagResource

• UpdateEndpoint

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent 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é effectuée par un autre service AWS.

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

Exemple : entrées du fichier journal Amazon Comprehend

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

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

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AROAICFHPEXAMPLE",
        "arn": "arn:aws:iam::12345678910:user/myadmin2",
        "accountId": "12345678910",
        "accessKeyId": "ASIA3VZEXAMPLE",
        "sessionContext": {
            "sessionIssuer": {},
            "webIdFederationData": {},
            "attributes": {
                "creationDate": "2023-10-19T14:22:09Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2023-10-19T17:31:20Z",
    "eventSource": "comprehend.amazonaws.com",
    "eventName": "ClassifyDocument",
    "awsRegion": "us-east-2",
    "sourceIPAddress": "3.21.185.237",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:109.0) Gecko/20100101 Firefox/115.0",
    "requestParameters": null,
    "responseElements": null,
    "requestID": "fd916e66-caac-46c9-a1fc-81a0ef33e61b",
    "eventID": "535ca22b-b3a3-4c13-b2c5-bf51ab082794",
    "readOnly": false,
    "resources": [
        {
            "accountId": "12345678910",
            "type": "AWS::Comprehend::DocumentClassifierEndpoint",
            "ARN": "arn:aws:comprehend:us-east-2:12345678910:document-classifier-endpoint/endpointExample"
        }
    ],
    "eventType": "AwsApiCall",
    "recipientAccountId": "12345678910"
}