View a markdown version of this page

Création de réponses personnalisées aux résultats d'Amazon Inspector avec Amazon EventBridge - Amazon Inspector
Schéma d'événementCréation d'une EventBridge règle pour vous informer des résultats d'Amazon InspectorEventBridge pour les environnements multi-comptes Amazon Inspector

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.

Création de réponses personnalisées aux résultats d'Amazon Inspector avec Amazon EventBridge

Amazon Inspector crée un événement dans Amazon EventBridge pour les résultats récemment générés et les résultats agrégés. Amazon Inspector crée également un événement pour toute modification de l'état d'une découverte. Cela signifie qu'Amazon Inspector crée un nouvel événement pour une découverte lorsque vous effectuez des actions telles que le redémarrage d'une ressource ou la modification des balises associées à une ressource. Lorsqu'Amazon Inspector crée un nouvel événement pour une découverte mise à jour, celle-ci id reste la même.

Note

Si votre compte est un compte d'administrateur délégué Amazon Inspector, EventBridge publie les événements sur votre compte et sur le compte membre dont ils sont issus.

Lorsque vous utilisez EventBridge les événements avec Amazon Inspector, vous pouvez automatiser les tâches pour vous aider à résoudre les problèmes de sécurité révélés par vos résultats. Pour recevoir des notifications concernant les résultats d'Amazon Inspector en fonction d' EventBridge événements, vous devez créer une EventBridge règle et spécifier une cible pour Amazon Inspector. La EventBridge règle permet d' EventBridge envoyer des notifications pour les résultats d'Amazon Inspector, et la cible indique où envoyer les notifications.

Amazon Inspector émet des événements vers le bus d'événements par défaut dans Région AWS lequel vous utilisez actuellement Amazon Inspector. Cela signifie que vous devez configurer des règles d'événements pour chaque Région AWS fois que vous avez activé Amazon Inspector et configuré Amazon Inspector pour recevoir des EventBridge événements. Amazon Inspector émet des événements dans la mesure du possible.

Cette section fournit un exemple de schéma d'événement et décrit comment créer une EventBridge règle.

Schéma d'événement

Voici un exemple du format d'événement Amazon Inspector pour un événement de recherche EC2. Pour un exemple de schéma d'autres types de recherche et types d'événements, voirSchéma EventBridge d'événements Amazon pour les événements Amazon Inspector.


