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
443erreichen 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-VersionV1verwendet 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 DetailsAnalyst 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 EventsAnalystenrolle oder benutzerdefinierte Rolle mit Lesezugriff und Berechtigung zum Generieren von OAuth 2.0-Anmeldedaten und zum Suchen in historischen Sicherheitshinweis-Datensätzen. PingGültige Nutzerkonto-Anmeldedaten, die zur Authentifizierung und zum Lesen des grundlegenden Umgebungsstatus in LevelBlue USM Anywhere verwendet werden können. AlienVault USM Anywhere ConnectorAnalysten- 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 |
ClientID |
Erforderlich. Die OAuth 2.0-Client-ID, die mit Ihrem LevelBlue USM Anywhere-Dienstkonto verknüpft ist, wenn Wenn |
Secret |
Erforderlich. Der OAuth 2.0-Clientschlüssel, der Ihrem LevelBlue USM Anywhere-Dienstkonto zugeordnet ist, wenn Wenn |
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 Folgende Werte sind möglich:
Der Standardwert ist |
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 |
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 |
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. |
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 |
End Time |
Optional. Das Enddatum des Suchbereichs für Ereignisse, formatiert als |
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 |
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 |
Unable to parse end time
END_TIME. Valid format is
DD/MM/YYYY. |
Die Aktion ist fehlgeschlagen. Aktualisieren Sie den Parameter |
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 |
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 |
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 |
EventClassId |
Optional. Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt. Der Standardwert ist |
PythonProcessTimeout |
Erforderlich. Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert ist |
Api Root |
Erforderlich. Die Basis-URL des LevelBlue USM Anywhere-Servers, formatiert als |
ClientID |
Erforderlich. Die OAuth 2.0-Client-ID für Ihr LevelBlue USM Anywhere-Dienstkonto, wenn |
Secret |
Erforderlich. Der OAuth 2.0-Clientschlüssel für Ihr LevelBlue USM Anywhere-Dienstkonto, wenn |
Product Version |
Erforderlich. Die LevelBlue USM Anywhere-Authentifizierungsversion, die während der Alarmaufnahme verwendet werden soll. Folgende Werte sind möglich:
Der Standardwert ist |
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 |
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 |
Padding Period |
Optional. Der Lookback-Zwischenspeicher in Stunden (von Der Standardwert ist |
Show Suppressed |
Optional. Wenn diese Option ausgewählt ist, während |
Use Suppressed Filter |
Optional. Wenn diese Option ausgewählt ist, filtert der Connector Alarme anhand der Einstellung
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. Folgende Werte sind möglich:
|
Rule Intent |
Optional. Aufgenommene Alarme nach Bedrohungsabsichtskategorie filtern. Folgende Werte sind möglich:
|
Rule Strategy |
Optional. Filtern Sie aufgenommene Alarme nach der Angriffsstrategie, die die Erkennungsregel ausgelöst hat (z. B. |
Rule Method |
Optional. Filtern Sie aufgenommene Alarme nach der spezifischen Erkennungsmethode oder Regelsignatur (z. B. |
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