AWS Sicherheits-Hub-Protokolle erfassen
Parserversion: 8.0
In diesem Dokument wird beschrieben, wie Sie AWS Security Hub-Logs in Google Security Operations aufnehmen. AWS Security Hub bietet eine umfassende Übersicht über Sicherheitswarnungen und -ergebnisse in AWS-Konten. Wenn Sie diese Ergebnisse an Google SecOps senden, können Sie die Funktionen von Google SecOps nutzen, um das Monitoring und die Bedrohungserkennung zu verbessern.
Hinweis
Folgende Voraussetzungen müssen erfüllt sein:
- Google SecOps-Instanz
- Privilegierter Zugriff auf AWS
AWS IAM und S3 konfigurieren
- Erstellen Sie einen Amazon S3-Bucket gemäß diesem Nutzerhandbuch: Bucket erstellen.
- Speichern Sie den Namen und die Region des Buckets für die spätere Verwendung.
- Erstellen Sie einen Nutzer gemäß diesem Nutzerhandbuch: IAM-Nutzer erstellen.
- Wählen Sie den erstellten Nutzer aus.
- Wählen Sie den Tab Sicherheitsanmeldedaten aus.
- Klicken Sie im Bereich Access Keys (Zugriffsschlüssel) auf Create Access Key (Zugriffsschlüssel erstellen).
- Wählen Sie als Anwendungsfall die Option Drittanbieterdienst aus.
- Klicken Sie auf Weiter.
- Optional: Fügen Sie ein Beschreibungs-Tag hinzu.
- Klicken Sie auf Zugriffsschlüssel erstellen.
- Klicken Sie auf CSV-Datei herunterladen, um den Zugriffsschlüssel und den geheimen Zugriffsschlüssel für die spätere Verwendung zu speichern.
- Klicken Sie auf Fertig.
- Wählen Sie den Tab Berechtigungen aus.
- Klicken Sie im Bereich Berechtigungsrichtlinien auf Berechtigungen hinzufügen.
- Wählen Sie Berechtigungen hinzufügen aus.
- Wählen Sie Richtlinien direkt anhängen aus.
- Suchen Sie nach der Richtlinie AmazonS3FullAccess und wählen Sie sie aus.
- Klicken Sie auf Weiter.
- Klicken Sie auf Berechtigungen hinzufügen.
Lambda-Funktion erstellen
- Melden Sie sich bei der AWS Management Console an.
- Rufen Sie Lambda auf.
- Klicken Sie auf Funktion erstellen und wählen Sie Ohne Vorlage erstellen aus.
- Geben Sie einen Namen für die Funktion ein, z. B.
SecurityHubToS3. - Wählen Sie Python 3.x als Laufzeit aus.
Geben Sie den Lambda-Code ein, der die Ergebnisse aus EventBridge übernimmt und in Ihren S3-Bucket schreibt:
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') }Legen Sie Berechtigungen für Lambda fest, indem Sie der Lambda-Funktion eine IAM-Rolle mit der folgenden Richtlinie hinzufügen:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-security-hub-findings-stream/*" } ] }
AWS Security Hub so konfigurieren, dass Ergebnisse mit EventBridge weitergeleitet werden
- Melden Sie sich bei der AWS Management Console an.
- Geben Sie in der Suchleiste Sicherheits-Hub ein und wählen Sie es aus der Liste der Dienste aus.
- Klicken Sie auf Einstellungen.
- Suchen Sie im Bereich Integrationen nach EventBridge und klicken Sie auf Aktivieren.
- Geben Sie in der Suchleiste EventBridge ein und wählen Sie es aus der Liste der Dienste aus.
- Klicken Sie in der EventBridge-Konsole auf Rules > Create rule.
- Geben Sie die folgende Regelkonfiguration an:
- Regelname: Geben Sie einen aussagekräftigen Namen für die Regel an, z. B. SendSecurityHubFindingsToS3.
- Ereignisquelle: Wählen Sie AWS-Dienste aus.
- Dienstname: Wählen Sie Sicherheits-Hub aus.
- Ereignistyp: Wählen Sie Sicherheits-Hub-Ergebnisse aus.
- Ziel festlegen: Wählen Sie Lambda-Funktion aus.
- Wählen Sie die soeben erstellte Lambda-Funktion (
SecurityHubToS3) aus.
- Klicken Sie auf Erstellen.
Feeds einrichten
Es gibt zwei verschiedene Einstiegspunkte, um Feeds in der Google SecOps-Plattform einzurichten:
- Einstellungen > Datenverwaltung > Feeds > Neuen Feed hinzufügen (auf einer reinen SIEM-Plattform: Einstellungen > Feeds > Neuen Feed hinzufügen)
- Content Hub > Content-Pakete > Jetzt starten
AWS Security Hub-Feed einrichten
- Klicken Sie auf das Paket Amazon Cloud Platform.
- Suchen Sie den Logtyp AWS Security Hub.
Geben Sie die Werte in den folgenden Feldern an.
- Quelltyp: Amazon SQS V2
- Warteschlangenname: Der Name der SQS-Warteschlange, aus der gelesen werden soll.
- S3-URI: Der Bucket-URI.
s3://your-log-bucket-name/- Ersetzen Sie
your-log-bucket-namedurch den tatsächlichen Namen Ihres S3-Buckets.
- Ersetzen Sie
Optionen zum Löschen der Quelle: Wählen Sie die Löschoption entsprechend Ihren Einstellungen für die Aufnahme aus.
Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden. Der Standardwert ist 180 Tage.
SQS Queue Access Key ID: Ein Konto-Zugriffsschlüssel, der ein alphanumerischer String mit 20 Zeichen ist.
Geheimer Zugriffsschlüssel für SQS-Warteschlange: Ein Konto-Zugriffsschlüssel, der ein alphanumerischer String mit 40 Zeichen ist.
Erweiterte Optionen
- Feedname: Ein vorausgefüllter Wert, der den Feed identifiziert.
- Asset-Namespace: Der mit dem Feed verknüpfte Namespace.
- Aufnahme-Labels: Labels, die auf alle Ereignisse aus diesem Feed angewendet werden.
Klicken Sie auf Feed erstellen.
Weitere Informationen zum Konfigurieren mehrerer Feeds für verschiedene Logtypen innerhalb dieser Produktfamilie finden Sie unter Feeds nach Produkt konfigurieren.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
account |
principal.group.product_object_id |
Die AWS-Konto-ID, die mit dem Ergebnis verknüpft ist. |
configurationItem.ARN |
target.resource.id |
Der Amazon Resource Name (ARN) des Konfigurationselements. |
configurationItem.awsAccountId |
principal.user.userid |
Die AWS-Konto-ID des Konfigurationselements. |
configurationItem.awsRegion |
target.asset.location.country_or_region |
Die AWS-Region des Konfigurationselements. |
configurationItem.configuration.complianceType |
security_result.summary |
Der Compliancetyp des Konfigurationselements. |
configurationItem.configuration.configRuleList[].complianceType |
security_result.summary |
Compliancestatus für jede Konfigurationsregel. |
configurationItem.configuration.configRuleList[].configRuleArn |
security_result.rule_id |
Der ARN der AWS Config-Regel. |
configurationItem.configuration.configRuleList[].configRuleId |
security_result.about.labels.configRuleId |
Die ID der AWS Config-Regel. |
configurationItem.configuration.configRuleList[].configRuleName |
security_result.rule_name |
Der Name der AWS Config-Regel. |
configurationItem.configuration.privateIpAddress |
target.ip |
Die private IP-Adresse des Konfigurationselements. |
configurationItem.configuration.publicIpAddress |
target.ip |
Die öffentliche IP-Adresse des Konfigurationselements. |
configurationItem.configurationItemCaptureTime |
target.asset.attribute.creation_time |
Der Erfassungszeitpunkt des Konfigurationselements, konvertiert in einen Zeitstempel. |
configurationItem.configurationItemStatus |
target.asset.attribute.labels.Configuration Item Status |
Der Status des Konfigurationselements. |
configurationItem.relationships[].resourceId |
target.asset.attribute.cloud.vpc.id |
Die Ressourcen-ID der zugehörigen Ressource, die für die VPC-ID verwendet wird, wenn sie mit vpc übereinstimmt. |
configurationItem.resourceId |
target.resource.id |
Die Ressourcen-ID des Konfigurationselements. |
configurationItem.resourceName |
target.resource.name |
Name der Ressource. |
configurationItem.resourceType |
target.resource.resource_subtype |
Der Ressourcentyp des Konfigurationselements. |
configurationItem.tags.Contact |
principal.user.user_display_name ODER principal.user.email_addresses |
Kontaktdaten, die aus Tags extrahiert und nach E-Mail-Adresse und Nutzername geparst wurden. |
configurationItem.tags.OS/configurationItem.tags.Os |
target.asset.platform_software.platform |
Das Betriebssystem aus Tags, das der Plattform zugeordnet ist, wenn es Windows oder Linux ist. |
configurationItemDiff.changeType |
metadata.event_type |
Die Art der Änderung, zugeordnet zu RESOURCE_WRITTEN oder RESOURCE_CREATION. |
detail.accountId |
principal.group.product_object_id |
Die AWS-Konto-ID, die mit dem Ergebnis verknüpft ist. |
detail.actionDescription detail.actionName detail.description |
sec_result.description |
Die Beschreibung des Ergebnisses. |
detail.findings[].AwsAccountId |
principal.group.product_object_id |
Die AWS-Konto-ID, die mit dem Ergebnis verknüpft ist. |
detail.findings[].CompanyName detail.findings[].CreatedAt detail.findings[].Description |
sec_result.description |
Die Beschreibung des Ergebnisses. |
detail.findings[].FindingProviderFields.Severity.Label |
sec_result.severity |
Das Schweregrad-Label des Ergebnisses, in Großbuchstaben umgewandelt. |
detail.findings[].FindingProviderFields.Types[] detail.findings[].FirstObservedAt detail.findings[].GeneratorId detail.findings[].Id detail.findings[].LastObservedAt detail.findings[].ProductArn detail.findings[].ProductFields. |
Siehe unten. | Verschiedene Felder, die für zusätzliche Felder, Hauptkonten und Zielinformationen verwendet werden. |
detail.findings[].ProductName detail.findings[].RecordState detail.findings[].Region |
target.location.name |
Die AWS-Region des Ergebnisses. |
detail.findings[].Resources[].Details. |
Siehe unten. | Details zu den am Ergebnis beteiligten Ressourcen. |
detail.findings[].Resources[].Id |
target.resource.product_object_id |
Die ID der Ressource. |
detail.findings[].Resources[].Partition detail.findings[].Resources[].Region |
target.location.name |
Die AWS-Region der Ressource. |
detail.findings[].Resources[].Tags detail.findings[].Resources[].Type |
target.resource.resource_type, target.resource.resource_subtype, metadata.event_type |
Der Ressourcentyp, der für die Zuordnung von Ressourcentyp, Untertyp und Ereignistyp verwendet wird. |
detail.findings[].Sample detail.findings[].SchemaVersion detail.findings[].Severity.Label detail.findings[].SourceUrl detail.findings[].Title |
sec_result.summary |
Der Titel des Ergebnisses. |
detail.findings[].Types[] detail.findings[].UpdatedAt detail.findings[].Workflow.Status detail.findings[].WorkflowState detail-type |
metadata.product_event_type |
Der Detailtyp des Ereignisses. |
id |
metadata.product_log_id |
Die ID des Ereignisses. |
region |
target.location.name |
Die AWS-Region des Ereignisses. |
resources[] source time version (Parser-Logik) |
metadata.event_timestamp |
Die Erstellungszeit aus dem ursprünglichen Logeintrag, die als Ereigniszeitstempel verwendet wird. |
| (Parser-Logik) | metadata.log_type |
Legen Sie AWS_SECURITY_HUB fest. |
| (Parser-Logik) | metadata.product_name |
Legen Sie AWS Security Hub fest. |
| (Parser-Logik) | metadata.vendor_name |
Legen Sie AMAZON fest. |
| (Parser-Logik) | target.asset.attribute.cloud.environment |
Legen Sie AMAZON_WEB_SERVICES fest. |
| (Parser-Logik) | metadata.event_type |
Wird standardmäßig auf USER_RESOURCE_ACCESS gesetzt, wenn keine Zuordnung von Resources[].Type oder configurationItemDiff.changeType erfolgt. Wird auf STATUS_UPDATE gesetzt, wenn configurationItems vorhanden ist und kein anderer Ereignistyp festgelegt ist. Wird auf RESOURCE_READ gesetzt, wenn configurationItem oder configurationItems vorhanden ist und der Status OK oder ResourceDiscovered ist. Wird auf RESOURCE_DELETION gesetzt, wenn configurationItem oder configurationItems vorhanden ist und der Status ResourceDeleted lautet. |
| (Parser-Logik) | metadata.description |
Wird auf guardduty gesetzt, wenn detail.findings[].ProductFields.aws/guardduty/service/serviceName vorhanden ist. |
| (Parser-Logik) | target.asset.attribute.cloud.vpc.resource_type |
Wird auf VPC_NETWORK gesetzt, wenn configurationItems.relationships[].resourceId mit vpc übereinstimmt. |
| (Parser-Logik) | target.resource.resource_type |
Wird auf VIRTUAL_MACHINE gesetzt, wenn configurationItem oder configurationItems vorhanden ist. Auf UNSPECIFIED gesetzt, wenn kein anderer Ressourcentyp festgelegt ist. |
| (Parser-Logik) | target.asset.platform_software.platform |
Legen Sie WINDOWS oder LINUX fest, je nachdem, ob Windows oder (Linux|LINUX) in der Nachricht für configurationItem vorhanden ist. Für configurationItems wird er basierend auf configItem.tags.OS oder configItem.tags.Os festgelegt. |
| (Parser-Logik) | disambiguation_key |
Wird hinzugefügt, wenn mehrere Ereignisse aus einem einzelnen Logeintrag generiert werden. |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten