CSV in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie CSV in Google Security Operations einbinden.

In diesem Dokument wird beschrieben, wie Sie CSV in Google Security Operations einbinden.

Anwendungsfälle

In Google SecOps unterstützt die CSV-Integration die folgenden Anwendungsfälle:

  • Dateibasierte Bedrohungssuche: Suchen Sie schnell in lokalen oder Remote-CSV-Logdateien nach bestimmten Strings oder schädlichen Entitäten, um Bedrohungen zu identifizieren, die in der Vergangenheit protokolliert wurden.

  • Automatisierte Benachrichtigungsgenerierung: Datensätze aus Legacy-Systemen, die Daten im CSV-Format ausgeben, werden automatisch aufgenommen und in umsetzbare Benachrichtigungen mit benutzerdefinierter Zuordnung des Schweregrads umgewandelt.

  • Datenübertragbarkeit und Berichterstellung: JSON-Ergebnisse aus anderen Playbook-Aktionen programmatisch in das CSV-Format umwandeln, um sie optimiert in externe Berichtstools oder lokalen Speicher zu exportieren.

  • Automatisierte Entitätsanreicherung: Verwenden Sie CSV-Dateien als lokale Threat Intelligence-Quelle, um Entitäten automatisch anzureichern und während der Playbook-Ausführung als verdächtig zu markieren.

  • Systemübergreifende Datensynchronisierung: Verarbeiten Sie Dateien mit unterschiedlichen Zeichencodierungen, z. B. ältere Excel-Formate, effizient, um die Datenkonsistenz über verschiedene Sicherheitstools hinweg zu gewährleisten.

Hinweis

Bevor Sie die Integration in Google SecOps konfigurieren, prüfen Sie, ob Folgendes vorhanden ist:

  • Interne Plattformfunktionen: Diese Integration bietet integrierte Funktionen zur Dateiverarbeitung und erfordert keine externen API-Schlüssel oder Anmeldedaten von Drittanbietern für die Authentifizierung.

  • Dateisystemberechtigungen: Wenn ein Remote-Agent verwendet wird, sind für die Integration bestimmte Berechtigungen erforderlich, um auf Dateien auf dem Hostsystem zuzugreifen und sie zu verwalten. Führen Sie den folgenden Befehl auf dem Agent-Computer aus, um die erforderlichen Berechtigungen für das Zielverzeichnis zu gewähren: chown scripting:scripting "directory_path"

Integrationsparameter

Für die CSV-Integration sind die folgenden Parameter erforderlich:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanzname String – Nein Name der Instanz, für die Sie die Integration konfigurieren möchten.
Beschreibung String – Nein Beschreibung der Instanz.
Remote ausführen Kästchen Deaktiviert Nein Setzen Sie ein Häkchen, um die konfigurierte Integration remote auszuführen. Nachdem Sie das Häkchen gesetzt haben, wird die Option zum Auswählen des Remote-Nutzers (Agenten) angezeigt.

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 einem Fall ausführen.

JSON als CSV speichern

JSON-Objekt als CSV-Datei speichern

Parameter

Parametername Typ Standardwert Erforderlich Beschreibung
JSON-Objekt JSON – Ja Gibt das JSON-Objekt an, das als CSV-Datei gespeichert werden soll.
Überschreiben Boolesch Falsch Nein Wenn diese Option aktiviert ist, wird die vorhandene Datei durch die Aktion überschrieben.
Dateipfad String – Ja Gibt den absoluten Dateipfad für die neu erstellte CSV-Datei an. Wenn nur der Dateiname angegeben wird, speichert die Aktion die Datei in einem /tmp/-Ordner.

Ausführen am

–

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
{"filepath": "{file name}"}
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Das JSON-Objekt wurde erfolgreich transformiert und im angegebenen Dateipfad gespeichert. Die Aktion war erfolgreich.
Die Datei wurde im angegebenen Pfad nicht gefunden. Die Datei ist nicht vorhanden.
In Google Cloud Policy Intelligence wurden keine Aktivitäten für die angegebenen Dienstkonten gefunden Die Aktion konnte für keines der aufgeführten Dienstkonten Daten finden.
Fehler beim Ausführen der Aktion „JSON als CSV speichern“.

Die Aktion hat einen Fehler zurückgegeben.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Nach String suchen

