LevelBlue USM Anywhere in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie LevelBlue USM Anywhere in Google Security Operations einbinden.

Anwendungsfälle

Die LevelBlue USM Anywhere-Integration verwendet Google SecOps-Funktionen, um die folgenden Anwendungsfälle zu unterstützen:

  • Automatisierte Triage von Sicherheitsalarmen: Priorisierte Sicherheitsalarme und die zugehörigen Ereignisse aus LevelBlue USM Anywhere werden in Google SecOps-Fälle aufgenommen, während unterdrückte oder weniger wichtige Erkennungen herausgefiltert werden.

  • Schnelle Untersuchung des Alarmkontexts: Rufen Sie vollständige Metadaten für einen bestimmten LevelBlue USM Anywhere-Alarm (einschließlich Prioritätsbewertung, Quell- und Ziel-Assets, geografischem Kontext und Unterdrückungsstatus) direkt auf der Case Wall ab.

  • Gezielte Suche nach historischen Ereignissen: Fragen Sie historische Sicherheitsereignisse nach Kontoname, Quell-Asset, Ereignisname und Datumsfenster während automatisierter oder manueller Untersuchungen ab, um den Umfang verdächtiger Aktivitäten zu bestimmen.

Hinweis

Bevor Sie die LevelBlue USM Anywhere-Integration in Google SecOps konfigurieren, müssen Sie prüfen, ob Ihre Umgebung die folgenden Anforderungen erfüllt:

  • Netzwerkverbindung: Achten Sie darauf, dass Google SecOps (oder ein bereitgestellter Remote-Agent für private oder lokale Netzwerke) Ihre LevelBlue USM Anywhere-Cloud-Instanz über HTTPS auf TCP-Port 443 erreichen kann.

  • Authentifizierungsdaten und Versionsauswahl: Bestätigen Sie, welche LevelBlue USM Anywhere-Authentifizierungsversion Ihre Umgebung verwendet. Version V2 (empfohlen) verwendet eine OAuth 2.0-Client-ID und einen Clientschlüssel und ist erforderlich, um die Aktionen Get Alarm Details und List Events auszuführen. Die Legacy-Version V1 verwendet einen Standardnutzernamen und ein Standardpasswort und unterstützt nur die Verbindungsvalidierung und die Aufnahme von Legacy-Alarmen.

  • Nutzerberechtigungen nach dem Prinzip der geringsten Berechtigung: Konfigurieren Sie ein dediziertes LevelBlue USM Anywhere-Dienstkonto mit den Mindestberechtigungen, die für die in Ihren Workflows verwendeten Aktionen und Connectors erforderlich sind, wie in der folgenden Tabelle beschrieben:

    Komponente Erforderliche LevelBlue USM Anywhere-Berechtigungen
    Get Alarm Details Analyst oder benutzerdefinierte Rolle mit Lesezugriff und Berechtigung zum Generieren von OAuth 2.0-Anmeldedaten und zum Aufrufen von Alarmeinträgen und zugehörigen Ereignissen.
    List Events Analystenrolle oder benutzerdefinierte Rolle mit Lesezugriff und Berechtigung zum Generieren von OAuth 2.0-Anmeldedaten und zum Suchen in historischen Sicherheitshinweis-Datensätzen.
    Ping Gültige Nutzerkonto-Anmeldedaten, die zur Authentifizierung und zum Lesen des grundlegenden Umgebungsstatus in LevelBlue USM Anywhere verwendet werden können.
    AlienVault USM Anywhere Connector Analysten- oder benutzerdefinierte Rolle mit Lesezugriff und der Berechtigung, Sicherheitsalarme, Alarmmetadaten und Details zu korrelierten Ereignissen abzufragen.

Weitere Informationen zum Konfigurieren von Rollen und zum Generieren von OAuth 2.0-Clientanmeldedaten finden Sie in der offiziellen LevelBlue USM Anywhere-Dokumentation und in der Get OAuth Token API-Referenz.

Integrationsparameter

Für die LevelBlue USM Anywhere-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Api Root

Erforderlich.

Die Basis-URL des LevelBlue USM Anywhere-Servers, formatiert als https://SUBDOMAIN.alienvault.cloud.

ClientID

Erforderlich.

Die OAuth 2.0-Client-ID, die mit Ihrem LevelBlue USM Anywhere-Dienstkonto verknüpft ist, wenn Product Version auf V2 gesetzt ist.

Wenn Product Version auf V1 gesetzt ist, geben Sie stattdessen in diesem Feld den Nutzernamen Ihres LevelBlue USM Anywhere-Kontos an.

Secret

Erforderlich.

Der OAuth 2.0-Clientschlüssel, der Ihrem LevelBlue USM Anywhere-Dienstkonto zugeordnet ist, wenn Product Version auf V2 gesetzt ist.

Wenn Product Version auf V1 gesetzt ist, geben Sie stattdessen in diesem Feld das Passwort für Ihr LevelBlue USM Anywhere-Konto ein.

Product Version

Erforderlich.

Die zu verwendende LevelBlue USM Anywhere-Authentifizierungsversion.

Wenn Sie die Aktionen Weckerdetails abrufen und Ereignisse auflisten verwenden möchten, muss dieser Parameter auf V2 festgelegt werden.

Folgende Werte sind möglich:

  • V1
  • V2

Der Standardwert ist V2.

Use SSL

Erforderlich.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum LevelBlue USM Anywhere-Server hergestellt wird.

Standardmäßig aktiviert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in Ihrem Fall ausführen.

Alarmdetails abrufen

Mit der Aktion Alarmdetails abrufen können Sie umfassende Metadaten für einen bestimmten LevelBlue USM Anywhere-Alarm abrufen (einschließlich Priorität, Regelabsicht, Angriffsstrategie, Methode, Quell- und Zieldetails sowie Unterdrückungsstatus) und auf der Fallpinnwand anzeigen lassen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Weckerdetails abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Alarm ID

Erforderlich.

Die eindeutige Kennung des zu untersuchenden LevelBlue USM Anywhere-Alarms.

In Playbooks, die vom AlienVault USM Anywhere Connector ausgelöst werden, können Sie die Kennung des Benachrichtigungstickets direkt diesem Parameter zuordnen.

Aktionsausgaben

Die Aktion Get Alarm Details liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle im Fall-Repository Verfügbar
Tabelle mit Entitätsanreicherungen Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle im Fall-Repository

Die Aktion Alarmdetails abrufen stellt die folgende Tabelle auf der Fallpinnwand bereit:

  • Tabellenname: Alarm <var class="prettyprint readonly">ALARM_ID</var> Details
  • Spalten:
    • ID
    • Priorität
    • Prioritätslabel
    • Zeitpunkt des Auftretens
    • Empfangszeit
    • Regelabsicht
    • Regelstrategie
    • Regelmethode
    • Name der Quelle
    • Quellorganisation
    • Ursprungsland
    • Name des Ziels
    • Zielorganisation
    • Zielland
    • Wird unterdrückt
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Alarmdetails abrufen empfangen wird:

{
  "uuid": "5e2ee325-7a04-b082-0842-d06a14552f59",
  "status": "open",
  "priority": 36,
  "priority_label": "medium",
  "muted": false,
  "suppressed": false,
  "timestamp_occured": 1580131109000,
  "timestamp_received": 1580131109248,
  "rule_intent": "Environmental Awareness",
  "rule_strategy": "Windows Event Created",
  "rule_method": "Windows Audit Log Cleared",
  "source_name": "192.0.2.10",
  "source_username": "example_user",
  "destination_name": "198.51.100.20",
  "sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
  "events_count": 1,
  "has_alarm": true
}
Ausgabenachrichten

Die Aktion Weckerdetails abrufen liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully returned details about alarm ALARM_ID.

Die Aktion war erfolgreich.

Failed to get alarm details. Error is ERROR_REASON.

Die Aktion ist fehlgeschlagen.

