Collecter les journaux AWS Security Hub
Version de l'analyseur : 8.0
Ce document explique comment ingérer des journaux AWS Security Hub dans Google Security Operations. AWS Security Hub fournit une vue complète des alertes de sécurité et des résultats dans les comptes AWS. En envoyant ces résultats à Google SecOps, vous pouvez utiliser les fonctionnalités de Google SecOps pour améliorer la surveillance et la détection des menaces.
Avant de commencer
Assurez-vous de remplir les conditions préalables suivantes :
- Instance Google SecOps
- Accès privilégié à AWS
Configurer AWS IAM et S3
- Créez un bucket Amazon S3 en suivant ce guide de l'utilisateur : Créer un bucket.
- Enregistrez le nom et la région du bucket pour une utilisation ultérieure.
- Créez un utilisateur en suivant ce guide de l'utilisateur : Créer un utilisateur IAM.
- Sélectionnez l'utilisateur créé.
- Sélectionnez l'onglet Identifiants de sécurité.
- Cliquez sur Create Access Key (Créer une clé d'accès) dans la section Access Keys (Clés d'accès).
- Sélectionnez Service tiers comme Cas d'utilisation.
- Cliquez sur Suivant.
- Facultatif : ajoutez une balise de description.
- Cliquez sur Créer une clé d'accès.
- Cliquez sur Télécharger le fichier CSV pour enregistrer la clé d'accès et la clé d'accès secrète pour une utilisation ultérieure.
- Cliquez sur OK.
- Sélectionnez l'onglet Autorisations.
- Cliquez sur Ajouter des autorisations dans la section Stratégies d'autorisation.
- Sélectionnez Ajouter des autorisations.
- Sélectionnez Associer directement des stratégies.
- Recherchez et sélectionnez la règle AmazonS3FullAccess.
- Cliquez sur Suivant.
- Cliquez sur Ajouter des autorisations.
Créer une fonction Lambda
- Connectez-vous à l'AWS Management Console.
- Accédez à Lambda.
- Cliquez sur Create Function (Créer une fonction), puis sélectionnez Author from Scratch (Créer à partir de zéro).
- Attribuez un nom à votre fonction, par exemple
SecurityHubToS3. - Choisissez Python 3.x comme environnement d'exécution.
Saisissez le code Lambda qui récupère les résultats d'EventBridge et les écrit dans votre bucket S3 :
import json import boto3 from datetime import datetime # Initialize the S3 client s3_client = boto3.client('s3') # S3 bucket where findings will be stored bucket_name = 'aws-security-hub-findings-stream' def lambda_handler(event, context): # Extract Security Hub findings from the event findings = event['detail']['findings'] # Generate a timestamp for the file name to avoid overwriting timestamp = datetime.now().strftime('%Y-%m-%dT%H-%M-%S') # Generate the S3 object key (file name) based on the timestamp object_key = f"security_hub_findings_{timestamp}.json" # Convert findings to JSON format findings_json = json.dumps(findings) # Upload the findings to S3 try: response = s3_client.put_object( Bucket=bucket_name, Key=object_key, Body=findings_json, ContentType='application/json' ) print(f"Successfully uploaded findings to S3: {response}") except Exception as e: print(f"Error uploading findings to S3: {e}") raise e return { 'statusCode': 200, 'body': json.dumps('Successfully processed findings') }Définissez les autorisations pour Lambda en ajoutant un rôle IAM à la fonction Lambda avec la stratégie suivante :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-security-hub-findings-stream/*" } ] }
Configurer AWS Security Hub pour transférer les résultats avec EventBridge
- Connectez-vous à l'AWS Management Console.
- Dans la barre de recherche, saisissez Security Hub, puis sélectionnez-le dans la liste des services.
- Cliquez sur Paramètres.
- Dans la section Integrations (Intégrations), recherchez EventBridge, puis cliquez sur Enable (Activer).
- Dans la barre de recherche, saisissez EventBridge, puis sélectionnez-le dans la liste des services.
- Dans la console EventBridge, cliquez sur Rules > Create rule (Règles > Créer une règle).
- Fournissez la configuration de règle suivante :
- Nom de la règle : indiquez un nom descriptif pour la règle, par exemple SendSecurityHubFindingsToS3.
- Source de l'événement : sélectionnez Services AWS.
- Nom du service : sélectionnez Centre de sécurité.
- Type d'événement : sélectionnez Résultats du centre de sécurité.
- Définissez la cible : sélectionnez Fonction Lambda.
- Sélectionnez la fonction Lambda que vous venez de créer (
SecurityHubToS3).
- Cliquez sur Créer.
Configurer des flux
Il existe deux points d'entrée différents pour configurer des flux dans la plate-forme Google SecOps :
- Paramètres > Gestion des données > Flux > Ajouter un flux (sur la plate-forme SIEM uniquement, Paramètres > Flux > Ajouter un flux)
- Content Hub > Packs de contenu > Premiers pas
Configurer le flux AWS Security Hub
- Cliquez sur le pack Amazon Cloud Platform.
- Recherchez le type de journal AWS Security Hub.
Spécifiez les valeurs des champs suivants.
- Type de source : Amazon SQS V2
- Nom de la file d'attente : nom de la file d'attente SQS à partir de laquelle lire les données
- URI S3 : URI du bucket.
s3://your-log-bucket-name/- Remplacez
your-log-bucket-namepar le nom réel de votre bucket S3.
- Remplacez
Options de suppression de la source : sélectionnez l'option de suppression en fonction de vos préférences d'ingestion.
Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours. La valeur par défaut est de 180 jours.
ID de clé d'accès à la file d'attente SQS : clé d'accès au compte, qui est une chaîne alphanumérique de 20 caractères.
Clé d'accès secrète de la file d'attente SQS : clé d'accès au compte, qui est une chaîne alphanumérique de 40 caractères.
Options avancées
- Nom du flux : valeur préremplie qui identifie le flux.
- Espace de noms de l'élément : espace de noms associé au flux.
- Libellés d'ingestion : libellés appliqués à tous les événements de ce flux.
Cliquez sur Créer un flux.
Pour en savoir plus sur la configuration de plusieurs flux pour différents types de journaux dans cette famille de produits, consultez Configurer des flux par produit.
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
account |
principal.group.product_object_id |
ID de compte AWS associé au résultat. |
configurationItem.ARN |
target.resource.id |
Nom de ressource Amazon (ARN) de l'élément de configuration. |
configurationItem.awsAccountId |
principal.user.userid |
ID de compte AWS de l'élément de configuration. |
configurationItem.awsRegion |
target.asset.location.country_or_region |
Région AWS de l'élément de configuration. |
configurationItem.configuration.complianceType |
security_result.summary |
Type de conformité de l'élément de configuration. |
configurationItem.configuration.configRuleList[].complianceType |
security_result.summary |
État de conformité pour chaque règle de configuration. |
configurationItem.configuration.configRuleList[].configRuleArn |
security_result.rule_id |
ARN de la règle AWS Config. |
configurationItem.configuration.configRuleList[].configRuleId |
security_result.about.labels.configRuleId |
ID de la règle AWS Config. |
configurationItem.configuration.configRuleList[].configRuleName |
security_result.rule_name |
Nom de la règle AWS Config. |
configurationItem.configuration.privateIpAddress |
target.ip |
Adresse IP privée de l'élément de configuration. |
configurationItem.configuration.publicIpAddress |
target.ip |
Adresse IP publique de l'élément de configuration. |
configurationItem.configurationItemCaptureTime |
target.asset.attribute.creation_time |
Heure de capture de l'élément de configuration, convertie en code temporel. |
configurationItem.configurationItemStatus |
target.asset.attribute.labels.Configuration Item Status |
État de l'élément de configuration. |
configurationItem.relationships[].resourceId |
target.asset.attribute.cloud.vpc.id |
ID de la ressource associée, utilisé pour l'ID de VPC s'il correspond à vpc. |
configurationItem.resourceId |
target.resource.id |
ID de ressource de l'élément de configuration. |
configurationItem.resourceName |
target.resource.name |
Nom de la ressource. |
configurationItem.resourceType |
target.resource.resource_subtype |
Type de ressource de l'élément de configuration. |
configurationItem.tags.Contact |
principal.user.user_display_name OU principal.user.email_addresses |
Coordonnées extraites des tags, analysées pour l'adresse e-mail et le nom d'utilisateur. |
configurationItem.tags.OS/configurationItem.tags.Os |
target.asset.platform_software.platform |
Système d'exploitation issu des tags, mappé sur la plate-forme s'il s'agit de Windows ou Linux. |
configurationItemDiff.changeType |
metadata.event_type |
Type de modification, mappé à RESOURCE_WRITTEN ou RESOURCE_CREATION. |
detail.accountId |
principal.group.product_object_id |
ID de compte AWS associé au résultat. |
detail.actionDescription detail.actionName detail.description |
sec_result.description |
Description du résultat. |
detail.findings[].AwsAccountId |
principal.group.product_object_id |
ID de compte AWS associé au résultat. |
detail.findings[].CompanyName detail.findings[].CreatedAt detail.findings[].Description |
sec_result.description |
Description du résultat. |
detail.findings[].FindingProviderFields.Severity.Label |
sec_result.severity |
Libellé de gravité du résultat, converti en majuscules. |
detail.findings[].FindingProviderFields.Types[] detail.findings[].FirstObservedAt detail.findings[].GeneratorId detail.findings[].Id detail.findings[].LastObservedAt detail.findings[].ProductArn detail.findings[].ProductFields. |
Voir ci-dessous | Divers champs utilisés pour les champs supplémentaires, le compte principal et les informations cibles. |
detail.findings[].ProductName detail.findings[].RecordState detail.findings[].Region |
target.location.name |
Région AWS du résultat. |
detail.findings[].Resources[].Details. |
Voir ci-dessous | Détails sur les ressources impliquées dans le résultat. |
detail.findings[].Resources[].Id |
target.resource.product_object_id |
ID de la ressource. |
detail.findings[].Resources[].Partition detail.findings[].Resources[].Region |
target.location.name |
Région AWS de la ressource. |
detail.findings[].Resources[].Tags detail.findings[].Resources[].Type |
target.resource.resource_type, target.resource.resource_subtype, metadata.event_type |
Type de ressource, utilisé pour le mappage du type de ressource, du sous-type et du type d'événement. |
detail.findings[].Sample detail.findings[].SchemaVersion detail.findings[].Severity.Label detail.findings[].SourceUrl detail.findings[].Title |
sec_result.summary |
Titre du résultat. |
detail.findings[].Types[] detail.findings[].UpdatedAt detail.findings[].Workflow.Status detail.findings[].WorkflowState detail-type |
metadata.product_event_type |
Type de détail de l'événement. |
id |
metadata.product_log_id |
ID de l'événement. |
region |
target.location.name |
Région AWS de l'événement. |
resources[] source time version (logique de l'analyseur) |
metadata.event_timestamp |
Heure de création de l'entrée de journal d'origine, utilisée comme code temporel de l'événement. |
| (Logique de l'analyseur) | metadata.log_type |
Variable définie sur AWS_SECURITY_HUB. |
| (Logique de l'analyseur) | metadata.product_name |
Variable définie sur AWS Security Hub. |
| (Logique de l'analyseur) | metadata.vendor_name |
Variable définie sur AMAZON. |
| (Logique de l'analyseur) | target.asset.attribute.cloud.environment |
Variable définie sur AMAZON_WEB_SERVICES. |
| (Logique de l'analyseur) | metadata.event_type |
Définissez la valeur par défaut sur USER_RESOURCE_ACCESS si elle n'est pas mappée à partir de Resources[].Type ou configurationItemDiff.changeType. Défini sur STATUS_UPDATE si configurationItems est présent et qu'aucun autre type d'événement n'est défini. Définie sur RESOURCE_READ si configurationItem ou configurationItems est présent et que l'état est OK ou ResourceDiscovered. Définie sur RESOURCE_DELETION si configurationItem ou configurationItems est présent et que l'état est ResourceDeleted. |
| (Logique de l'analyseur) | metadata.description |
Définie sur guardduty si detail.findings[].ProductFields.aws/guardduty/service/serviceName est présent. |
| (Logique de l'analyseur) | target.asset.attribute.cloud.vpc.resource_type |
Définie sur VPC_NETWORK, si configurationItems.relationships[].resourceId correspond à vpc. |
| (Logique de l'analyseur) | target.resource.resource_type |
Définissez cette valeur sur VIRTUAL_MACHINE si configurationItem ou configurationItems est présent. Définissez cette option sur UNSPECIFIED si aucun autre type de ressource n'est défini. |
| (Logique de l'analyseur) | target.asset.platform_software.platform |
Définissez cette valeur sur WINDOWS ou LINUX selon la présence de Windows ou (Linux|LINUX) dans le message pour configurationItem. Pour configurationItems, il est défini en fonction de configItem.tags.OS ou configItem.tags.Os. |
| (Logique de l'analyseur) | disambiguation_key |
Ajouté lorsque plusieurs événements sont générés à partir d'une seule entrée de journal. |
Journal des modifications
Afficher le journal des modifications de cet analyseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.