Nach Strings in CSV-Dateien suchen.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
CSV-Pfad String – Ja Geben Sie den Dateipfad zur CSV-Datei oder einen Ordnerpfad an, der alle CSV-Dateien enthält. Wenn ein Ordner angegeben wird, wird die Aktion für alle CSV-Dateien im Ordner ausgeführt.
CSV-Spalte String – Nein Geben Sie eine durch Kommas getrennte Liste von Spalten an, die Entitätsinformationen enthalten können. Wenn nichts angegeben ist, wird in allen Spalten gesucht.
Tage zurück String 10 Nein Geben Sie an, wie viele Tage rückwirkend die CSV-Dateien verarbeitet werden sollen.
Wert suchen String – Nein Geben Sie einen String an, nach dem gesucht werden soll. Wenn „Search Multiple String“ aktiviert ist, wird dieser Parameter als durch Kommas getrennte Liste von Strings behandelt, die durchsucht werden müssen.
Nur die erste Zeile zurückgeben. Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, gibt die Aktion nur eine Zeile in der ersten Datei zurück, die mit der Entität übereinstimmt.
Dateicodierungstypen String utf-8, latin-1, iso-8859-1 Ja Eine durch Kommas getrennte Liste von CSV-Codierungstypen, die zum Decodieren Ihrer CSV-Dateien verwendet werden, z.B. utf-8, latin-1, iso-8859-1, utf-16... Die Reihenfolge, in der die Codierungstypen angegeben werden, bestimmt die Reihenfolge, in der sie zum Decodieren von Dateien verwendet werden. Im obigen Beispiel hat utf-8 die höchste Priorität und wird hauptsächlich zum Decodieren aller Dateien verwendet. Wenn eine CSV-Datei eine andere Codierung verwendet, wird die nächste in der Reihenfolge verwendet: latin-1-Codierung usw., bis die letzte Codierung verwendet wird.
Nach mehreren Strings suchen Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, wird „Suchwert“ als durch Kommas getrennte Liste von Werten und nicht als einzelner String verwendet.
Zurückzugebende Felder CSV – Nein Geben Sie eine durch Kommas getrennte Liste der Werte an, die zurückgegeben werden sollen.

Anwendungsfälle

Nach Strings in CSV-Dateien suchen.

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
count_rows_csv Beliebige Anzahl von Zeilen count_rows += 1
JSON-Ergebnis
[
    {
        "EntityResult": {
            "Field2": "Value2",
            "Field3": "Value3",
            "Field1": "Value1",
            "Field4": "Value4",
            "Field5": "Value5"
        },
        "Entity": "host"
    }, {
        "EntityResult": {
            "Field2": "Value2",
            "Field3": "Value3",
            "Field1": "Value1",
            "Field4": "Value4",
            "Field5": "Value5"
        }, "Entity": "1.1.1.1"
    }
]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Für gefundene Einträge: „Informationen zu den folgenden Strings wurden gefunden: \n (search_string)“

Wenn für einige Strings keine Einträge gefunden werden: „Die Aktion konnte keine Informationen zu den folgenden Strings finden:“

Wenn für keinen Eintrag Informationen gefunden wurden:„Für die angegebenen Elemente wurden keine Informationen gefunden.“

Wenn alle Codierungen ungültig sind: Fehler beim Ausführen der Aktion „CSV-Suche nach String“. Die angegebenen Codierungen sind ungültig. Bitte überprüfen Sie die Schreibweise.“

Allgemein

Nach Entität suchen

