F5 Shape-Logs erfassen
Parserversion: 1.0
In diesem Dokument wird beschrieben, wie Sie F5 Shape-Logs mit Cloud Storage V2 in Google Security Operations aufnehmen.
F5 Distributed Cloud Bot Defense (ehemals Shape Security) schützt Anwendungen vor automatisierten Angriffen, indem schädliche Bots identifiziert und abgewehrt werden. Bot Defense verwendet JavaScript und native Mobile SDKs, um Telemetriedaten von Clientbrowsern und Mobilgeräten zu erfassen. Diese Telemetriedaten werden geprüft, bevor Anfragen Ihre Anwendung erreichen. Der Dienst bietet integrierte Dashboards und Berichte, mit denen Sie detaillierte Informationen zum analysierten Traffic aufrufen können, einschließlich Sicherheitsereignissen, Zugriffslogs und Audit-Logs.
Hinweis
Folgende Voraussetzungen müssen erfüllt sein:
- Eine Google SecOps-Instanz
- Ein Google Cloud -Projekt mit aktivierter Cloud Storage API
- Berechtigungen zum Erstellen und Verwalten von Cloud Storage-Buckets
- Berechtigungen zum Verwalten von IAM-Richtlinien (Identity and Access Management) für Cloud Storage-Buckets
- Privilegierter Zugriff auf die F5 Distributed Cloud Console
- Ein F5 Distributed Cloud-Konto mit Zugriff auf den Multi-Cloud Network Connect- oder Shared Configuration-Dienst
Cloud Storage-Bucket erstellen
- Rufen Sie die Google Cloud Console auf.
- Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
- Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
- Klicken Sie auf Bucket erstellen.
Geben Sie die folgenden Konfigurationsdetails an:
Einstellung Wert Bucket benennen Geben Sie einen global eindeutigen Namen ein (z. B. f5-xc-logs).Standorttyp Wählen Sie die Option, die am besten zu Ihren Anforderungen passt (Region, Dual-Region, Multi-Region). Standort Wählen Sie den Standort aus (z. B. us-central1).Speicherklasse Standard (empfohlen für Logs, auf die häufig zugegriffen wird). Zugriffssteuerung Einheitlich (empfohlen). Schutztools Optional: Aktivieren Sie die Objektversionsverwaltung oder die Aufbewahrungsrichtlinie. Klicken Sie auf Erstellen.
F5 Shape API-Anmeldedaten generieren
F5 Distributed Cloud verwendet API-Zertifikate (mTLS) oder API-Tokens zur Authentifizierung. API-Zertifikate werden für erhöhte Sicherheit empfohlen.
API-Zertifikat erstellen
- Melden Sie sich in der F5 Distributed Cloud Console an.
- Wählen Sie auf der Startseite der Console Verwaltung aus.
- Gehen Sie im linken Navigationsmenü zu Personal Management > Credentials.
- Klicken Sie auf Anmeldedaten hinzufügen.
- Geben Sie im Abschnitt Metadaten einen Namen für Ihr Zertifikat ein (z. B.
secops-integration). - Wählen Sie in der Liste Anmeldedatentyp die Option API-Zertifikat aus.
- Geben Sie ein Passwort ein und bestätigen Sie es im Feld Passwort bestätigen.
Wählen Sie im Kalender ein Ablaufdatum aus.
Klicken Sie auf Herunterladen, um das Zertifikat im
.p12-Dateiformat zu generieren und herunterzuladen.Speichern Sie die heruntergeladene Zertifikatsdatei und das Passwort zur späteren Verwendung an einem sicheren Ort.
Google Cloud -Anmeldedaten in F5 Distributed Cloud erstellen
F5 Distributed Cloud benötigt die Anmeldedaten des Dienstkontos Google Cloud , um Logs in Ihren Cloud Storage-Bucket zu schreiben.
Google Cloud -Dienstkonto erstellen
- Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten.
- Klicken Sie auf Dienstkonto erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Dienstkontoname: Geben Sie
f5-xc-log-writer(oder Ihren bevorzugten Namen) ein. - Beschreibung des Dienstkontos: Geben Sie
Service account for F5 Distributed Cloud to write logs to GCSein.
- Dienstkontoname: Geben Sie
- Klicken Sie auf Erstellen und fortfahren.
- Im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt gewähren:
- Klicken Sie auf Rolle auswählen.
- Suchen Sie nach Storage Object Admin und wählen Sie die Rolle aus.
- Klicken Sie auf Weiter.
- Klicken Sie auf Fertig.
IAM-Berechtigungen für Cloud Storage-Bucket gewähren
- Rufen Sie Cloud Storage > Buckets auf.
- Klicken Sie auf den Namen Ihres Buckets (z. B.
f5-xc-logs). - Wechseln Sie zum Tab Berechtigungen.
- Klicken Sie auf Zugriff erlauben.
- Geben Sie die folgenden Konfigurationsdetails an:
- Hauptkonten hinzufügen: Geben Sie die E-Mail-Adresse des Dienstkontos ein (z. B.
f5-xc-log-writer@PROJECT_ID.iam.gserviceaccount.com). - Rollen zuweisen: Wählen Sie Storage Object Admin aus.
- Hauptkonten hinzufügen: Geben Sie die E-Mail-Adresse des Dienstkontos ein (z. B.
- Klicken Sie auf Speichern.
Dienstkontoschlüssel erstellen
- Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten.
- Suchen Sie das Dienstkonto (z. B.
f5-xc-log-writer) und klicken Sie darauf. - Rufen Sie den Tab Schlüssel auf.
- Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
- Wählen Sie JSON als Schlüsseltyp aus.
- Klicken Sie auf Erstellen.
- Die JSON-Schlüsseldatei wird automatisch heruntergeladen. Speichern Sie diese Datei an einem sicheren Ort.
Google Cloud -Anmeldedaten zu F5 Distributed Cloud hinzufügen
- Wählen Sie in der F5 Distributed Cloud Console auf der Startseite Multi-Cloud Network Connect oder Shared Configuration aus.
- Gehen Sie im linken Navigationsmenü zu Verwalten > Standortverwaltung > Cloud-Anmeldedaten.
- Klicken Sie auf Add Cloud Credentials (Cloud-Anmeldedaten hinzufügen).
- Geben Sie im Abschnitt Metadaten einen Namen ein (z. B.
gcp-secops-logs). - Wählen Sie in der Liste Cloud Credentials Type (Cloud-Anmeldedatentyp) die Option GCP Credentials (GCP-Anmeldedaten) aus.
- Klicken Sie im Abschnitt GCP-Anmeldedaten auf Konfigurieren.
- Im Abschnitt Dienstkontoschlüssel:
- Wählen Sie in der Liste Secret-Typ die Option Blindfolded Secret aus.
- Wählen Sie in der Liste Aktion die Option Blindfold New Secret aus.
- Wählen Sie in der Liste Richtlinientyp die Option Integriert aus.
- Fügen Sie im Feld Secret to Blindfold den gesamten Inhalt der heruntergeladenen JSON-Schlüsseldatei ein.
- Klicken Sie auf Übernehmen.
- Klicken Sie auf Speichern und beenden.
Globalen Logempfänger für Cloud Storage konfigurieren
F5 Distributed Cloud Global Log Receiver streamt Logs alle 5 Minuten im NDJSON-Format (durch Zeilenumbruch getrenntes JSON) an Cloud Storage.
Globalen Logempfänger erstellen
- Wählen Sie in der F5 Distributed Cloud Console auf der Startseite Multi-Cloud Network Connect oder Shared Configuration aus.
- Für Multi-Cloud Network Connect: Gehen Sie zu Verwalten > Logverwaltung > Globaler Logempfänger.
- Für Gemeinsame Konfiguration: Gehen Sie zu Verwalten > Globaler Log-Empfänger.
- Klicken Sie auf Globalen Logempfänger hinzufügen.
- Geben Sie im Abschnitt Metadaten einen Namen ein (z. B.
secops-gcs-receiver). - Optional können Sie Labels und eine Beschreibung hinzufügen.
Wählen Sie in der Liste Logtyp die Logtypen aus, die Sie erfassen möchten:
- Anfrageprotokolle: HTTP-Zugriffsprotokolle von Load Balancern
- Sicherheitsereignisse: Bot Defense- und WAF-Sicherheitsereignisse
- Audit-Logs: Konfigurations- und administrative Audit-Logs
- DNS-Anfrageprotokolle: DNS-Abfrageprotokolle
Wählen Sie in der Liste Auswahl der Logeinträge Folgendes aus:
- Wenn Sie den Dienst Multi-Cloud Network Connect verwenden, wählen Sie Logs aus dem aktuellen Namespace auswählen (System-Namespace) aus.
- Wenn Sie den Dienst Gemeinsame Konfiguration verwenden, wählen Sie eine der folgenden Optionen aus:
- Logs aus aktuellem Namespace auswählen: Es werden nur Logs aus dem freigegebenen Namespace gesendet.
- Logs aus allen Namespaces auswählen: Sendet Logs aus allen Namespaces.
- Logs in bestimmten Namespaces auswählen: Geben Sie bestimmte Namespace-Namen ein und klicken Sie auf Element hinzufügen, um weitere hinzuzufügen.
Wählen Sie in der Liste Receiver Configuration (Empfängerkonfiguration) die Option GCP Bucket aus.
Geben Sie im Abschnitt GCP-Bucket die folgende Konfiguration an:
- GCP-Bucket-Name: Geben Sie den Namen Ihres Cloud Storage-Bucket ein (z. B.
f5-xc-logs). - GCP-Cloud-Anmeldedaten: Wählen Sie aus der Liste die von Ihnen erstellten Cloud-Anmeldedaten aus (z. B.
gcp-secops-logs).
- GCP-Bucket-Name: Geben Sie den Namen Ihres Cloud Storage-Bucket ein (z. B.
Erweiterte Einstellungen konfigurieren (optional)
- Klicken Sie auf den Schalter Erweiterte Felder anzeigen.
Konfigurieren Sie im Abschnitt Batch-Optionen Folgendes (optional):
- Batch Timeout Options: Wählen Sie Timeout Seconds aus und geben Sie einen Wert ein (Standard:
300Sekunden). - Batch Max Events (Maximale Anzahl von Ereignissen pro Batch): Wählen Sie Max Events (Maximale Anzahl von Ereignissen) aus und geben Sie einen Wert zwischen 32 und 2.000 ein (optional).
- Batch-Byte: Wählen Sie Max. Byte aus und geben Sie einen Wert zwischen 4.096 und 1.048.576 ein (Standard:
10485760Byte / 10 MB).
- Batch Timeout Options: Wählen Sie Timeout Seconds aus und geben Sie einen Wert ein (Standard:
Konfiguration abschließen und testen
- Klicken Sie auf Speichern und beenden, um den globalen Logempfänger zu erstellen.
- Suchen Sie in der Liste Globaler Logempfänger nach Ihrem Empfänger (z. B.
secops-gcs-receiver). - Klicken Sie in der Spalte Aktionen auf das Dreipunkt-Menü … und wählen Sie Verbindung testen aus.
Warten Sie, bis der Test abgeschlossen ist. Eine Erfolgsmeldung zeigt an, dass die Verbindung funktioniert.
Prüfen Sie, ob Logs in Cloud Storage geschrieben werden:
- Rufen Sie in der Google Cloud Console Cloud Storage > Buckets auf.
- Klicken Sie auf den Namen Ihres Buckets (z. B.
f5-xc-logs). - Innerhalb von 5–10 Minuten sollten Ordner mit der folgenden Struktur erstellt werden:
- Tagesordner:
YYYY-MM-DD/ - Stündlicher Unterordner:
YYYY-MM-DD/HH/ - Logdateien:
YYYY-MM-DD/HH/logs_YYYYMMDDHHMMSS.ndjson.gz
- Tagesordner:
Firewall-Zulassungsliste konfigurieren
Für F5 Distributed Cloud müssen bestimmte IP-Bereiche in Ihrer Firewall für die Logbereitstellung zugelassen werden.
Fügen Sie die folgenden IP-Adressbereiche zur Zulassungsliste Ihrer Firewall hinzu:
193.16.236.64/29185.160.8.152/29
Google SecOps-Dienstkonto abrufen
Google SecOps verwendet ein eindeutiges Dienstkonto, um Daten aus Ihrem Cloud Storage-Bucket zu lesen. Sie müssen diesem Dienstkonto Zugriff auf Ihren Bucket gewähren.
E‑Mail-Adresse des Dienstkontos abrufen
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
F5 Distributed Cloud Bot Defense. - Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
- Wählen Sie F5_SHAPE als Logtyp aus.
Klicken Sie auf Dienstkonto abrufen. Eine eindeutige E-Mail-Adresse für das Dienstkonto wird angezeigt, z. B.:
secops-12345678@secops-gcp-prod.iam.gserviceaccount.comKopieren Sie die E-Mail-Adresse, um sie im nächsten Schritt zu verwenden.
Klicken Sie auf Weiter.
Geben Sie Werte für die folgenden Eingabeparameter an:
Storage-Bucket-URL: Geben Sie den Cloud Storage-Bucket-URI mit dem Präfixpfad ein:
gs://f5-xc-logs/- Ersetzen Sie
f5-xc-logsdurch den tatsächlichen Namen Ihres Cloud Storage-Bucket. - Wenn Sie im globalen Logempfänger ein bestimmtes Präfix konfiguriert haben, fügen Sie es in den Pfad ein (z. B.
gs://f5-xc-logs/bot-defense/).
- Ersetzen Sie
Option zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus:
- Nie: Nach Übertragungen werden keine Dateien gelöscht (für Tests empfohlen).
- Übertragene Dateien löschen: Dateien werden nach erfolgreicher Übertragung gelöscht.
Übertragene Dateien und leere Verzeichnisse löschen: Dateien und leere Verzeichnisse werden nach erfolgreicher Übertragung gelöscht.
Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden (Standardwert: 180 Tage).
Asset-Namespace: Der Asset-Namespace.
Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
Klicken Sie auf Weiter.
Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Dem Google SecOps-Dienstkonto IAM-Berechtigungen gewähren
Das Google SecOps-Dienstkonto benötigt die Rolle Storage-Objekt-Betrachter für Ihren Cloud Storage-Bucket.
- Rufen Sie Cloud Storage > Buckets auf.
- Klicken Sie auf den Namen Ihres Buckets (z. B.
f5-xc-logs). - Wechseln Sie zum Tab Berechtigungen.
- Klicken Sie auf Zugriff erlauben.
- Geben Sie die folgenden Konfigurationsdetails an:
- Hauptkonten hinzufügen: Fügen Sie die E‑Mail-Adresse des Google SecOps-Dienstkontos ein.
- Rollen zuweisen: Wählen Sie Storage Object Viewer aus.
- Klicken Sie auf Speichern.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| msg.requestHeaders.Proxy-Client-IP, msg.requestHeaders.WF-Forwarded-For, msg.requestHeaders.X-Forwarded-For, msg.requestHeaders.wl-proxy-client-ip, msg.hashedUserAgent, msg.transactionId, msg.hashedUsername, msg.dcgShapeFailedOn, ShapeShifterId, eventType, eventId, latRequest, latResponse, latTotal, latRspWait, count, latEccWait | additional.fields | Zusammengeführt aus Labels, die aus verschiedenen Feldern erstellt wurden |
| intermediary | intermediary | Wert wird direkt kopiert, wenn er nicht leer ist |
| Beschreibung | metadata.description | Wert direkt kopiert |
| target, has_principal_machine | metadata.event_type | Auf NETWORK_HTTP setzen, wenn target != "", andernfalls STATUS_UPDATE, wenn has_principal_machine == true, andernfalls GENERIC_EVENT |
| App | network.application_protocol | Wert in Großbuchstaben umgewandelt |
| requestMethod, msg.method | network.http.method | Wert aus requestMethod, falls nicht leer, andernfalls msg.method |
| requestClientApplication, msg.requestHeaders.User-Agent | network.http.parsed_user_agent | Wert aus requestClientApplication, falls nicht leer, andernfalls msg.requestHeaders.User-Agent, konvertiert in geparsten User-Agent |
| requestContext, msg.requestHeaders.Referer | network.http.referral_url | Wert aus requestContext, falls nicht leer, andernfalls msg.requestHeaders.Referer |
| msg.sseResponseCode, prCode | network.http.response_code | Wert aus msg.sseResponseCode, wenn nicht leer, andernfalls prCode, in Ganzzahl konvertiert |
| requestClientApplication, msg.requestHeaders.User-Agent | network.http.user_agent | Wert aus requestClientApplication, wenn nicht leer, andernfalls msg.requestHeaders.User-Agent |
| requestHeader.x-shape-src-virtual | observer.ip | Wert direkt kopiert |
| Prinzipal | Prinzipal | Wert direkt kopiert |
| msg.host | principal.asset.hostname | Wert direkt kopiert |
| src, msg.src, msg.trueClientIP, requestHeader.X-Forwarded-For | principal.asset.ip | Wert aus „src“, wenn nicht leer, sonst „msg.src“, sonst „msg.trueClientIP“, sonst erste IP-Adresse aus „X-Forwarded-For“, wenn != „src“ |
| msg.host | principal.hostname | Wert direkt kopiert |
| src, msg.src, msg.trueClientIP, requestHeader.X-Forwarded-For | principal.ip | Wert aus „src“, wenn nicht leer, sonst „msg.src“, sonst „msg.trueClientIP“, sonst erste IP-Adresse aus „X-Forwarded-For“, wenn != „src“ |
| msg.requestHeaders | principal.resource.attribute.labels | Zusammengeführt aus Schlüssel/Wert-Paaren in msg.requestHeaders |
| msg.uri | principal.url | Wert direkt kopiert |
| security_result | security_result | Wert direkt kopiert |
| deviceExternalId | security_result.about.asset_id | Wert direkt kopiert |
| flowLabel, agentLabel, requestHeader.Content-Length, requestHeader.Content-Type, requestHeader.Accept, requestHeader.Accept-Encoding, browserType, accountInfo, requestHeader.Via, asn, tid, ctag, requestHeader.Cache-Control, transactionResult | security_result.about.labels | Zusammengeführt aus Labels, die aus verschiedenen Feldern erstellt wurden |
| act, msg.transactionResult | security_result.action | Auf ALLOW setzen, wenn die Aktion mit PASS und isAttack übereinstimmt, andernfalls UNKNOWN_ACTION; oder ALLOW, wenn msg.transactionResult == Success, BLOCK, wenn Failure |
| act, msg.transactionResult | security_result.action_details | Wert aus „act“, wenn nicht leer, andernfalls „msg.transactionResult“ |
| die Ausprägung | security_result.severity | Wird auf HIGH gesetzt, wenn der Status „Error“, „error“ oder „warning“ ist; auf CRITICAL, wenn der Status „critical“ ist; auf MEDIUM, wenn der Status „notice“ ist; auf LOW, wenn der Status „information“, „info“ oder „INFO“ ist |
| die Ausprägung | security_result.severity_details | Wert direkt kopiert |
| attackCause | security_result.threat_name | Wert direkt kopiert |
| Ziel | Ziel | Wert direkt kopiert |
| appName | target.application | Wert direkt kopiert |
| dst, msg.dst | target.asset.ip | Wert aus dst, wenn nicht leer, andernfalls msg.dst |
| dhost | target.hostname | Wert direkt kopiert |
| dst, msg.dst | target.ip | Wert aus dst, wenn nicht leer, andernfalls msg.dst |
| countryName | target.location.country_or_region | Wert direkt kopiert |
| dpt | target.port | In Ganzzahl umgewandelt |
| msg.responseHeaders | target.resource.attribute.labels | Zusammengeführt aus Schlüssel/Wert-Paaren in msg.responseHeaders |
| Anfrage | target.url | Wert direkt kopiert |
| requestHeader.X-Forwarded-For | intermediary.ip | Auf nachfolgende IP-Adressen aus dem X-Forwarded-For-Array festlegen |
| metadata.product_name | Auf „Form“ festlegen | |
| metadata.vendor_name | Auf „F5“ festlegen | |
requestHeaders_id_array.User-Agent |
network.http.user_agent |
Aus Änderungsprotokoll zugeordnet |
requestHeaders_id_array.Referer |
network.http.referral_url |
Aus Änderungsprotokoll zugeordnet |
requestHeaders_id_array.Proxy-Client-IP", "requestHeaders_id_array.WF-Forwarded-For", "requestHeaders_id_array.X-Forwarded-For", and "requestHeaders_id_array.wl-proxy-client-ip |
additional.fields |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten