Abonnement aux annonces d'Amazon SNS GuardDuty

Cette section fournit des informations sur l'abonnement à Amazon SNS (Simple Notification Service) pour les GuardDuty annonces visant à recevoir des notifications concernant les nouveaux types de résultats, les mises à jour des types de résultats existants et d'autres modifications de fonctionnalités. Les notifications sont disponibles dans tous les formats pris en SNS charge par Amazon.

GuardDuty SNSEnvoie une annonce concernant les mises à jour du GuardDuty service AWS à n'importe quel compte abonné. Pour recevoir des notifications concernant les résultats enregistrés dans votre compte, veuillez consulter Création de réponses personnalisées aux GuardDuty résultats avec Amazon CloudWatch Events.

Note

Votre IAM utilisateur doit être sns::subscribe autorisé à s'abonner à unSNS.

Vous pouvez inscrire une SQS file d'attente Amazon à ce sujet de notification, mais vous devez utiliser un sujet ARN qui se trouve dans la même région. Pour plus d'informations, consultez Tutoriel : Abonnement d'une SQS file d'attente Amazon à une SNS rubrique Amazon dans le guide du développeur Amazon Simple Queue Service.

Vous pouvez également utiliser une AWS Lambda fonction pour déclencher des événements lorsque des notifications sont reçues. Pour plus d'informations, consultez Invoking Lambda functions using SNS Amazon Notifications dans le guide du développeur Amazon Simple Queue Service.

La SNS rubrique Amazon ARNs pour chaque région est présentée ci-dessous.

AWS Région	SNSRubrique Amazon ARN
`us-east-1`	`arn:aws:sns:us-east-1:242987662583:GuardDutyAnnouncements`
`us-east-2`	`arn:aws:sns:us-east-2:118283430703:GuardDutyAnnouncements`
`us-west-1`	`arn:aws:sns:us-west-1:144182107116:GuardDutyAnnouncements`
`us-west-2`	`arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements`
`ca-central-1`	`arn:aws:sns:ca-central-1:107430051933:GuardDutyAnnouncements`
`ca-west-1`	`arn:aws:sns:ca-west-1:440427180217:GuardDutyAnnouncements`
`eu-north-1`	`arn:aws:sns:eu-north-1:973841112453:GuardDutyAnnouncements`
`eu-west-1`	`arn:aws:sns:eu-west-1:965013871422:GuardDutyAnnouncements`
`eu-west-2`	`arn:aws:sns:eu-west-2:506403581195:GuardDutyAnnouncements`
`eu-west-3`	`arn:aws:sns:eu-west-3:436163563069:GuardDutyAnnouncements`
`eu-central-1`	`arn:aws:sns:eu-central-1:378365507264:GuardDutyAnnouncements`
`eu-central-2`	`arn:aws:sns:eu-central-2:383009515534:GuardDutyAnnouncements`
`ap-east-1`	`arn:aws:sns:ap-east-1:646602203151:GuardDutyAnnouncements`
`ap-northeast-1`	`arn:aws:sns:ap-northeast-1:741172661024:GuardDutyAnnouncements`
`ap-northeast-2`	`arn:aws:sns:ap-northeast-2:464168911255:GuardDutyAnnouncements`
`ap-southeast-1`	`arn:aws:sns:ap-southeast-1:476419727788:GuardDutyAnnouncements`
`ap-southeast-2`	`arn:aws:sns:ap-southeast-2:457615622431:GuardDutyAnnouncements`
`ap-south-1`	`arn:aws:sns:ap-south-1:926826061926:GuardDutyAnnouncements`
`sa-east-1`	`arn:aws:sns:sa-east-1:955633302743:GuardDutyAnnouncements`
`us-gov-west-1`	`arn:aws-us-gov:sns:us-gov-west-1:430639793359:GuardDutyAnnouncements`
`cn-north-1`	`arn:aws-cn:sns:cn-north-1:002991280229:GuardDutyAnnouncements`
`cn-northwest-1`	`arn:aws-cn:sns:cn-northwest-1:003033775354:GuardDutyAnnouncements`
`me-south-1`	`arn:aws:sns:me-south-1:552740612889:GuardDutyAnnouncements`
`me-central-1`	`arn:aws:sns:me-central-1:030935290150:GuardDutyAnnouncements`
`eu-south-1`	`arn:aws:sns:eu-south-1:188461706213:GuardDutyAnnouncements`
`eu-south-2`	`arn:aws:sns:eu-south-2:445632894446:GuardDutyAnnouncements`
`us-gov-east-1`	`arn:aws:sns:us-gov-east-1:143972945659:GuardDutyAnnouncements`
`ap-northeast-3`	`arn:aws:sns:ap-northeast-3:129086577509:GuardDutyAnnouncements`
`ap-southeast-3`	`arn:aws:sns:ap-southeast-3:225965583551:GuardDutyAnnouncements`
`ap-south-2`	`arn:aws:sns:ap-south-2:595653072700:GuardDutyAnnouncements`
`ap-southeast-4`	`arn:aws:sns:ap-southeast-4:529900636122:GuardDutyAnnouncements`
`il-central-1`	`arn:aws:sns:il-central-1:847886274986:GuardDutyAnnouncements`