Prüfen Sie, ob die angegebene Alarm ID mit einem vorhandenen Alarm in LevelBlue USM Anywhere übereinstimmt und ob Ihre OAuth 2.0-Anmeldedaten Lesezugriff auf Alarme haben.

This action is not supported for AlienVault Anywhere V1 integration. Please use V2.

Die Aktion ist fehlgeschlagen.

Öffnen Sie die Integrationskonfiguration in Google SecOps, ändern Sie Product Version in V2 und geben Sie gültige OAuth 2.0-Anmeldedaten für ClientID und Secret an.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Alarm Details verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Ereignisse auflisten

Mit der Aktion Ereignisse auflisten können Sie in LevelBlue USM Anywhere nach historischen Sicherheitsereignissen suchen. Sie können nach Kontoname, Ereignisname, Quell-Asset, Datumsfenster oder Unterdrückungsstatus suchen und die entsprechenden Ereignisse auf der Case Wall anzeigen lassen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Ereignisse auflisten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Account Name

Optional.

Der Name des LevelBlue USM Anywhere-Kontos, das mit den zu suchenden Sicherheitsereignissen verknüpft ist.

Event Name

Optional.

Der vollständige oder teilweise Name des Sicherheitsereignisses, nach dem gesucht werden soll, z. B. Kerberos service ticket was requested.

Source Name

Optional.

Der Hostname oder die IP-Adresse des Quell-Assets, das die Sicherheitsereignisse generiert hat.

Start Time

Optional.

Das Startdatum des Suchzeitraums für Ereignisse im Format DD/MM/YYYY.

End Time

Optional.

Das Enddatum des Suchbereichs für Ereignisse, formatiert als DD/MM/YYYY.

Suppressed

Optional.

Wenn diese Option ausgewählt ist, umfasst die Aktion Ereignisse, die in LevelBlue USM Anywhere als unterdrückt markiert sind, oder stimmt mit diesen überein.

Events Limit

Optional.

Die maximale Anzahl der übereinstimmenden Sicherheitsereignisse, die zurückgegeben werden sollen.

Der Standardwert ist 100.

Aktionsausgaben

Die Aktion Ereignisse auflisten liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle im Fall-Repository Verfügbar
Tabelle mit Entitätsanreicherungen Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle im Fall-Repository

Die Aktion Ereignisse auflisten stellt die folgende Tabelle auf der Fallpinnwand bereit:

  • Tabellenname: Alien Vault Anywhere Events
  • Spalten:
    • ID
    • Zeitpunkt des Auftretens
    • Empfangszeit
    • Unterkategorie
    • Access Control Outcome
    • Schweregrad des Ereignisses
    • Quellport
    • Name der Quelle
    • Zielport
    • Name des Ziels
    • Wecker gestellt
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Ereignisse auflisten empfangen wird:

[
  {
    "access_control_outcome": "OK",
    "destination_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "destination_name": "EC2AMAZ-44A6GL4",
    "destination_port": "49707",
    "destination_username": "EC2AMAZ-44A6GL4$",
    "event_category": "Access & Authentication",
    "event_name": "Kerberos service ticket was requested",
    "event_severity": "INFO",
    "event_subcategory": "Authentication",
    "has_alarm": false,
    "id": "e489d3b0-bb09-8696-e235-23da207dc9b1",
    "log": "{\"winlogbeat\":{\"record_number\":\"2369959\",\"event_id\":4769}}",
    "packet_type": "log",
    "plugin": "AlienVault NIDS",
    "plugin_device": "AlienVault Sensor",
    "plugin_device_type": "Intrusion Detection",
    "plugin_rule": "4769 - A Kerberos service ticket was requested.",
    "plugin_version": "-",
    "rep_device_address": "192.0.2.15",
    "rep_device_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "rep_device_hostname": "EC2AMAZ-44A6GL4",
    "rep_device_rule_id": "4769",
    "sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
    "source_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "source_name": "EC2AMAZ-44A6GL4",
    "source_port": "49707",
    "source_process": "C:\\Windows\\System32\\lsass.exe",
    "source_userid": "S-1-5-18",
    "source_username": "example_user",
    "suppressed": false,
    "tag_names": [],
    "timestamp_occured": 1579772348000,
    "timestamp_received": 1579772350000,
    "used_hint": false,
    "was_fuzzied": false,
    "links": {
      "self": {
        "href": "https://example.alienvault.cloud/api/2.0/events/e489d3b0-bb09-8696-e235-23da207dc9b1"
      }
    }
  }
]
Ausgabenachrichten