In CSV-Dateien nach Entitäten suchen und diese anreichern.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
CSV-Pfad String – Ja Geben Sie den Dateipfad zur CSV-Datei oder einen Ordnerpfad an, der alle CSV-Dateien enthält. Wenn ein Ordner angegeben wird, wird die Aktion für alle CSV-Dateien im Ordner ausgeführt.
CSV-Spalte String – Ja Geben Sie eine durch Kommas getrennte Liste von Spalten an, die Entitätsinformationen enthalten können. Wenn nichts angegeben ist, wird in allen Spalten gesucht.
Tage zurück String 10 Ja Geben Sie an, wie viele Tage rückwirkend die CSV-Dateien verarbeitet werden sollen.
Als verdächtig markieren Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, wird die Entität als verdächtig markiert, wenn sie in der Datei gefunden wurde.
Nur die erste Zeile zurückgeben. Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, gibt die Aktion nur eine Zeile in der ersten Datei zurück, die mit der Entität übereinstimmt.
Dateicodierungstypen String utf-8, latin-1, iso-8859-1 Ja Eine durch Kommas getrennte Liste von CSV-Codierungstypen, die zum Decodieren Ihrer CSV-Dateien verwendet werden, z.B. utf-8, latin-1, iso-8859-1, utf-16... Die Reihenfolge, in der die Codierungstypen angegeben werden, bestimmt die Reihenfolge, in der sie zum Decodieren von Dateien verwendet werden. Im obigen Beispiel hat utf-8 die höchste Priorität und wird hauptsächlich zum Decodieren aller Dateien verwendet. Wenn eine CSV-Datei eine andere Codierung verwendet, wird die nächste in der Reihenfolge verwendet: latin-1-Codierung usw., bis die letzte Codierung verwendet wird.
Entitäten anreichern Kästchen Aktiviert Nein Wenn diese Option aktiviert ist, werden Informationen aus der CSV-Datei hinzugefügt und in die Anreicherungstabelle der Entität eingefügt.
Insight erstellen Kästchen Aktiviert Nein Wenn diese Option aktiviert ist, wird durch die Aktion eine Statistik erstellt, falls die Entität in der Datei gefunden wurde.
Zurückzugebende Felder CSV – Nein Geben Sie eine durch Kommas getrennte Liste der Werte an, die zurückgegeben werden sollen.

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
count_rows_csv Beliebige Anzahl von Zeilen count_rows += 1
JSON-Ergebnis
[
    {
        "EntityResult": [{
            "domain": "example.dom",
            "fileHash": "cbbc5aea3d4c7ec193aa2ff3b52df36ebb12338b18c9bb53fc4896115efaf78d",
            "reporter": "Symantec Antivirus",
            "app": "Arcsight",
            "id": "1011",
            "eventTime": "9/4/2017 10:00",
            "antivirusAction": "blocked",
            "virusName": "ECAT",
            "rule": "malicious",
            "eventName": "Virus detected",
            "User": "Ziv",
            "eventHostName": "WS-ZivDevComp",
            "File Source Path": "C:\\\\Users\\\\Default\\\\Desktop\\\\stringTimeRaw.csv",
            "machineAddress": "192.168.11.11"
        }, {
            "domain": "SmartCompany.dom",
            "fileHash": "cbbc5aea3d4c7ec193aa2ff3b52df36ebb12338b18c9bb53fc4896115efaf78d",
            "reporter": "Symantec Antivirus",
            "app": "ESM",
            "id": "1012",
            "eventTime": "9/4/2017 10:00",
            "antivirusAction": "allowed",
            "virusName": "ECAT",
            "rule": "malicious",
            "eventName": "Virus detected",
            "User": "GG",
            "eventHostName": "WS-GGDevComp",
            "File Source Path": "C:\\\\Users\\\\Default\\\\Desktop\\\\stringTimeRaw.csv",
            "machineAddress": "192.168.11.11"
        }],
        "Entity": "192.168.11.11"
    }
]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Für gefundene Entitäten: "Informationen zu den folgenden Entitäten wurden gefunden: \n (entity.identifier)"

Für Entitäten, die nicht gefunden wurden: „Zu den folgenden Entitäten wurden keine Informationen gefunden: \n (entity.identifier)“

Wenn für keine Entität Informationen gefunden wurden: „Für die angegebenen Entitäten wurden keine Informationen gefunden.“

Wenn alle Codierungen ungültig sind: „Fehler beim Ausführen der Aktion ‚CSV-Suche nach String‘. Die angegebenen Codierungen sind ungültig. Bitte überprüfen Sie die Schreibweise.“

Allgemein

Ping

Verbindung testen

Parameter

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis

–

JSON-Ergebnis
N/A

Connectors

CSV-Connector

Daten aus CSV-Dateien in einem bestimmten Ordner abrufen und diese Daten in Benachrichtigungen im Google SecOps-System umwandeln.

In diesem Thema werden der Mechanismus und die Konfiguration beschrieben, mit denen Google SecOps CSV-Dateien erstellt, sowie die unterstützten Arbeitsabläufe und Aktionen, die auf der Plattform ausgeführt werden.

Anwendungsfälle

Ein Kunde hat CSV-Dateien aus einem System, die möglicherweise unterschiedliche Codierungen haben.

*   Add support for comma-separated encodings in the Encoding field in the
    connector.
    *   The connector should try the different encodings by their order in
        the field (first encoding - highest priority, last - lowest
        priority) with try/except. If no matching encoding was found -
        consider the file as an error and notify.
    *   Put a default value for the fields - a list of most common CSV
        encodings by priority (utf8, latin1, and iso...)

Zugriff auf CSV-Dateien

Google SecOps-Zugriff auf CSV-Dateien: Richten Sie einen Ordner für die CSV-Dateien ein.

