Akamai Guardicore Segmentation-Logs (früher Guardicore Centra) erfassen

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Akamai Guardicore Segmentation (früher Guardicore Centra) so konfigurieren, dass Logs mit dem Akamai Unified Log Streamer (ULS) mit HTTP-Ausgabe an Google Security Operations gesendet werden.

Guardicore Centra ist eine Mikrosegmentierungsplattform, die Zero-Trust-Netzwerksicherheit für Rechenzentren, Cloud-Umgebungen und Endpunkte bietet. Sie bietet Einblick in Anwendungsabhängigkeiten, erkennt Sicherheitslücken durch Deception-Technologie und ermöglicht eine detaillierte Segmentierungssteuerung, um laterale Bewegungen zu verhindern und Bedrohungen einzudämmen.

Hinweis

Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • Guardicore Centra-Instanz (Cloud oder lokal)
  • Einen Linux-Server zum Ausführen von Akamai ULS (mindestens: 1 vCPU, 1 GB RAM, 500 MB Speicherplatz)
  • Python 3.9 oder höher auf dem ULS-Server installiert
  • Administratorzugriff auf Guardicore Centra, um einen API-Nutzer mit Lesezugriff zu erstellen
  • Ausgehender HTTPS-Zugriff vom ULS-Server auf Google SecOps-Aufnahmeendpunkte
  • Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)

Feed in Google SecOps erstellen

  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 der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein. Beispiel: Guardicore Centra Logs.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie Guardicore Centra als Logtyp aus.
  7. Klicken Sie auf Weiter.
  8. Geben Sie Werte für die folgenden Eingabeparameter an:
    • Trennzeichen für Aufteilung: Geben Sie \n ein, um mehrzeilige Ereignisse aufzuteilen (ULS sendet durch Zeilenumbruch getrenntes JSON).
    • Asset-Namespace: Der Asset-Namespace.
    • Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
  9. Klicken Sie auf Weiter.
  10. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

Secret-Schlüssel generieren und speichern

Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:

  1. Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
  2. In einem Dialogfeld wird der geheime Schlüssel angezeigt.
  3. Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.

Feed-Endpunkt-URL abrufen

  1. Gehen Sie zum Tab Details des Feeds.
  2. Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
  3. Das URL-Format ist entweder:

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs
    

    oder

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs
    
  4. Speichern Sie diese URL für die nächsten Schritte.

  5. Klicken Sie auf Fertig.

Google Cloud -API-Schlüssel erstellen

Google SecOps erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.

API-Schlüssel erstellen

  1. Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus. Dies ist das Projekt, das mit Ihrer Google SecOps-Instanz verknüpft ist.
  3. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
  4. Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
  5. Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.

API-Schlüssel einschränken

  1. Gehen Sie auf der Seite mit den Einstellungen für den API-Schlüssel so vor:
    • Name: Geben Sie einen aussagekräftigen Namen ein (z. B. Google SecOps Guardicore Webhook API Key).
  2. Gehen Sie unter API-Einschränkungen so vor:
    1. Wählen Sie Schlüssel einschränken aus.
    2. Suchen Sie im Drop-down-Menü APIs auswählen nach der Chronicle API und wählen Sie sie aus.
  3. Klicken Sie auf Speichern.
  4. Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
  5. Speichern Sie den API-Schlüssel an einem sicheren Ort.

Guardicore Centra-Anmeldedaten konfigurieren

Nutzer mit Lesezugriff für die API in Guardicore Centra erstellen

