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. |
Connector-Regeln
Proxyunterstützung
Der Connector unterstützt keinen Proxy.
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten