Integra CSV con Google SecOps

Questo documento descrive come integrare CSV con Google Security Operations.

Questo documento spiega come integrare CSV con Google Security Operations.

Casi d'uso

In Google SecOps, l'integrazione CSV supporta i seguenti casi d'uso:

  • Ricerca delle minacce basata su file: cerca rapidamente stringhe specifiche o entità dannose nei file di log CSV locali o remoti per identificare le minacce registrate in precedenza.

  • Generazione automatica degli avvisi: importa automaticamente i record dai sistemi legacy che generano dati in formato CSV, convertendoli in avvisi utilizzabili con mappatura della gravità personalizzata.

  • Portabilità dei dati e generazione di report: trasforma in modo programmatico i risultati JSON di altre azioni del playbook in formato CSV per un'esportazione semplificata in strumenti di generazione di report esterni o spazio di archiviazione locale.

  • Arricchimento automatico delle entità: utilizza i file CSV come fonte di threat intelligence locale per arricchire automaticamente le entità e contrassegnarle come sospette durante l'esecuzione del playbook.

  • Sincronizzazione dei dati tra sistemi: elabora in modo efficiente i file con varie codifiche dei caratteri, come i formati Excel legacy, per garantire la coerenza dei dati tra strumenti di sicurezza diversi.

Prima di iniziare

Prima di configurare l'integrazione in Google SecOps, verifica di disporre di quanto segue:

  • Funzionalità della piattaforma interna: questa integrazione fornisce funzionalità di elaborazione dei file integrate e non richiede chiavi API o credenziali di terze parti esterne per l'autenticazione.

  • Autorizzazioni del file system: se viene utilizzato un agente remoto, l'integrazione richiede autorizzazioni specifiche per accedere ai file e gestirli sul sistema host. Esegui questo comando sulla macchina dell'agente per concedere le autorizzazioni necessarie per la directory di destinazione: chown scripting:scripting "directory_path"

Parametri di integrazione

L'integrazione CSV richiede i seguenti parametri:

Nome visualizzato del parametro Tipo Valore predefinito Obbligatorio Descrizione
Nome istanza Stringa N/D No Nome dell'istanza per cui intendi configurare l'integrazione.
Descrizione Stringa N/D No Descrizione dell'istanza.
Esegui da remoto Casella di controllo Deselezionata No Seleziona il campo per eseguire l'integrazione configurata da remoto. Una volta selezionata, viene visualizzata l'opzione per selezionare l'utente remoto (agente).

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Salva JSON in CSV

Salva un oggetto JSON in formato CSV.

Parametri

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Oggetto JSON JSON N/D Sì Specifica l'oggetto JSON da salvare come CSV.
Sovrascrivi Booleano Falso No Se questa opzione è attiva, l'azione sovrascrive il file esistente.
Percorso file Stringa N/D Sì Specifica il percorso file assoluto per il file CSV appena creato. Se viene fornito solo il nome file, l'azione archivia il file in una cartella /tmp/.

Esegui il

N/D

Risultati dell'azione

Risultato script
Nome del risultato dello script Valore
is_success Vero/Falso
Risultato JSON
{"filepath": "{file name}"}
Bacheca casi

L'azione fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
L'oggetto JSON è stato trasformato e salvato nel percorso file fornito. Azione completata.
Il file non è stato trovato nel percorso fornito. Il file non esiste.
Nessuna attività trovata per i service account forniti in Google Cloud Policy Intelligence L'azione non ha trovato dati per nessuno dei service account elencati.
Errore durante l'esecuzione dell'azione "Salva JSON in CSV".

L'azione ha restituito un errore.

Controlla la connessione al server, i parametri di input o le credenziali.

Cerca per stringa

Cerca stringhe nei file CSV.

Parametri

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Percorso CSV Stringa N/D Sì Specifica il percorso del file CSV o di una cartella che contiene tutti i file CSV. Se viene fornita una cartella, l'azione verrà ripetuta su tutti i file CSV al suo interno.
Colonna CSV Stringa N/D No Specifica un elenco separato da virgole di colonne che possono contenere informazioni sulle entità. Se non viene fornito alcun valore, l'azione eseguirà la ricerca in tutte le colonne.
Giorni indietro Stringa 10 No Specifica il numero di giorni precedenti per l'elaborazione dei file CSV.
Cerca valore Stringa N/D No Specifica una stringa da cercare. Se l'opzione "Cerca più stringhe" è attiva, questo parametro viene trattato come un elenco separato da virgole di stringhe da cercare.
Restituisci solo la prima riga. Casella di controllo Deselezionata No Se questa opzione è abilitata, l'azione restituirà solo una riga nel primo file corrispondente all'entità.
Tipi di codifica dei file Stringa utf-8, latin-1, iso-8859-1 Sì Un elenco separato da virgole di tipi di codifica CSV utilizzati per decodificare i file CSV, ad esempio utf-8, latin-1, iso-8859-1, utf-16… L'ordine in cui vengono forniti i tipi di codifica imposta l'ordine in cui vengono utilizzati per la decodifica dei file, ad esempio (dall'esempio precedente) utf-8 ha la priorità più alta e verrà utilizzato principalmente per la decodifica di tutti i file. Se esiste un file CSV che utilizza un'altra codifica, verrà utilizzato il tipo successivo nell'ordine, ovvero latin-1, e così via, fino all'ultima codifica.
Cerca più stringhe Casella di controllo Deselezionata No Se questa opzione è attiva, "Valore di ricerca" funzionerà come un elenco di valori separati da virgole, anziché come una singola stringa.
Campi da restituire CSV N/D No Specifica un elenco di valori separati da virgole che devono essere restituiti.

Casi d'uso

Cerca stringhe nei file CSV.

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Script Result Name Opzioni di valore Esempio
count_rows_csv Qualsiasi numero di righe count_rows += 1
Risultato JSON
[
    {
        "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"
    }
]
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

Per i record trovati: "Informazioni trovate correttamente sulle seguenti stringhe: \n (search_string)"

Se non vengono trovati record per alcune stringhe: "L'azione non è riuscita a trovare informazioni sulle seguenti stringhe:"

Se non viene trovato alcun record: "Non sono state trovate informazioni per gli elementi forniti."

Se tutte le codifiche non sono valide: "Errore durante l'esecuzione dell'azione "Ricerca CSV per stringa". Le codifiche fornite non sono valide. Controlla l'ortografia."

Generale

Cerca per entità

Cerca entità nei file CSV e arricchiscile.

Parametri

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Percorso CSV Stringa N/D Sì Specifica il percorso del file CSV o di una cartella che contiene tutti i file CSV. Se viene fornita una cartella, l'azione verrà ripetuta su tutti i file CSV al suo interno.
Colonna CSV Stringa N/D Sì Specifica un elenco separato da virgole di colonne che possono contenere informazioni sulle entità. Se non viene fornito alcun valore, l'azione eseguirà la ricerca in tutte le colonne.
Giorni precedenti Stringa 10 Sì Specifica quanti giorni indietro elaborare i file CSV.
Contrassegna come sospetto Casella di controllo Deselezionata No Se abilitata, l'azione contrassegnerà l'entità come sospetta, se è stata trovata nel file.
Restituisci solo la prima riga. Casella di controllo Deselezionata No Se questa opzione è abilitata, l'azione restituirà solo una riga nel primo file corrispondente all'entità.
Tipi di codifica dei file Stringa utf-8, latin-1, iso-8859-1 Sì Un elenco separato da virgole di tipi di codifica CSV utilizzati per decodificare i file CSV, ad esempio utf-8, latin-1, iso-8859-1, utf-16… L'ordine in cui vengono forniti i tipi di codifica imposta l'ordine in cui vengono utilizzati per la decodifica dei file, ad esempio (dall'esempio precedente) utf-8 ha la priorità più alta e verrà utilizzato principalmente per la decodifica di tutti i file. Se esiste un file CSV che utilizza un'altra codifica, verrà utilizzato il tipo successivo nell'ordine, ovvero latin-1, e così via, fino all'ultima codifica.
Arricchisci le entità Casella di controllo Selezionata No Se abilitata, l'azione aggiungerà le informazioni del file CSV alla tabella di arricchimento dell'entità.
Crea insight Casella di controllo Selezionata No Se l'opzione è attiva, l'azione creerà un insight se l'entità è stata trovata nel file.
Campi da restituire CSV N/D No Specifica un elenco di valori separati da virgole che devono essere restituiti.

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Script Result Name Opzioni di valore Esempio
count_rows_csv Qualsiasi numero di righe count_rows += 1
Risultato JSON
[
    {
        "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"
    }
]
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

Per le entità trovate: "Informazioni sulle seguenti entità trovate correttamente: \n (entity.identifier)"

Per le entità non trovate: "Non sono state trovate informazioni sulle seguenti entità: \n (entity.identifier)"

Se non viene trovato alcun risultato per ogni entità: "Non sono state trovate informazioni per le entità fornite."

Se tutte le codifiche non sono valide: "Errore durante l'esecuzione dell'azione "Ricerca CSV per stringa". Le codifiche fornite non sono valide. Controlla l'ortografia."

Generale

Dindin

Testa la connettività.

Parametri

N/D

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script

N/D

Risultato JSON
N/A

Connettori

Connettore CSV

Recuperare i dati dai file CSV che si trovano in una cartella specifica e convertirli in avvisi nel sistema Google SecOps.

Questo argomento illustra il meccanismo e la configurazione con cui Google SecOps produce file CSV, insieme ai flussi di lavoro supportati e alle azioni intraprese all'interno della piattaforma.

Casi d'uso

Un cliente ha file CSV provenienti da un sistema e i file potrebbero avere codifiche diverse.

*   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...)

Accesso ai file CSV

Accesso di Google SecOps ai file CSV: configura una cartella per i file CSV.

Inoltro di record CSV a Google SecOps

Utilizzare i record dei file CSV

Quando configuri Google SecOps per l'utilizzo di file CSV come origine degli avvisi, ti verrà chiesto di fornire una cartella specifica da cui recuperare i file CSV. Google SecOps recupererà tutti i record all'interno di un file CSV e li inoltrerà per la traduzione e la contestualizzazione come avvisi per i casi.

Come mappare la gravità nel connettore

Per mappare la gravità, devi specificare quale campo deve essere utilizzato per ottenere il valore della gravità nel parametro "Nome campo gravità". Nella risposta puoi ottenere tre tipi di valori: numeri interi, numeri in virgola mobile e stringhe. Per i numeri interi e i numeri con virgola mobile, non è necessaria alcuna configurazione aggiuntiva. Il connettore leggerà questi valori e li mapperà in base agli standard di Google SecOps. Ecco un breve riepilogo di come vengono mappati i valori interi:

  • 100 - Critico
  • 100 > x >= 80: alto
  • 80 > x >=60 Media
  • 60 > x >=40 Basso
  • 40 > x Informative

Se nella risposta lavoriamo con stringhe, è necessaria una configurazione aggiuntiva. Nella cartella in cui si trovano gli script del connettore, troverai un file di configurazione denominato severity_map_config.json. Questo file definisce le regole di mappatura per la gravità.

Inizialmente, il file avrà il seguente aspetto: 1 2 3 { "Default": 50 }

Immagina una situazione in cui i valori necessari si trovano in event.severity. event.severity può contenere i seguenti valori: "Malicious", "Benign", "Unknown".

Innanzitutto, dobbiamo specificare nel parametro "Severity Field Name" (Nome campo gravità) che utilizzeremo event.severity. In secondo luogo, dobbiamo aggiornare il file di configurazione. Dopo le modifiche, il file severity_map_config.json dovrebbe avere il seguente aspetto: 1 2 3 4 5 6 7 8 { "event.severity": { "Malicious": 100, "Unknown": 60, "Benign": -1 }, "Default": 50 }

Ora, quando il connettore riceverà un evento con event.severity = "Malicious", gli assegnerà la gravità Critica.

Configura il connettore CSV in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, consulta Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Nome del campo del prodotto Stringa device_product Sì Il nome del campo utilizzato per determinare il prodotto del dispositivo.
Nome campo evento Stringa nome No Il nome del campo utilizzato per determinare il nome evento (sottotipo).
Timeout dello script (secondi) Stringa 60 Sì Il limite di timeout (in secondi) per il processo Python che esegue lo script corrente.
Percorso cartella CSV Stringa N/D Sì Percorso della cartella che contiene tutti i file CSV da importare.
Limite CSV Stringa N/D No Il numero di file CSV da elaborare per un'iterazione.
Nome del campo del generatore di regole Stringa N/D No Nome del campo che contiene informazioni sul generatore di regole.
Nome campo temporale Stringa N/D No Nome del campo che contiene informazioni sull'ora dell'evento.
Il file CSV ha un'intestazione Casella di controllo Selezionata Sì Indica se il file CSV ha un'intestazione.
Tipo di codifica dei file Stringa utf-8 Sì Imposta il tipo di codifica CSV, ad esempio iso-8859-1, latin1, utf-8, utf-16.
Nome campo avviso Stringa N/D No Nome del campo che contiene informazioni sul nome dell'avviso.
Nome campo gravità Stringa N/D No

Nome del campo che contiene informazioni sulla gravità.
Nota: puoi mappare la gravità in base ai valori nella risposta. Per farlo, devi andare alla cartella di esecuzione del connettore e modificare severity_mapping_config.json. Consulta la documentazione per riferimento.

Regole del connettore

Supporto dei proxy

Il connettore non supporta il proxy.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.