ULS authentifiziert sich bei der Centra API mit einem Portalnutzer. Erstellen Sie einen dedizierten Nutzer mit Leseberechtigungen, anstatt ein Administratorkonto zu verwenden:

  1. Melden Sie sich in der Guardicore Centra-Verwaltungskonsole an.
  2. Gehen Sie zu Verwaltung > Nutzer.
  3. Klicken Sie auf Create User (Nutzer erstellen).
  4. Geben Sie die folgenden Konfigurationsdetails an:
    • Nutzername: Geben Sie einen Namen für den Integrationsnutzer ein (z. B. secops-uls).
    • Passwort: Geben Sie ein Passwort ein.
    • Berechtigungsschema: Wählen Sie Support (Lesezugriff) aus.
  5. Klicken Sie auf Speichern.
  6. Melden Sie sich ab und dann mit dem neuen Nutzer an und ändern Sie das Passwort.
  7. Notieren Sie sich den Hostnamen der Centra-Verwaltungskonsole (ohne https://). ULS verwendet diesen als API-Hostnamen.

Datei „.edgerc“ für die Guardicore-Authentifizierung erstellen

Akamai ULS liest Guardicore-Anmeldedaten aus der Datei .edgerc, aus den Schlüsseln gc_hostname, gc_username und gc_password.

  1. Erstellen Sie auf dem ULS-Server die Datei .edgerc im Basisverzeichnis so:

    nano ~/.edgerc
    
  2. Fügen Sie die folgende Konfiguration hinzu:

    [default]
    gc_hostname = your-instance.cloud.guardicore.com
    gc_username = your_username
    gc_password = your_password
    

    Ersetzen Sie die folgenden Werte:

    • your-instance.cloud.guardicore.com: Ihr Guardicore Centra-Verwaltungshostname (ohne https://)
    • your_username: Der Nutzername des im vorherigen Abschnitt erstellten API-Nutzers mit Lesezugriff
    • your_password: das Passwort des Nutzers

    Beispiel:

    [default]
    gc_hostname = cus-1234.cloud.guardicore.com
    gc_username = secops-uls
    gc_password = MySecurePassword123
    
  3. Speichern und schließen Sie die Datei.

  4. Legen Sie die entsprechenden Berechtigungen so fest:

    chmod 600 ~/.edgerc
    

Akamai ULS installieren

ULS von GitHub installieren

  1. Klonen Sie das ULS-Repository auf dem ULS-Server so:

    git clone https://github.com/akamai/uls.git
    cd uls
    
  2. Python-Abhängigkeiten installieren:

    pip3 install -r requirements.txt
    
  3. Installieren Sie das Guardicore-Log-Fetcher-Modul (gc-logs) im Verzeichnis ext des ULS-Check-outs:

    git clone -q --depth 1 -b v0.0.8 --single-branch https://github.com/MikeSchiessl/gc-logs.git ext/cli-gc
    pip3 install -r ext/cli-gc/bin/requirements.txt
    
  4. Installation prüfen:

    python3 bin/uls.py --help
    

ULS so konfigurieren, dass Logs an Google SecOps gesendet werden

Google SecOps-Webhook-URL erstellen

  • Kombinieren Sie die Google SecOps-Endpunkt-URL und den API-Schlüssel so:

    <ENDPOINT_URL>?key=<API_KEY>
    
  • Beispiel:

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=AIzaSyD...
    

ULS für den Guardicore NETLOG-Feed ausführen

Der Feed NETLOG enthält Netzwerkflusslogs von Guardicore-Agents.

  1. Führen Sie ULS mit dem folgenden Befehl aus:

    python3 bin/uls.py \
        --input gc \
        --feed NETLOG \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • Ersetzen Sie die folgenden Werte:
      • YOUR_API_KEY: Der zuvor erstellte Google Cloud API-Schlüssel
      • YOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
  2. ULS beginnt mit dem Streamen von NETLOG-Ereignissen an Google SecOps.

ULS für den Guardicore INCIDENT-Feed ausführen

Der Feed INCIDENT enthält von Guardicore erkannte Sicherheitsvorfälle.

  1. Führen Sie ULS mit dem folgenden Befehl aus:

    python3 bin/uls.py \
        --input gc \
        --feed INCIDENT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • Ersetzen Sie die folgenden Werte:
      • YOUR_API_KEY: Der zuvor erstellte Google Cloud API-Schlüssel
      • YOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
  2. ULS beginnt mit dem Streamen von INCIDENT-Ereignissen an Google SecOps.

ULS für den Guardicore AGENT-Feed ausführen

Der AGENT-Feed enthält Informationen zum Status und Zustand des Agents.

  1. Führen Sie ULS mit dem folgenden Befehl aus:

    python3 bin/uls.py \
        --input gc \
        --feed AGENT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • Ersetzen Sie die folgenden Werte:
      • YOUR_API_KEY: Der zuvor erstellte Google Cloud API-Schlüssel
      • YOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
  2. ULS beginnt mit dem Streamen von AGENT-Ereignissen an Google SecOps.

ULS für Guardicore SYSTEM-Feed ausführen

Der SYSTEM-Feed enthält Systembenachrichtigungen und -ereignisse.

  1. Führen Sie ULS mit dem folgenden Befehl aus:

    python3 bin/uls.py \
        --input gc \
        --feed SYSTEM \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • Ersetzen Sie die folgenden Werte:
      • YOUR_API_KEY: Der zuvor erstellte Google Cloud API-Schlüssel
      • YOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel.
  2. ULS beginnt mit dem Streamen von SYSTEM-Ereignissen an Google SecOps.

ULS für den Guardicore AUDIT-Feed ausführen

Der AUDIT-Feed enthält Audit-Logs zu Administratoraktionen.

  1. Führen Sie ULS mit dem folgenden Befehl aus:

    python3 bin/uls.py \
        --input gc \
        --feed AUDIT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • Ersetzen Sie die folgenden Werte:
      • YOUR_API_KEY: Der zuvor erstellte Google Cloud API-Schlüssel
      • YOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel.
  2. ULS beginnt mit dem Streamen von AUDIT-Ereignissen an Google SecOps.

ULS als Hintergrunddienst ausführen

Damit ULS kontinuierlich ausgeführt wird, konfigurieren Sie es als systemd-Dienst.

Erstellen Sie eine systemd-Dienstdatei für den NETLOG-Feed.

  1. Erstellen Sie eine Dienstdatei:

    sudo nano /etc/systemd/system/uls-guardicore-netlog.service
    
  2. Fügen Sie den folgenden Inhalt hinzu:

    [Unit]
    Description=Akamai ULS - Guardicore NETLOG
    After=network.target
    
    [Service]
    Type=simple
    User=root
    WorkingDirectory=/root/uls
    ExecStart=/usr/bin/python3 /root/uls/bin/uls.py --input gc --feed NETLOG --output http --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' --httpformat '%%s'
    Restart=always
    RestartSec=10
    
    [Install]
    WantedBy=multi-user.target
    
    • Ersetzen Sie die folgenden Werte:
      • /root/uls: Der Pfad, in den Sie das ULS-Repository geklont haben.
      • YOUR_API_KEY: Der API-Schlüssel von Google Cloud
      • YOUR_SECRET_KEY: Der geheime Google SecOps-Schlüssel
  3. Speichern und schließen Sie die Datei.

  4. Aktivieren und starten Sie den Dienst:

    sudo systemctl daemon-reload
    sudo systemctl enable uls-guardicore-netlog.service
    sudo systemctl start uls-guardicore-netlog.service
    
  5. Prüfen Sie den Dienststatus:

    sudo systemctl status uls-guardicore-netlog.service
    

Zusätzliche Dienste für andere Feeds erstellen

Wiederholen Sie die vorherigen Schritte für jeden Feed, den Sie erfassen möchten (INCIDENT, AGENT, SYSTEM, AUDIT), und erstellen Sie separate Dienstdateien so:

  • /etc/systemd/system/uls-guardicore-incident.service
  • /etc/systemd/system/uls-guardicore-agent.service
  • /etc/systemd/system/uls-guardicore-system.service
  • /etc/systemd/system/uls-guardicore-audit.service

Ändern Sie den Parameter --feed und den Dienstnamen in jeder Datei entsprechend.

Logaufnahme prüfen

  1. Warten Sie 5–10 Minuten, bis die Logs aufgenommen und verarbeitet wurden.
  2. Rufen Sie in der Google SecOps-Konsole die Suche auf.
  3. Führen Sie die folgende UDM-Suchanfrage aus:

    metadata.vendor_name = "Guardicore"
    
  4. Wenn die Logs erfolgreich aufgenommen wurden, sollten Guardicore-Ereignisse in den Suchergebnissen angezeigt werden.

  5. Sie können auch nach bestimmten Feedtypen suchen:

    metadata.vendor_name = "Guardicore" AND metadata.product_name = "Centra"
    

Fehlerbehebung

ULS-Verbindungsfehler

Wenn ULS keine Verbindung zu Guardicore herstellen kann, gehen Sie so vor:

  1. Prüfen Sie, ob die Datei .edgerc den richtigen Hostnamen und die richtigen Anmeldedaten enthält.
  2. Testen Sie die Verbindung zu Ihrer Guardicore-Instanz so:

    curl -u "username:password" https://your-instance.cloud.guardicore.com/api/v3.0/visibility
    
  3. Prüfen Sie, ob die Guardicore-Instanz vom ULS-Server aus erreichbar ist.

ULS-HTTP-Ausgabefehler

Wenn ULS keine Logs an Google SecOps senden kann, gehen Sie so vor:

  1. Prüfen Sie, ob der API-Schlüssel und der geheime Schlüssel korrekt sind.
  2. Prüfen Sie, ob die Google SecOps-Endpunkt-URL für Ihre Region korrekt ist.
  3. Prüfen Sie die ausgehende HTTPS-Verbindung vom ULS-Server:

    curl -I https://malachiteingestion-pa.googleapis.com
    
  4. Prüfen Sie die ULS-Logs auf Fehlermeldungen:

    sudo journalctl -u uls-guardicore-netlog.service -f
    

Logs werden nicht auf der Plattform angezeigt

Wenn Logs nicht in Google SecOps angezeigt werden, gehen Sie so vor:

  1. Prüfen Sie unter Einstellungen > Datenverwaltung > Feeds, ob der Webhook-Feed den Status Aktiv hat.
  2. Prüfen Sie den Tab Zustand des Feeds auf Aufnahmefehler.
  3. Prüfen Sie, ob das Trennzeichen in der Feedkonfiguration auf \n festgelegt ist.
  4. Achten Sie darauf, dass der Logtyp auf Guardicore Centra festgelegt ist.

Fehler bei selbst signierten Zertifikaten

Wenn Ihre Guardicore-Instanz ein selbst signiertes Zertifikat verwendet, kann ULS mit SSL-Überprüfungsfehlern fehlschlagen. So umgehen Sie die SSL-Überprüfung (nicht für die Produktion empfohlen):

  • Fügen Sie dem ULS-Befehl das Flag --httpinsecure hinzu:

    python3 bin/uls.py \
        --input gc \
        --feed NETLOG \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s' \
        --httpinsecure
    

Verfügbare Guardicore-Feeds

Akamai ULS unterstützt die folgenden Guardicore-Feeds:

Feedname Beschreibung ULS-Feedparameter
NETLOG Netzwerkflusslogs von Guardicore-Agents NETLOG
INCIDENT Von Guardicore erkannte Sicherheitsvorfälle INCIDENT
AGENT Agent-Status und Informationen zum Zustand AGENT
SYSTEM Systembenachrichtigungen** Benachrichtigungen und Ereignisse auf Systemebene
AUDIT Logs Administrative Aktionen und Konfigurationsänderungen AUDIT

Referenz zu Authentifizierungsmethoden

Google SecOps-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. Akamai ULS verwendet die Hybridmethode mit dem API-Schlüssel in der URL und dem geheimen Schlüssel im Header.

Von ULS verwendete Methode: Hybrid (URL + Header)

  • Anfrageformat:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    X-Webhook-Access-Key: <SECRET_KEY>
    
    {"event": "data", "timestamp": "2025-01-15T10:30:00Z"}
    
  • ULS-Befehlsformat:

    --httpurl "<ENDPOINT_URL>?key=<API_KEY>"
    --httpauthheader '{"X-Webhook-Access-Key": "<SECRET_KEY>"}'
    

Namen der Authentifizierungsheader

Google SecOps akzeptiert die folgenden Headernamen für die Authentifizierung:

Für den API-Schlüssel:

  • X-goog-api-key (empfohlen)
  • X-goog-api-key (Groß-/Kleinschreibung wird nicht berücksichtigt)

Für den geheimen Schlüssel:

  • X-Webhook-Access-Key (empfohlen)
  • X-Webhook-Access-Key (Groß-/Kleinschreibung wird nicht berücksichtigt)

Webhook-Limits und Best Practices

Anfragelimits

Limit Wert
Maximale Länge einer einzelnen Logzeile 1 MB
Maximale Abfragen pro Sekunde 15.000
Zeitlimit für Anfragen 90 Sekunden
Wiederholungsverhalten Vom Absender verwaltet. Google SecOps gibt den HTTP-Fehler 429 zurück, wenn das Burst-Limit überschritten wird. Das sendende System muss die Daten zwischenspeichern und den Vorgang wiederholen.

Best Practices

  • Führen Sie für jeden Feedtyp separate ULS-Instanzen aus, um die Zuverlässigkeit und Fehlerbehebung zu verbessern.
  • Überwachen Sie den ULS-Dienststatus mit systemd und richten Sie Benachrichtigungen für Dienstfehler ein.
  • Rotieren Sie die Guardicore-Anmeldedaten regelmäßig und aktualisieren Sie die Datei .edgerc.
  • Verwenden Sie in Guardicore ein dediziertes Dienstkonto mit Lesezugriff auf die API.
  • Konfigurieren Sie die Logrotation für ULS-Logs, um Probleme mit dem Speicherplatz zu vermeiden.
  • Testen Sie Failover-Szenarien, indem Sie ULS auf mehreren Servern mit Load Balancing ausführen.

UDM-Zuordnungstabelle

In der folgenden Tabelle sind die Logfelder des Guardicore Centra-Logs und die entsprechenden UDM-Felder aufgeführt.

Logfeld UDM-Feld Beschreibung
timestamp metadata.event_timestamp Zeitstempel des Ereignisses
source_ip principal.ip Quell-IP-Adresse
destination_ip target.ip IP-Adresse des Ziels
source_port principal.port Quellportnummer
destination_port target.port Zielportnummer
protocol network.ip_protocol Netzwerkprotokoll
action security_result.action Sicherheitsmaßnahme ergriffen
severity security_result.severity Schweregrad des Ereignisses
user principal.user.userid Nutzername
hostname principal.hostname Hostname der Quelle
process_name principal.process.file.full_path Prozessname
incident_id security_result.detection_fields.key Vorfall-ID
description security_result.description Ereignisbeschreibung

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten