Akamai Guardicore Segmentation-Logs (früher Guardicore Centra) erfassen
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
- 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 der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein. Beispiel:
Guardicore Centra Logs. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie Guardicore Centra als Logtyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung: Geben Sie
\nein, 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.
- Trennzeichen für Aufteilung: Geben Sie
- Klicken Sie auf Weiter.
- 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:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
- Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.
Feed-Endpunkt-URL abrufen
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format ist entweder:
https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogsoder
https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogsSpeichern Sie diese URL für die nächsten Schritte.
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
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus. Dies ist das Projekt, das mit Ihrer Google SecOps-Instanz verknüpft ist.
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- 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).
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Chronicle API und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
- 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:
- Melden Sie sich in der Guardicore Centra-Verwaltungskonsole an.
- Gehen Sie zu Verwaltung > Nutzer.
- Klicken Sie auf Create User (Nutzer erstellen).
- 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.
- Nutzername: Geben Sie einen Namen für den Integrationsnutzer ein (z. B.
- Klicken Sie auf Speichern.
- Melden Sie sich ab und dann mit dem neuen Nutzer an und ändern Sie das Passwort.
- 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.
Erstellen Sie auf dem ULS-Server die Datei
.edgercim Basisverzeichnis so:nano ~/.edgercFügen Sie die folgende Konfiguration hinzu:
[default] gc_hostname = your-instance.cloud.guardicore.com gc_username = your_username gc_password = your_passwordErsetzen Sie die folgenden Werte:
your-instance.cloud.guardicore.com: Ihr Guardicore Centra-Verwaltungshostname (ohnehttps://)your_username: Der Nutzername des im vorherigen Abschnitt erstellten API-Nutzers mit Lesezugriffyour_password: das Passwort des Nutzers
Beispiel:
[default] gc_hostname = cus-1234.cloud.guardicore.com gc_username = secops-uls gc_password = MySecurePassword123Speichern und schließen Sie die Datei.
Legen Sie die entsprechenden Berechtigungen so fest:
chmod 600 ~/.edgerc
Akamai ULS installieren
ULS von GitHub installieren
Klonen Sie das ULS-Repository auf dem ULS-Server so:
git clone https://github.com/akamai/uls.git cd ulsPython-Abhängigkeiten installieren:
pip3 install -r requirements.txtInstallieren Sie das Guardicore-Log-Fetcher-Modul (
gc-logs) im Verzeichnisextdes 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.txtInstallation 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.
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üsselYOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
- Ersetzen Sie die folgenden Werte:
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.
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üsselYOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
- Ersetzen Sie die folgenden Werte:
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.
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üsselYOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel
- Ersetzen Sie die folgenden Werte:
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.
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üsselYOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel.
- Ersetzen Sie die folgenden Werte:
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.
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üsselYOUR_SECRET_KEY: Der zuvor generierte geheime Google SecOps-Schlüssel.
- Ersetzen Sie die folgenden Werte:
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.
Erstellen Sie eine Dienstdatei:
sudo nano /etc/systemd/system/uls-guardicore-netlog.serviceFü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 CloudYOUR_SECRET_KEY: Der geheime Google SecOps-Schlüssel
- Ersetzen Sie die folgenden Werte:
Speichern und schließen Sie die Datei.
Aktivieren und starten Sie den Dienst:
sudo systemctl daemon-reload sudo systemctl enable uls-guardicore-netlog.service sudo systemctl start uls-guardicore-netlog.servicePrü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
- Warten Sie 5–10 Minuten, bis die Logs aufgenommen und verarbeitet wurden.
- Rufen Sie in der Google SecOps-Konsole die Suche auf.
Führen Sie die folgende UDM-Suchanfrage aus:
metadata.vendor_name = "Guardicore"Wenn die Logs erfolgreich aufgenommen wurden, sollten Guardicore-Ereignisse in den Suchergebnissen angezeigt werden.
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:
- Prüfen Sie, ob die Datei
.edgercden richtigen Hostnamen und die richtigen Anmeldedaten enthält. Testen Sie die Verbindung zu Ihrer Guardicore-Instanz so:
curl -u "username:password" https://your-instance.cloud.guardicore.com/api/v3.0/visibilityPrü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:
- Prüfen Sie, ob der API-Schlüssel und der geheime Schlüssel korrekt sind.
- Prüfen Sie, ob die Google SecOps-Endpunkt-URL für Ihre Region korrekt ist.
Prüfen Sie die ausgehende HTTPS-Verbindung vom ULS-Server:
curl -I https://malachiteingestion-pa.googleapis.comPrü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:
- Prüfen Sie unter Einstellungen > Datenverwaltung > Feeds, ob der Webhook-Feed den Status Aktiv hat.
- Prüfen Sie den Tab Zustand des Feeds auf Aufnahmefehler.
- Prüfen Sie, ob das Trennzeichen in der Feedkonfiguration auf
\nfestgelegt ist. - 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
--httpinsecurehinzu: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