Exemples Security Hub avec les Outils pour PowerShell V5

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant les Outils AWS pour PowerShell V5 avec Security Hub.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Actions

Get-SHUBFinding

L’exemple de code suivant montre comment utiliser Get-SHUBFinding.

Outils pour PowerShell V5

Exemple 1 : cette commande extrait les résultats du Security Hub auprès du service Amazon EC2.

$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.ResourceType = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
    Comparison = 'PREFIX'
    Value = 'AwsEc2'
}
Get-SHUBFinding -Filter $filter

Exemple 2 : cette commande extrait les résultats du Security Hub à partir de l’ID de compte AWS 123456789012.

$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.AwsAccountId = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
    Comparison = 'EQUALS'
    Value = '123456789012'
}
Get-SHUBFinding -Filter $filter

Exemple 3 : cette commande extrait les résultats du Security Hub générés pour le standard « pci-dss ».

$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.GeneratorId = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
    Comparison = 'PREFIX'
    Value = 'pci-dss'
}
Get-SHUBFinding -Filter $filter

Exemple 4 : cette commande extrait les résultats de gravité critique de Security Hub dont le statut de flux de travail est NOTIFIÉ.

$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.SeverityLabel = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
    Comparison = 'EQUALS'
    Value = 'CRITICAL'
}
$filter.WorkflowStatus = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
    Comparison = 'EQUALS'
    Value = 'NOTIFIED'
}
Get-SHUBFinding -Filter $filter

• Pour plus de détails sur l’API, consultez GetFindings dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).