{
    "version": "0",
    "id": "66a7a279-5f92-971c-6d3e-c92da0950992",
    "detail-type": "Inspector2 Finding",
    "source": "aws.inspector2",
    "account": "111122223333",
    "time": "2023-01-19T22:46:15Z",
    "region": "us-east-1",
    "resources": ["i-0c2a343f1948d5205"],
    "detail": {
        "awsAccountId": "111122223333",
        "description": "\n It was discovered that the sound subsystem in the Linux kernel contained a\n race condition in some situations. A local attacker could use this to cause\n a denial of service (system crash).",
        "exploitAvailable": "YES",
        "exploitabilityDetails": {
            "lastKnownExploitAt": "Oct 24, 2022, 11:08:59 PM"
        },
        "findingArn": "arn:aws:inspector2:us-east-1:111122223333:finding/FINDING_ID",
        "firstObservedAt": "Jan 19, 2023, 10:46:15 PM",
        "fixAvailable": "YES",
        "lastObservedAt": "Jan 19, 2023, 10:46:15 PM",
        "packageVulnerabilityDetails": {
            "cvss": [{
                "baseScore": 4.7,
                "scoringVector": "CVSS:3.1/AV:L/AC:H/PR:L/UI:N/S:U/C:N/I:N/A:H",
                "source": "NVD",
                "version": "3.1"
            }],
            "referenceUrls": ["https://lore.kernel.org/all/CAFcO6XN7JDM4xSXGhtusQfS2mSBcx50VJKwQpCq=WeLt57aaZA@mail.gmail.com/", "https://ubuntu.com/security/notices/USN-5792-1", "https://ubuntu.com/security/notices/USN-5791-2", "https://ubuntu.com/security/notices/USN-5791-1", "https://ubuntu.com/security/notices/USN-5793-2", "https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=8423f0b6d513b259fdab9c9bf4aaa6188d054c2d", "https://ubuntu.com/security/notices/USN-5793-1", "https://ubuntu.com/security/notices/USN-5792-2", "https://ubuntu.com/security/notices/USN-5791-3", "https://ubuntu.com/security/notices/USN-5793-4", "https://ubuntu.com/security/notices/USN-5793-3", "https://git.kernel.org/linus/8423f0b6d513b259fdab9c9bf4aaa6188d054c2d(6.0-rc5)", "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-3303"],
            "relatedVulnerabilities": [],
            "source": "UBUNTU_CVE",
            "sourceUrl": "https://people.canonical.com/~ubuntu-security/cve/2022/CVE-2022-3303.html",
            "vendorCreatedAt": "Sep 27, 2022, 11:15:00 PM",
            "vendorSeverity": "medium",
            "vulnerabilityId": "CVE-2022-3303",
            "vulnerablePackages": [{
                "arch": "X86_64",
                "epoch": 0,
                "fixedInVersion": "0:5.15.0.1027.31~20.04.16",
                "name": "linux-image-aws",
                "packageManager": "OS",
                "remediation": "apt update && apt install --only-upgrade linux-image-aws",
                "version": "5.15.0.1026.30~20.04.16"
            }]
        },
        "remediation": {
            "recommendation": {
                "text": "None Provided"
            }
        },
        "resources": [{
            "details": {
                "awsEc2Instance": {
                    "iamInstanceProfileArn": "arn:aws:iam::111122223333:instance-profile/AmazonSSMRoleForInstancesQuickSetup",
                    "imageId": "ami-0b7ff1a8d69f1bb35",
                    "ipV4Addresses": ["172.31.85.212", "44.203.45.27"],
                    "ipV6Addresses": [],
                    "launchedAt": "Jan 19, 2023, 7:53:14 PM",
                    "platform": "UBUNTU_20_04",
                    "subnetId": "subnet-8213f2a3",
                    "type": "t2.micro",
                    "vpcId": "vpc-ab6650d1"
                }
            },
            "id": "i-0c2a343f1948d5205",
            "partition": "aws",
            "region": "us-east-1",
            "type": "AWS_EC2_INSTANCE"
        }],
        "severity": "MEDIUM",
        "status": "ACTIVE",
        "title": "CVE-2022-3303 - linux-image-aws",
        "type": "PACKAGE_VULNERABILITY",
        "updatedAt": "Jan 19, 2023, 10:46:15 PM"
    }
}

Création d'une EventBridge règle pour vous informer des résultats d'Amazon Inspector

Pour améliorer la visibilité des résultats d'Amazon Inspector, vous pouvez EventBridge configurer des alertes de recherche automatisées qui sont envoyées à un hub de messagerie. Cette rubrique explique comment envoyer des alertes CRITICAL et des résultats de HIGH gravité par e-mail, Slack ou Amazon Chime. Vous allez apprendre à configurer une rubrique Amazon Simple Notification Service, puis à associer cette rubrique à une règle d' EventBridge événement.

Étape 1. Configuration d'une rubrique et d'un point de terminaison Amazon SNS

Pour configurer des alertes automatiques, vous devez d'abord configurer un sujet dans Amazon Simple Notification Service et ajouter un point de terminaison. Pour plus d'informations, consultez le guide https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html SNS.

Cette procédure détermine où vous souhaitez envoyer les données relatives aux résultats d'Amazon Inspector. La rubrique SNS peut être ajoutée à une règle d' EventBridge événement pendant ou après la création de la règle d'événement.

