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à. |
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.