Die Aktion Ereignisse auflisten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully returned EVENTS_COUNT AlienVault Anywhere events

Die Aktion war erfolgreich.

Failed to list Alien Vault Anywhere events! Error is ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie, ob Ihr LevelBlue USM Anywhere-Server erreichbar ist, ob Ihre OAuth 2.0-Anmeldedaten aktiv sind und ob die Filterwerte mit gültigen Konto- oder Quellnamen übereinstimmen.

Unable to parse start time START_TIME. Valid format is DD/MM/YYYY.

Die Aktion ist fehlgeschlagen.

Aktualisieren Sie den Parameter Start Time, sodass der Tag zuerst angezeigt wird, gefolgt vom zweistelligen Monat und dem vierstelligen Jahr (z. B. 22/04/2026).

Unable to parse end time END_TIME. Valid format is DD/MM/YYYY.

Die Aktion ist fehlgeschlagen.

Aktualisieren Sie den Parameter End Time, sodass zuerst der Tag, dann der zweistellige Monat und schließlich das vierstellige Jahr angezeigt wird (z. B. 29/04/2026).

This action is not supported for AlienVault Anywhere V1 integration. Please use V2.

Die Aktion ist fehlgeschlagen.

Öffnen Sie die Integrationskonfiguration in Google SecOps, ändern Sie Product Version in V2 und konfigurieren Sie gültige OAuth 2.0-Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Ereignisse auflisten verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zu testen und zu prüfen, ob sich Ihre konfigurierten Anmeldedaten beim LevelBlue USM Anywhere-Server authentifizieren können.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Tabelle mit Entitätsanreicherungen Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Ausgabenachrichten

Die Aktion Ping liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Connected successfully.

Die Aktion war erfolgreich.

Failed to connect to the AlienVaultAnywhere! Error is ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie, ob die URL API Root korrekt ist, ob ausgehender HTTPS-Traffic über den TCP-Port 443 zulässig ist und ob die Werte für ClientID und Secret gültig sind.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Ping verwendet wird:

Name des Skriptergebnisses Wert
success true oder false

Connectors

Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).

AlienVault USM Anywhere-Connector

Mit dem Connector AlienVault USM Anywhere Connector können Sie Sicherheitsalarme und die zugehörigen Ereignisse aus LevelBlue USM Anywhere in Google SecOps-Benachrichtigungen und ‑Fälle aufnehmen.

Weitere Informationen zu Endpunkten für die Alarmabfrage und Filterparametern findest du in der API-Referenz zum Abrufen einer Seite mit Alarmen.

Connector-Eingaben

Für den Connector AlienVault USM Anywhere Connector sind die folgenden Parameter erforderlich:

Parameter Beschreibung
DeviceProductField

Erforderlich.

Der Name des Ereignisfelds, das zum Ausfüllen des Produktattributs des Geräts in Google SecOps-Benachrichtigungen verwendet wird.

Der Standardwert ist device_product.

EventClassId

Optional.

Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt.

Der Standardwert ist message_plugin.

PythonProcessTimeout

Erforderlich.

Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt.

Der Standardwert ist 60.

Api Root

Erforderlich.

Die Basis-URL des LevelBlue USM Anywhere-Servers, formatiert als https://SUBDOMAIN.alienvault.cloud.

ClientID

Erforderlich.

Die OAuth 2.0-Client-ID für Ihr LevelBlue USM Anywhere-Dienstkonto, wenn Product Version auf V2 gesetzt ist, oder Ihr Kontonutzername, wenn Product Version auf V1 gesetzt ist.

Secret

Erforderlich.

