View a markdown version of this page

Journalisation des appels d'API Amazon Inspector à l'aide de AWS CloudTrail - Amazon Inspector
Informations sur Amazon Inspector dans CloudTrailComprendre les entrées du fichier journal Amazon InspectorAmazon Inspector Scannez les informations dans CloudTrail

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 Amazon Inspector à l'aide de AWS CloudTrail

Amazon Inspector est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur ou un Service AWS rôle IAM dans Amazon Inspector. CloudTrail capture tous les appels d'API pour Amazon Inspector sous forme d'événements. Les appels capturés incluent les appels provenant de la console Amazon Inspector et les appels aux opérations de l'API Amazon Inspector. Si vous créez un historique, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour Amazon Inspector. 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. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer :

  • La demande qui a été faite à Amazon Inspector.

  • Adresse IP à partir de laquelle la demande a été effectuée.

  • la personne ayant formulé la requête ;

  • Quand la demande a été faite.

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

Informations sur Amazon Inspector dans CloudTrail

CloudTrail est activé Compte AWS lors de la création de votre compte. Lorsqu'une activité se produit dans Amazon Inspector, elle est enregistrée dans un CloudTrail événement avec d'autres Service AWS événements dans l'historique des événements. Vous pouvez consulter, 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 permanent des événements qui vous concernent Compte AWS, y compris ceux qui concernent Amazon Inspector, créez un historique. Un journal permet CloudTrail de transmettre 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 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 Simple Storage Service (Amazon S3) de votre choix. En outre, vous pouvez en configurer d'autres Services AWS pour analyser plus en profondeur les données d'événements collectées dans les CloudTrail journaux et y donner suite. Pour plus d’informations, consultez les rubriques suivantes :

Toutes les actions d'Amazon Inspector sont enregistrées par CloudTrail. Toutes les actions qu'Amazon Inspector peut effectuer sont documentées dans la référence d'API Amazon Inspector. Par exemple, les appels adressés aux actions CreateFindingsReport ListCoverage, UpdateOrganizationConfiguration génèrent des entrées dans les fichiers journaux CloudTrail .

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 :

  • Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou d’utilisateur 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 requête a été effectuée par un autre Service AWS.

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

Comprendre les entrées du fichier journal Amazon Inspector

Un journal 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 d’une source quelconque. Les événements incluent 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 sont pas une pile ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.

Amazon Inspector Scannez les informations dans CloudTrail

Amazon Inspector Scan est intégré à CloudTrail. Toutes les opérations de l'API Amazon Inspector Scan sont enregistrées en tant qu'événements de gestion. Pour obtenir la liste des opérations de l'API Amazon Inspector Scan auxquelles Amazon Inspector se connecte CloudTrail, consultez Amazon Inspector Scan dans le manuel Amazon Inspector API Reference.

L'exemple suivant montre une entrée de CloudTrail journal qui illustre l'ScanSbomaction :


{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA123456789EXAMPLE:akua_mansa",
        "arn": "arn:aws:sts::111122223333:assumed-role/Admin/akua_mansa",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROA123456789EXAMPLE",
                "arn": "arn:aws:iam::111122223333:role/Admin",
                "accountId": "111122223333",
                "userName": "Admin"
            },
            "webIdFederationData": {},
            "attributes": {
                "creationDate": "2023-10-17T15:22:59Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2023-10-17T16:02:34Z",
    "eventSource": "gamma-inspector-scan.amazonaws.com",
    "eventName": "ScanSbom",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "203.0.113.0",
    "userAgent": "aws-sdk-java/2.20.162 Mac_OS_X/13.5.2 OpenJDK_64-Bit_Server_VM/17.0.8+7-LTS Java/17.0.8 vendor/Amazon.com_Inc. io/sync http/UrlConnection cfg/retry-mode/legacy",
    "requestParameters": {
        "sbom": {
            "specVersion": "1.5",
            "metadata": {
                "component": {
                    "name": "debian",
                    "type": "operating-system",
                    "version": "9"
                }
            },
            "components": [
                {
                    "name": "packageOne",
                    "purl": "pkg:deb/debian/packageOne@1.0.0?arch=x86_64&distro=9",
                    "type": "application"
                }
            ],
            "bomFormat": "CycloneDX"
        }
    },
    "responseElements": null,
    "requestID": "f041a27f-f33e-4f70-b09b-5fbc5927282a",
    "eventID": "abc8d1e4-d214-4f07-bc56-8a31be6e36fe",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "111122223333",
    "eventCategory": "Management"
}