Email setup
Création d'une rubrique SNS

  1. Connectez-vous à la console Amazon SNS à l'adresse https://console.aws.amazon.com/sns/v3/home.

  2. Dans le volet de navigation, sélectionnez Rubriques, puis sélectionnez Créer une rubrique.

  3. Dans la section Créer un sujet, sélectionnez Standard. Entrez ensuite un nom de rubrique, tel queInspector_to_Email. D'autres détails sont facultatifs.

  4. Choisissez Créer la rubrique. Un nouveau panneau contenant les détails de votre nouveau sujet s'ouvre.

  5. Dans la section Abonnements, sélectionnez Créer un abonnement.

    1. Dans le menu Protocole sélectionnez E-mail.

    2. Dans le champ Endpoint, saisissez l'adresse e-mail à laquelle vous souhaitez recevoir des notifications.

      Note

      Il vous sera demandé de confirmer votre abonnement via votre client de messagerie après avoir créé l'abonnement.

    3. Choisissez Créer un abonnement.

  7. Recherchez un message d'abonnement dans votre boîte de réception et choisissez Confirmer l'abonnement.

Slack setup
Création d'une rubrique SNS

  1. Connectez-vous à la console Amazon SNS à l'adresse https://console.aws.amazon.com/sns/v3/home.

  2. Dans le volet de navigation, sélectionnez Rubriques, puis sélectionnez Créer une rubrique.

  3. Dans la section Créer un sujet, sélectionnez Standard. Entrez ensuite un nom de rubrique, tel queInspector_to_Slack. D'autres détails sont facultatifs. Choisissez Créer un sujet pour terminer la création du point de terminaison.

Configuration d'un développeur Amazon Q dans un client d'applications de chat

  1. Accédez à la console Amazon Q Developer dans les applications de chat à l'adressehttps://console.aws.amazon.com/chatbot/.

  2. Dans le volet Clients configurés, sélectionnez Configurer un nouveau client.

  3. Choisissez Slack, puis sélectionnez Configurer pour confirmer.

    Note

    Lorsque vous choisissez Slack, vous devez confirmer les autorisations accordées à Amazon Q Developer dans les applications de chat pour accéder à votre chaîne en sélectionnant Autoriser.

  4. Sélectionnez Configurer un nouveau canal pour ouvrir le volet des détails de configuration.

    1. Saisissez un nom pour le canal.

    2. Pour la chaîne Slack, choisissez la chaîne que vous souhaitez utiliser.

    3. Dans Slack, copiez l'identifiant de la chaîne privée en cliquant avec le bouton droit sur le nom de la chaîne et en sélectionnant Copier le lien.

    4. Dans la Console de gestion AWS fenêtre Amazon Q Developer dans les applications de chat, collez l'ID de chaîne que vous avez copié depuis Slack dans le champ ID de chaîne privée.

    5. Dans Autorisations, choisissez de créer un rôle IAM à l'aide d'un modèle si vous n'avez pas encore de rôle.

    6. Pour les modèles de politique, choisissez Autorisations de notification. Il s'agit du modèle de politique IAM pour Amazon Q Developer dans les applications de chat. Cette politique fournit les autorisations de lecture et de liste nécessaires pour les CloudWatch alarmes, les événements et les journaux, ainsi que pour les rubriques Amazon SNS.

    7. Pour les politiques relatives aux garde-corps de la Manche, sélectionnez. AmazonInspector2ReadOnlyAccess

    8. Choisissez la région dans laquelle vous avez précédemment créé votre rubrique SNS, puis sélectionnez la rubrique Amazon SNS que vous avez créée pour envoyer des notifications à la chaîne Slack.

  5. Sélectionnez Configure (Configurer).

Amazon Chime setup
Création d'une rubrique SNS

  1. Connectez-vous à la console Amazon SNS à l'adresse https://console.aws.amazon.com/sns/v3/home.

  2. Sélectionnez Rubriques dans le volet de navigation, puis sélectionnez Créer une rubrique.

  3. Dans la section Créer un sujet, sélectionnez Standard. Entrez ensuite un nom de rubrique, tel queInspector_to_Chime. D'autres détails sont facultatifs. Choisissez Créer un sujet pour terminer.

Configuration d'un développeur Amazon Q dans un client d'applications de chat

  1. Accédez à la console Amazon Q Developer dans les applications de chat à l'adressehttps://console.aws.amazon.com/chatbot/.

  2. Dans le panneau Clients configurés, sélectionnez Configurer un nouveau client.

  3. Choisissez Chime, puis choisissez Configurer pour confirmer.

  4. Dans le volet Détails de configuration, saisissez le nom du canal.

  5. Dans Amazon Chime, ouvrez le salon de discussion souhaité.

    1. Choisissez l'icône d'engrenage dans le coin supérieur droit, puis sélectionnez Manage webhooks (Gérer les webhooks) .

    2. Sélectionnez Copier l'URL pour copier l'URL du webhook dans votre presse-papiers.

  6. Dans la Console de gestion AWS fenêtre Amazon Q Developer in chat applications, collez l'URL que vous avez copiée dans le champ URL du Webhook.

  7. Dans Autorisations, choisissez de créer un rôle IAM à l'aide d'un modèle si vous n'avez pas encore de rôle.

  8. Pour les modèles de politique, choisissez Autorisations de notification. Il s'agit du modèle de politique IAM pour Amazon Q Developer dans les applications de chat. Il fournit les autorisations de lecture et de liste nécessaires pour les CloudWatch alarmes, les événements et les journaux, ainsi que pour les rubriques Amazon SNS.

  9. Choisissez la région dans laquelle vous avez précédemment créé votre rubrique SNS, puis sélectionnez la rubrique Amazon SNS que vous avez créée pour envoyer des notifications à la salle Amazon Chime.

  10. Sélectionnez Configure (Configurer).

Étape 2. Création d'une EventBridge règle pour les résultats d'Amazon Inspector

  1. Connectez-vous à l'aide de vos informations d'identification.

  2. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  3. Sélectionnez Règles dans le volet de navigation, puis sélectionnez Créer une règle.

  4. Entrez un nom et une description facultative pour votre règle.

  5. Sélectionnez Règle avec un modèle d'événement, puis Suivant.

  6. Dans le volet Event Pattern, choisissez Custom patterns (éditeur JSON).

  7. Collez le code JSON suivant dans l’éditeur. 

    {
  "source": ["aws.inspector2"],
  "detail-type": ["Inspector2 Finding"],
  "detail": {
    "severity": ["HIGH", "CRITICAL"],
    "status": ["ACTIVE"]
  }
}
    Note

    Ce modèle envoie des notifications pour toute détection d'activité CRITICAL ou de HIGH gravité détectée par Amazon Inspector.

    Sélectionnez Suivant lorsque vous avez fini de saisir le modèle d'événement.

  8. Sur la page Sélectionner les cibles, choisissez Service AWS. Ensuite, pour Sélectionner le type de cible, choisissez la rubrique SNS.

  9. Dans Rubrique, sélectionnez le nom de la rubrique SNS que vous avez créée à l'étape 1. Ensuite, sélectionnez Suivant.

  10. Ajoutez des balises facultatives si nécessaire et choisissez Suivant.

  11. Vérifiez votre règle, puis choisissez Créer une règle.

EventBridge pour les environnements multi-comptes Amazon Inspector

Si vous êtes un administrateur délégué d'Amazon Inspector, EventBridge les règles apparaissent sur votre compte en fonction des résultats applicables de vos comptes membres. Si vous configurez les notifications de résultats via EventBridge votre compte administrateur, comme indiqué dans la section précédente, vous recevrez des notifications concernant plusieurs comptes. En d'autres termes, vous serez informé des résultats et des événements générés par vos comptes membres en plus de ceux générés par votre propre compte.

Vous pouvez utiliser les informations JSON accountId de la recherche pour identifier le compte membre à l'origine de la découverte Amazon Inspector.