Pour vous abonner à l'e-mail de notification de GuardDuty mise à jour dans le AWS Management Console

Ouvrez la SNS console Amazon sur https://console.aws.amazon.com/sns/v3/home.
Dans la liste des régions, choisissez la même région que le sujet ARN auquel vous souhaitez vous abonner. L'exemple utilise la région us-west-2.
Dans le panneau de navigation de gauche, choisissez Abonnements, puis Créer un abonnement.
Dans la boîte de dialogue Créer un abonnement, pour Sujet ARN, collez le sujet ARN :arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements.
Pour Protocole, choisissez E-mail. Pour Point de terminaison, tapez une adresse e-mail que vous pouvez utiliser pour recevoir la notification.
Choisissez Create subscription (Créer un abonnement).
Dans votre application de messagerie, ouvrez le message provenant AWS des notifications et ouvrez le lien pour confirmer votre abonnement.

Votre navigateur Web affiche une réponse de confirmation d'AmazonSNS.

Pour vous abonner à l'e-mail de notification de GuardDuty mise à jour avec AWS CLI

Exécutez la commande suivante avec l' AWS CLI :


 aws  sns --region us-west-2 subscribe --topic-arn arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements --protocol email --notification-endpoint your_email@your_domain.com

Dans votre application de messagerie, ouvrez le message provenant AWS des notifications et ouvrez le lien pour confirmer votre abonnement.

Votre navigateur Web affiche une réponse de confirmation d'AmazonSNS.

Format de SNS message Amazon

Exemple de message de notification GuardDuty général :


{
    "Type" : "Notification",
    "MessageId" : "9101dc6b-726f-4df0-8646-ec2f94e674bc",
    "TopicArn" : "arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements",
    "Message" : "{\"version\":\"1\",\"type\":\"GENERAL\",\"message\":[{\"title\":\"Updated AmazonGuardDutyFullAccess policy\",\"body\":\"Added permission that allows you to pass an IAM role to GuardDuty when you enable Malware Protection for S3.\",\"links\":[\"https://docs.aws.amazon.com//guardduty/latest/ug/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonGuardDutyFullAccess\"]}]}",
    "Timestamp" : "2018-03-09T00:25:43.483Z",
    "SignatureVersion" : "1",
    "Signature" : "XWox8GDGLRiCgDOXlo/fG9Lu/88P8S0FL6M6oQYOmUFzkucuhoblsdea3BjqdCHcWR7qdhMPQnLpN7y9iBrWVUqdAGJrukAI8athvAS+4AQD/V/QjrhsEnlj+GaiW+ozAu006X6GopOzFGnCtPMROjCMrMonjz7Hpv/8KRuMZR3pyQYm5d4wWB7xBPYhUMuLoZ1V8YFs55FMtgQV/YLhSYuEu0BP1GMtLQauxDkscOtPP/vjhGQLFx1Q9LTadcQiRHtNIBxWL87PSI+BVvkin6AL7PhksvdQ7FAgHfXsit+6p8GyOvKCqaeBG7HZhR1AbpyVka7JSNRO/6ssyrlj1g==",
    "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-433026a4050d206028891664da859041.pem",
    "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements:9225ed2b-7228-4665-8a01-c8a5db6859f4"
}

La valeur Message analysée (après suppression des guillemets simples placés en séquence d'échappement) est présentée ci-dessous :


{
        "version": "1",
        "type": "GENERAL",
        "message": [
            {
                "title": "Updated AmazonGuardDutyFullAccess policy",
                "body": "Added permission that allows you to pass an IAM role to GuardDuty when you enable Malware Protection for S3.",
                "links": [
                    "https://docs.aws.amazon.com//guardduty/latest/ug/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonGuardDutyFullAccess"
                ]
             }
        ]
}

Un exemple de message de notification de GuardDuty mise à jour concernant de nouvelles découvertes est présenté ci-dessous :


{
    "Type" : "Notification",
    "MessageId" : "9101dc6b-726f-4df0-8646-ec2f94e674bc",
    "TopicArn" : "arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements",
    "Message" : "{\"version\":\"1\",\"type\":\"NEW_FINDINGS\",\"findingDetails\":[{\"link\":\"https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_unauthorized.html\",\"findingType\":\"UnauthorizedAccess:EC2/TorClient\",\"findingDescription\":\"This finding informs you that an EC2 instance in your AWS environment is making connections to a Tor Guard or an Authority node. Tor is software for enabling anonymous communication. Tor Guards and Authority nodes act as initial gateways into a Tor network. This traffic can indicate that this EC2 instance is acting as a client on a Tor network. A common use for a Tor client is to circumvent network monitoring and filter for access to unauthorized or illicit content. Tor clients can also generate nefarious Internet traffic, including attacking SSH servers. This activity can indicate that your EC2 instance is compromised.\"}]}",
    "Timestamp" : "2018-03-09T00:25:43.483Z",
    "SignatureVersion" : "1",
    "Signature" : "XWox8GDGLRiCgDOXlo/fG9Lu/88P8S0FL6M6oQYOmUFzkucuhoblsdea3BjqdCHcWR7qdhMPQnLpN7y9iBrWVUqdAGJrukAI8athvAS+4AQD/V/QjrhsEnlj+GaiW+ozAu006X6GopOzFGnCtPMROjCMrMonjz7Hpv/8KRuMZR3pyQYm5d4wWB7xBPYhUMuLoZ1V8YFs55FMtgQV/YLhSYuEu0BP1GMtLQauxDkscOtPP/vjhGQLFx1Q9LTadcQiRHtNIBxWL87PSI+BVvkin6AL7PhksvdQ7FAgHfXsit+6p8GyOvKCqaeBG7HZhR1AbpyVka7JSNRO/6ssyrlj1g==",
    "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-433026a4050d206028891664da859041.pem",
    "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements:9225ed2b-7228-4665-8a01-c8a5db6859f4"
}

La valeur Message analysée (après suppression des guillemets simples placés en séquence d'échappement) est présentée ci-dessous :


{
    "version": "1",
    "type": "NEW_FINDINGS",
    "findingDetails": [{
        "link": "https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_unauthorized.html",
        "findingType": "UnauthorizedAccess:EC2/TorClient",
        "findingDescription": "This finding informs you that an EC2 instance in your AWS environment is making connections to a Tor Guard or an Authority node. Tor is software for enabling anonymous communication. Tor Guards and Authority nodes act as initial gateways into a Tor network. This traffic can indicate that this EC2 instance is acting as a client on a Tor network. A common use for a Tor client is to circumvent network monitoring and filter for access to unauthorized or illicit content. Tor clients can also generate nefarious Internet traffic, including attacking SSH servers. This activity can indicate that your EC2 instance is compromised."
    }]
}

Un exemple de message de notification de GuardDuty mise à jour concernant GuardDuty les mises à jour des fonctionnalités est illustré ci-dessous :


{
    "Type" : "Notification",
    "MessageId" : "9101dc6b-726f-4df0-8646-ec2f94e674bc",
    "TopicArn" : "arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements",
    "Message" : "{\"version\":\"1\",\"type\":\"NEW_FEATURES\",\"featureDetails\":[{\"featureDescription\":\"Customers with high-volumes of global CloudTrail events should see a net positive impact on their GuardDuty costs.\",\"featureLink\":\"https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_data-sources.html#guardduty_controlplane\"}]}",
    "Timestamp" : "2018-03-09T00:25:43.483Z",
    "SignatureVersion" : "1",
    "Signature" : "XWox8GDGLRiCgDOXlo/fG9Lu/88P8S0FL6M6oQYOmUFzkucuhoblsdea3BjqdCHcWR7qdhMPQnLpN7y9iBrWVUqdAGJrukAI8athvAS+4AQD/V/QjrhsEnlj+GaiW+ozAu006X6GopOzFGnCtPMROjCMrMonjz7Hpv/8KRuMZR3pyQYm5d4wWB7xBPYhUMuLoZ1V8YFs55FMtgQV/YLhSYuEu0BP1GMtLQauxDkscOtPP/vjhGQLFx1Q9LTadcQiRHtNIBxWL87PSI+BVvkin6AL7PhksvdQ7FAgHfXsit+6p8GyOvKCqaeBG7HZhR1AbpyVka7JSNRO/6ssyrlj1g==",
    "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-433026a4050d206028891664da859041.pem",
    "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements:9225ed2b-7228-4665-8a01-c8a5db6859f4"
}

La valeur Message analysée (après suppression des guillemets simples placés en séquence d'échappement) est présentée ci-dessous :


{
    "version": "1",
    "type": "NEW_FEATURES",
    "featureDetails": [{
        "featureDescription": "Customers with high-volumes of global CloudTrail events should see a net positive impact on their GuardDuty costs.",
        "featureLink": "https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_data-sources.html#guardduty_controlplane"
    }]
}

Un exemple de message de notification de GuardDuty mise à jour concernant les résultats mis à jour est illustré ci-dessous :


{
    "Type": "Notification",
    "MessageId": "9101dc6b-726f-4df0-8646-ec2f94e674bc",
    "TopicArn": "arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements",
    "Message": "{\"version\":\"1\",\"type\":\"UPDATED_FINDINGS\",\"findingDetails\":[{\"link\":\"https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_unauthorized.html\",\"findingType\":\"UnauthorizedAccess:EC2/TorClient\",\"description\":\"Increased severity value from 5 to 8.\"}]}",
    "Timestamp": "2018-03-09T00:25:43.483Z",
    "SignatureVersion": "1",
    "Signature": "XWox8GDGLRiCgDOXlo/fG9Lu/88P8S0FL6M6oQYOmUFzkucuhoblsdea3BjqdCHcWR7qdhMPQnLpN7y9iBrWVUqdAGJrukAI8athvAS+4AQD/V/QjrhsEnlj+GaiW+ozAu006X6GopOzFGnCtPMROjCMrMonjz7Hpv/8KRuMZR3pyQYm5d4wWB7xBPYhUMuLoZ1V8YFs55FMtgQV/YLhSYuEu0BP1GMtLQauxDkscOtPP/vjhGQLFx1Q9LTadcQiRHtNIBxWL87PSI+BVvkin6AL7PhksvdQ7FAgHfXsit+6p8GyOvKCqaeBG7HZhR1AbpyVka7JSNRO/6ssyrlj1g==",
    "SigningCertURL": "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-433026a4050d206028891664da859041.pem",
    "UnsubscribeURL": "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:934957504740:GuardDutyAnnouncements:9225ed2b-7228-4665-8a01-c8a5db6859f4"
}

La valeur Message analysée (après suppression des guillemets simples placés en séquence d'échappement) est présentée ci-dessous :


{
    "version": "1",
    "type": "UPDATED_FINDINGS",
    "findingDetails": [{
        "link": "https://docs.aws.amazon.com//guardduty/latest/ug/guardduty_unauthorized.html",
        "findingType": "UnauthorizedAccess:EC2/TorClient",
        "description": "Increased severity value from 5 to 8."
    }]
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Suspension ou désactivation

GuardDuty quotas