F5 Shape-Logs erfassen

Parserversion: 1.0

Unterstützt in:

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

  1. Rufen Sie die Google Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
  3. Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
  4. Klicken Sie auf Bucket erstellen.
  5. 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.
  6. 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

  1. Melden Sie sich in der F5 Distributed Cloud Console an.
  2. Wählen Sie auf der Startseite der Console Verwaltung aus.
  3. Gehen Sie im linken Navigationsmenü zu Personal Management > Credentials.
  4. Klicken Sie auf Anmeldedaten hinzufügen.
  5. Geben Sie im Abschnitt Metadaten einen Namen für Ihr Zertifikat ein (z. B. secops-integration).
  6. Wählen Sie in der Liste Anmeldedatentyp die Option API-Zertifikat aus.
  7. Geben Sie ein Passwort ein und bestätigen Sie es im Feld Passwort bestätigen.
  8. Wählen Sie im Kalender ein Ablaufdatum aus.

  9. Klicken Sie auf Herunterladen, um das Zertifikat im .p12-Dateiformat zu generieren und herunterzuladen.

  10. 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

  1. Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten.
  2. Klicken Sie auf Dienstkonto erstellen.
  3. 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 GCS ein.
  4. Klicken Sie auf Erstellen und fortfahren.
  5. Im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt gewähren:
    1. Klicken Sie auf Rolle auswählen.
    2. Suchen Sie nach Storage Object Admin und wählen Sie die Rolle aus.
  6. Klicken Sie auf Weiter.
  7. Klicken Sie auf Fertig.

IAM-Berechtigungen für Cloud Storage-Bucket gewähren

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets (z. B. f5-xc-logs).
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. 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.
  6. Klicken Sie auf Speichern.

Dienstkontoschlüssel erstellen

  1. Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten.
  2. Suchen Sie das Dienstkonto (z. B. f5-xc-log-writer) und klicken Sie darauf.
  3. Rufen Sie den Tab Schlüssel auf.
  4. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
  5. Wählen Sie JSON als Schlüsseltyp aus.
  6. Klicken Sie auf Erstellen.
  7. Die JSON-Schlüsseldatei wird automatisch heruntergeladen. Speichern Sie diese Datei an einem sicheren Ort.

Google Cloud -Anmeldedaten zu F5 Distributed Cloud hinzufügen

  1. Wählen Sie in der F5 Distributed Cloud Console auf der Startseite Multi-Cloud Network Connect oder Shared Configuration aus.
  2. Gehen Sie im linken Navigationsmenü zu Verwalten > Standortverwaltung > Cloud-Anmeldedaten.
  3. Klicken Sie auf Add Cloud Credentials (Cloud-Anmeldedaten hinzufügen).
  4. Geben Sie im Abschnitt Metadaten einen Namen ein (z. B. gcp-secops-logs).
  5. Wählen Sie in der Liste Cloud Credentials Type (Cloud-Anmeldedatentyp) die Option GCP Credentials (GCP-Anmeldedaten) aus.
  6. Klicken Sie im Abschnitt GCP-Anmeldedaten auf Konfigurieren.
  7. Im Abschnitt Dienstkontoschlüssel:
    1. Wählen Sie in der Liste Secret-Typ die Option Blindfolded Secret aus.
    2. Wählen Sie in der Liste Aktion die Option Blindfold New Secret aus.
    3. Wählen Sie in der Liste Richtlinientyp die Option Integriert aus.
    4. Fügen Sie im Feld Secret to Blindfold den gesamten Inhalt der heruntergeladenen JSON-Schlüsseldatei ein.
  8. Klicken Sie auf Übernehmen.
  9. 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

  1. 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.
  2. Klicken Sie auf Globalen Logempfänger hinzufügen.
  3. Geben Sie im Abschnitt Metadaten einen Namen ein (z. B. secops-gcs-receiver).
  4. Optional können Sie Labels und eine Beschreibung hinzufügen.
  5. 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
  6. 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.
  7. Wählen Sie in der Liste Receiver Configuration (Empfängerkonfiguration) die Option GCP Bucket aus.

  8. 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).

Erweiterte Einstellungen konfigurieren (optional)

  1. Klicken Sie auf den Schalter Erweiterte Felder anzeigen.
  2. Konfigurieren Sie im Abschnitt Batch-Optionen Folgendes (optional):

    • Batch Timeout Options: Wählen Sie Timeout Seconds aus und geben Sie einen Wert ein (Standard: 300 Sekunden).
    • 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: 10485760 Byte / 10 MB).

Konfiguration abschließen und testen

  1. Klicken Sie auf Speichern und beenden, um den globalen Logempfänger zu erstellen.
  2. Suchen Sie in der Liste Globaler Logempfänger nach Ihrem Empfänger (z. B. secops-gcs-receiver).
  3. Klicken Sie in der Spalte Aktionen auf das Dreipunkt-Menü … und wählen Sie Verbindung testen aus.
  4. Warten Sie, bis der Test abgeschlossen ist. Eine Erfolgsmeldung zeigt an, dass die Verbindung funktioniert.

  5. Prüfen Sie, ob Logs in Cloud Storage geschrieben werden:

    1. Rufen Sie in der Google Cloud Console Cloud Storage > Buckets auf.
    2. Klicken Sie auf den Namen Ihres Buckets (z. B. f5-xc-logs).
    3. 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

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/29
  • 185.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

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. F5 Distributed Cloud Bot Defense.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie F5_SHAPE als Logtyp aus.
  7. 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.com
    
  8. Kopieren Sie die E-Mail-Adresse, um sie im nächsten Schritt zu verwenden.

  9. Klicken Sie auf Weiter.

  10. 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-logs durch 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/).
    • 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.

  11. Klicken Sie auf Weiter.

  12. 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.

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets (z. B. f5-xc-logs).
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. 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.
  6. 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