CSV-Datensätze an Google SecOps weiterleiten

Mit CSV-Dateien arbeiten

Wenn Sie Google SecOps für die Verwendung von CSV-Dateien als Benachrichtigungsquelle konfigurieren, werden Sie aufgefordert, einen bestimmten Ordner anzugeben, aus dem die CSV-Dateien abgerufen werden sollen. Google SecOps ruft alle Datensätze in einer CSV-Datei ab und leitet sie zur Übersetzung und Kontextualisierung als Benachrichtigungen für Fälle weiter.

Schweregrad im Connector zuordnen

Um den Schweregrad zuzuordnen, müssen Sie im Parameter „Severity Field Name“ angeben, welches Feld verwendet werden soll, um den Wert für den Schweregrad abzurufen. In der Antwort können Sie drei Arten von Werten erhalten: Ganzzahlen, Gleitkommazahlen und Strings. Für Ganzzahlen und Gleitkommazahlen ist keine zusätzliche Konfiguration erforderlich. Der Connector liest diese Werte und ordnet sie gemäß den Google SecOps-Standards zu. Zur Erinnerung, wie Ganzzahlwerte zugeordnet werden:

  • 100 – Kritisch
  • 100 > x >= 80: Hoch
  • 80 > x >= 60 = Mittel
  • 60 > x >= 40 = Niedrig
  • 40 > x – Informativ

Wenn wir in der Antwort mit Strings arbeiten, ist eine zusätzliche Konfiguration erforderlich. Im Ordner mit den Connector-Skripts finden Sie eine Konfigurationsdatei mit dem Namen „severity_map_config.json“. In dieser Datei werden Zuordnungsregeln für den Schweregrad definiert.

Anfänglich sieht die Datei so aus: 1 2 3 { "Default": 50 }

Stellen Sie sich eine Situation vor, in der sich die erforderlichen Werte in „event.severity“ befinden. „event.severity“ kann die folgenden Werte enthalten: „Malicious“, „Benign“, „Unknown“.

Zuerst müssen wir im Parameter „Severity Field Name“ angeben, dass wir „event.severity“ verwenden. Zweitens müssen wir die Konfigurationsdatei aktualisieren. Nach den Änderungen sollte die Datei „severity_map_config.json“ so aussehen: 1 2 3 4 5 6 7 8 { "event.severity": { "Malicious": 100, "Unknown": 60, "Benign": -1 }, "Default": 50 }

Wenn der Connector jetzt ein Ereignis mit event.severity = „Malicious“ erhält, wird ihm der Schweregrad „Kritisch“ zugewiesen.

CSV-Connector in Google SecOps konfigurieren

Eine detaillierte Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.

Connector-Parameter

Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Produktfeldname String device_product Ja Der Feldname, der zur Bestimmung des Geräteprodukts verwendet wird.
Name des Ereignisfelds String Name Nein Der Feldname, der zur Bestimmung des Ereignisnamens (Untertyp) verwendet wird.
Zeitlimit für Script (Sekunden) String 60 Ja Das Zeitlimit (in Sekunden) für den Python-Prozess, der das aktuelle Script ausführt.
CSV-Ordnerpfad String – Ja Ordnerpfad, der alle CSV-Dateien enthält, die aufgenommen werden sollen.
CSV-Limit String – Nein Anzahl der CSV-Dateien, die pro Iteration verarbeitet werden sollen.
Feldname für Regelgenerator String – Nein Name des Felds, das Informationen zum Regelgenerator enthält.
Name des Zeitfelds String – Nein Name des Felds, das Informationen zur Ereigniszeit enthält.
CSV-Datei hat Header Kästchen Aktiviert Ja Gibt an, ob die CSV-Datei einen Header hat.
Dateicodierungstyp String utf-8 Ja Legen Sie den CSV-Codierungstyp fest, z.B. iso-8859-1, latin1, utf-8, utf-16.
Name des Benachrichtigungsfelds String – Nein Name des Felds, das Informationen zum Namen der Benachrichtigung enthält.
Feldname für Schweregrad String – Nein

Name des Felds, das Informationen zum Schweregrad enthält.
Hinweis: Sie können den Schweregrad anhand der Werte in der Antwort zuordnen. Dazu müssen Sie den Connector-Ausführungsordner aufrufen und die Datei „severity_mapping_config.json“ ändern. Weitere Informationen finden Sie in der Dokumentation.

Connector-Regeln

Proxyunterstützung

Der Connector unterstützt keinen Proxy.

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