Integra GRR Rapid Response con Google SecOps
Questo documento spiega come configurare e integrare GRR Rapid Response con Google Security Operations.
Casi d'uso
L'integrazione di GRR Rapid Response utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:
Raccolta di dati forensi sugli endpoint: attiva automaticamente i flussi forensi per raccogliere file, chiavi di registro e artefatti di memoria dagli endpoint remoti durante un'indagine.
Ricerca rapida delle minacce: cerca file o hash specifici in tutti i client gestiti per identificare l'ambito di una compromissione.
Arricchimento dei metadati dei client: recupera informazioni dettagliate sui client, tra cui la versione del sistema operativo, le specifiche hardware e la configurazione di rete, per fornire il contesto per gli avvisi di sicurezza.
Risposta automatizzata agli incidenti: utilizza i playbook per elencare i client attivi o cercare artefatti sospetti immediatamente dopo il rilevamento di attività dannose.
Prima di iniziare
Prima di configurare l'integrazione in Google SecOps, verifica che l'ambiente GRR Rapid Response soddisfi i seguenti requisiti:
Credenziali API: devi disporre di un nome utente e una password validi per un account utente con accesso API al server GRR.
Autorizzazioni dell'account: assicurati che l'account utilizzato per l'integrazione disponga di autorizzazioni sufficienti per avviare i flussi e cercare gli artefatti sui client di destinazione.
Configurazione del server: identifica la radice dell'API del tuo server GRR (ad esempio
https://<grr-server-address>:8000).Accesso alla rete: assicurati che la configurazione di rete consenta le connessioni HTTPS in uscita dal tuo ambiente Google SecOps all'endpoint API GRR.
Parametri di integrazione
L'integrazione di GRR Rapid Response richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
API Root |
Obbligatorio. L'URL di base dell'API del server GRR, inclusa la porta (ad esempio, |
Username |
Obbligatorio. Il nome utente dell'account GRR utilizzato per autenticare la connessione. |
Password |
Obbligatorio. La password associata all'account GRR utilizzato per l'autenticazione. |
Verify SSL |
Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server GRR. Abilitato per impostazione predefinita. |
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.
Ottieni dettagli client
Utilizza l'azione Get Client Details (Recupera dettagli cliente) per recuperare i dettagli completi del cliente.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Get Client Details richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Client ID |
Obbligatorio. L'ID del cliente. Questo parametro accetta più valori sotto forma di stringa separata da virgole. |
Output azione
L'azione Get Client Details fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Get Client Details può generare la seguente tabella:
Nome tabella: GRR Clients Details
Colonne della tabella:
- ID client
- Organizzatore
- Versione sistema operativo
- Etichette
- Dimensioni memoria
- Versione client
- Prima visualizzazione
- Ultimo rilevamento
- Data di installazione del sistema operativo
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Get Client Details:
[
{
"HardwareInfo": {
"system_product_name": "HVM domU",
"bios_rom_size": "64 kB",
"bios_vendor": "Xen",
"system_sku_number": "Not Specified",
"system_family": "Not Specified",
"system_uuid": "UUID",
"system_manufacturer": "Xen",
"bios_release_date": "08/24/2006",
"bios_version": "4.2.amazon",
"serial_number": "UUID",
"bios_revision": "4.2"
},
"LastClock": 1535907460060247,
"Interfaces": [
{
"ifname": "lo",
"addresses": [
{
"packed_bytes": "fwAAAQ==",
"address_type": "INET"
},
{
"packed_bytes": "AAAAAAAAAAAAAAAAAAAAAQ==",
"address_type": "INET6"
}
],
"mac_address": "MAC_ADDRESS"
},
{
"ifname": "eth0",
"addresses": [
{
"packed_bytes": "rB8sWw==",
"address_type": "INET"
},
{
"packed_bytes": "/oAAAAAAAAAE1kv//h5yfg==",
"address_type": "INET6"
}
],
"mac_address": "MAC_ADDRESS"
}
],
"OS": {
"kernel": "4.4.0-1065-aws",
"install_date": 1534280169000000,
"system": "Linux",
"fqdn": "ip-192-0-2-91.example",
"machine": "x86_64",
"version": "16.4",
"release": "Ubuntu"
},
"AgentInfo": {
"client_name": "grr",
"client_description": "grr linux amd64",
"client_version": 3232,
"build_time": "2018-06-28 09:37:57"
},
"Labels": [],
"LastBootedAt": 1535292604000000,
"FirstSeenAt": 1535293827970976,
"User": [],
"Volumes": [
{
"total_allocation_units": 50808745,
"bytes_per_sector": 4096,
"sectors_per_allocation_unit": 1,
"unixvolume": {
"mount_point": "/"
},
"actual_available_allocation_units": 50027766
}
],
"LastCrashAt": null,
"LastSeenAt": 1535907460075229,
"ID": "CLIENT_ID"
}
]
Messaggi di output
L'azione Get Client Details può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "Get Client Details". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli client:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Ottieni i dettagli della ricerca
Utilizza l'azione Get Hunt Details (Ottieni dettagli della ricerca) per recuperare i dettagli della ricerca.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Get Hunt Details richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Hunt ID |
Obbligatorio. L'ID di una ricerca da recuperare. Questo parametro accetta più valori sotto forma di stringa separata da virgole. |
Output azione
L'azione Get Hunt Details (Ottieni dettagli della ricerca) fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Link alla bacheca casi
L'azione Get Hunt Details (Ottieni dettagli della ricerca) può generare il seguente link:
API_ROOT/#/hunts/HUNT_ID
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Get Hunt Details:
[
{
"Name": "ExampleHunt",
"Expires": 1537063517000000,
"Description": "test",
"Creator": "admin",
"IsRobot": false,
"Status": "PAUSED",
"Hunt_ID": "HUNT_ID",
"Created": 1535853917657925,
"Start_Time": 1535853917657925,
"Duration": "2w",
"Expiration time": " ",
"Crash_limit": 100,
"Client_limit": 100,
"Client_rate (clients/min)": "20.5",
"Client_Queued": "20.5",
"Client_Scheduled": "20.5",
"Client_Outstanding": "20.5",
"Client_Completed": "20.5",
"Client_with Results": "20.5",
"Results": "20.5",
"Total_CPU_Time_Used": "20.5",
"Total_Network_Traffic": "20.5",
"Flow_Name": "KeepAlive",
"Flow_Arguments": "20.5",
"Client_Rule_Set": " "
}
]
Messaggi di output
L'azione Get Hunt Details può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "Get Hunt Details". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Get Hunt Details:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenca client
Utilizza l'azione Elenca clienti per cercare i clienti e interagire con loro.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca client richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Offset |
Facoltativo. Il punto di partenza (offset) per la ricerca dei clienti. |
Max Results To Return |
Facoltativo. Il numero massimo di client da restituire in ogni risposta. Il valore predefinito è |
Output azione
L'azione Elenca clienti fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca clienti può generare la seguente tabella:
Nome tabella: GRR Clients
Colonne della tabella:
- ID client
- Organizzatore
- Versione sistema operativo
- Prima visualizzazione
- Versione client
- Etichette
- Ultimo controllo
- Data di installazione del sistema operativo
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca client:
[{
"Client_ID": "CLIENT_ID",
"Agent_Info":{
"Client_Name": "example",
"Client_Version": 3420}
"OS_Info":{
"System": "Linux",
"Release": "Ubuntu",
"Architecture": "x86_64",
"Installation_Time": "2020-04-09 13:44:17 UTC",
"Kernel": "4.15.0-96-generic",
"Version": "18.04"}
"Client_Last_Booted_At": "",
"Client_First_Seen_At": "2020-09-25 14:26:38 UTC",
"Client_Last_Seen": "2020-11-19 10:12:52 UTC",
"Client_Last_Clock": "2020-11-19 10:12:52 UTC",
"Memory_Size": "985.6MiB",
"Client_Labels": []
}]
Messaggi di output
L'azione Elenca client può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "List Clients". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca client:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenca cacce
Utilizza l'azione Elenca ricerche per recuperare informazioni su tutte le ricerche disponibili.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca ricerche richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Creator |
Facoltativo. Un utente che ha creato una ricerca. |
Offset |
Facoltativo. Il punto di partenza (offset) per la ricerca delle cacce. |
Max Results To Return |
Facoltativo. Il numero massimo di ricerche da restituire in ogni risposta. Il valore predefinito è |
Output azione
L'azione Elenca ricerche fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca ricerche può generare la seguente tabella:
Nome tabella: Hunts
Colonne della tabella:
- ID ricerca
- Stato
- Ora di creazione
- Ora di inizio
- Durata
- Limite di client
- Data di scadenza
- Creator
- Descrizione
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca ricerche:
[
{
"Hunt_Description": "Interrogate run by cron to keep host info fresh.",
"Creator": "GRRCron",
"Is_Robot": false,
"State": "STARTED",
"Creation Time": "1605690387510082",
"Start Time (initial)": "1605690387678448",
"Start Time (last)": "1605690387678448",
"Duration": " ",
"Client Limit": 0,
"Expiration Time": " ",
"Hunt_ID": "HUNT_ID",
}
]
Messaggi di output
L'azione Elenca ricerche può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "List Hunts". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca ricerche:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenca i flussi avviati
Utilizza l'azione Elenca i flussi avviati per elencare i flussi avviati su un client specificato.
Questa azione viene eseguita sulle seguenti entità Google SecOps:
IP AddressHostname
Input azione
L'azione Elenca i flussi avviati richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Offset |
Facoltativo. Il punto di partenza (offset) per la ricerca dei flussi. |
Max Results To Return |
Facoltativo. Il numero massimo di flussi da restituire in ogni risposta. Il valore predefinito è |
Output azione
L'azione Elenca i flussi avviati fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca i flussi avviati può generare la seguente tabella:
Nome della tabella: GRR Launch Flows
Colonne della tabella:
- Nome del flusso
- ID flusso
- Stato
- Ora di creazione
- Ultima attività
- Creator
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca i flussi avviati:
{
"Creator": "admin",
"NestedFlow": [],
"LastActiveAt": 1535900632278975,
"Args": {
"ARGUMENTS"
},
"State": "TERMINATED",
"StartedAt": 1535900542745106,
"Flow_ID": "FLOW_ID",
"Flow_Name": "FLOW_NAME"
}
Messaggi di output
L'azione Elenca i flussi avviati può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "List Launched Flows". Reason:
ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca i flussi avviati:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Dindin
Utilizza l'azione Ping per testare la connettività a GRR Rapid Response.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Ping fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Ping può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
Successfully connected to the GRR server with the provided
connection parameters! |
L'azione è andata a buon fine. |
Failed to connect to the GRR server! Error is ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Avvia una ricerca
Utilizza l'azione Avvia una ricerca per avviare una ricerca appena creata. Per impostazione predefinita, GRR Rapid Response assegna lo stato PAUSED a tutte le nuove ricerche.
GRR Rapid Response imposta tutte le ricerche che hanno raggiunto il limite di client sullo stato PAUSED. Dopo aver rimosso il limite di client, puoi utilizzare l'azione Avvia una ricerca per riavviare le ricerche in pausa.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Avvia una ricerca richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Hunt ID |
Obbligatorio. L'ID della caccia da avviare. Questo parametro accetta più valori sotto forma di stringa separata da virgole. |
Output azione
L'azione Avvia una ricerca fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Avvia una ricerca:
[{ "Hunt_ID": "HUNT_ID", "State": STARTED}]
Messaggi di output
L'azione Avvia una ricerca può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "Start A Hunt". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Interrompi una ricerca
Utilizza l'azione Interrompi una ricerca per impedire ai nuovi client di pianificare e interrompere i flussi correnti nel momento in cui il loro stato cambia.
Una volta interrotta una ricerca, non puoi riprenderla. Questa azione elimina tutti i risultati attuali in corso e non influisce sui risultati già segnalati.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Interrompi una ricerca richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Hunt ID |
Obbligatorio. L'ID di una ricerca da interrompere. Questo parametro accetta più valori sotto forma di stringa separata da virgole. |
Output azione
L'azione Interrompi una ricerca fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Interrompi una ricerca:
[{ "Hunt_ID": "HUNT_ID", "State": STOPPED}]
Messaggi di output
L'azione Interrompi una ricerca può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è andata a buon fine. |
Error executing action "Stop A Hunt". Reason: ERROR_REASON |
L'azione non è andata a buon fine. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Interrompi una ricerca:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.