Der OAuth 2.0-Clientschlüssel für Ihr LevelBlue USM Anywhere-Dienstkonto, wenn Product Version auf V2 gesetzt ist, oder Ihr Kontopasswort, wenn Product Version auf V1 gesetzt ist.

Product Version

Erforderlich.

Die LevelBlue USM Anywhere-Authentifizierungsversion, die während der Alarmaufnahme verwendet werden soll.

Folgende Werte sind möglich:

  • V1
  • V2

Der Standardwert ist V2.

Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum LevelBlue USM Anywhere-Server hergestellt wird.

Max Alerts Per Cycle

Erforderlich.

Die maximale Anzahl von Alarmen, die bei jeder Connector-Ausführung aufgenommen werden sollen.

Der Standardwert ist 10.

Max Days Backwards

Erforderlich.

Die Anzahl der Tage vor der ersten Connector-Ausführung, ab der Alarme abgerufen werden sollen.

Dieser Parameter kann für die erste Connector-Iteration gelten, nachdem Sie den Connector zum ersten Mal aktiviert haben, oder für den Fallback-Wert für einen abgelaufenen Connector-Zeitstempel.

Der Standardwert ist 1.

Padding Period

Optional.

Der Lookback-Zwischenspeicher in Stunden (von 0 bis 12), der bei der Abfrage neuer Alarme von der aktuellen Zeit abgezogen wird. Konfigurieren Sie diese Einstellung, wenn bei Sensoren die Logübermittlung an LevelBlue USM Anywhere verzögert ist. Werte außerhalb des Bereichs von 0 bis 12 werden auf 0 zurückgesetzt.

Der Standardwert ist 0.

Show Suppressed

Optional.

Wenn diese Option ausgewählt ist, während Use Suppressed Filter aktiviert ist, werden nur unterdrückte Alarme aufgenommen. Wenn die Option nicht ausgewählt ist, während Use Suppressed Filter aktiviert ist, werden nur nicht unterdrückte Alarme aufgenommen.

Use Suppressed Filter

Optional.

Wenn diese Option ausgewählt ist, filtert der Connector Alarme anhand der Einstellung Show Suppressed:

  • Alle Alarme (unterdrückte und nicht unterdrückte) aufnehmen: Löschen Sie Use Suppressed Filter.
  • Nur nicht unterdrückte Alarme aufnehmen: Wählen Sie Use Suppressed Filter aus und löschen Sie Show Suppressed.
  • Nur unterdrückte Alarme aufnehmen: Wählen Sie sowohl Use Suppressed Filter als auch Show Suppressed aus.

Weitere Informationen zur Alarmunterdrückung in LevelBlue USM Anywhere finden Sie unter Unterdrückungsregeln auf der Seite „Orchestrierungsregeln“.

Priority

Optional.

Eine durch Kommas getrennte Liste der Alarmprioritätsstufen, die aufgenommen werden sollen (z. B. high,medium). Wenn Sie Alarme aller Prioritäten aufnehmen möchten, lassen Sie dieses Feld leer.

Folgende Werte sind möglich:

  • high
  • medium
  • low
Rule Intent

Optional.

Aufgenommene Alarme nach Bedrohungsabsichtskategorie filtern.

Folgende Werte sind möglich:

  • System Compromise
  • Exploitation & Installation
  • Delivery & Attack
  • Reconnaissance & Probing
  • Environmental Awareness
Rule Strategy

Optional.

Filtern Sie aufgenommene Alarme nach der Angriffsstrategie, die die Erkennungsregel ausgelöst hat (z. B. Client-Side Attack - Known Vulnerability).

Rule Method

Optional.

Filtern Sie aufgenommene Alarme nach der spezifischen Erkennungsmethode oder Regelsignatur (z. B. Windows Audit Log Cleared).

Proxy Server Address

Optional.

Die Adresse des zu verwendenden Proxyservers.

Proxy Username

Optional.

Der Proxy-Nutzername für die Authentifizierung.

Proxy Password

Optional.

Das Proxy-Passwort für die Authentifizierung.

Connector-Regeln

  • Der Connector unterstützt Proxys.

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