Integra LevelBlue USM Anywhere con Google SecOps
Questo documento spiega come integrare LevelBlue USM Anywhere con Google Security Operations.
Casi d'uso
L'integrazione di LevelBlue USM Anywhere utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:
Triage automatico degli allarmi di sicurezza: importa gli allarmi di sicurezza con priorità e i relativi eventi correlati da LevelBlue USM Anywhere nei casi di Google SecOps, filtrando i rilevamenti soppressi o con priorità bassa.
Indagine rapida sul contesto degli allarmi: recupera i metadati completi per un allarme LevelBlue USM Anywhere specifico (inclusi punteggio di priorità, asset di origine e destinazione, contesto geografico e stato di soppressione) direttamente sulla bacheca del caso.
Ricerca mirata di eventi storici: esegui query sugli eventi di sicurezza storici in base al nome dell'account, all'asset di origine, al nome dell'evento e alla finestra temporale durante le indagini automatiche o manuali per determinare l'ambito dell'attività sospetta.
Prima di iniziare
Prima di configurare l'integrazione di LevelBlue USM Anywhere in Google SecOps, verifica che il tuo ambiente soddisfi i seguenti requisiti:
Connettività di rete: assicurati che Google SecOps (o un agente remoto di cui è stato eseguito il deployment per reti private o on-premise) possa raggiungere la tua istanza cloud LevelBlue USM Anywhere tramite HTTPS sulla porta TCP
443.Credenziali di autenticazione e selezione della versione: verifica quale versione di autenticazione LevelBlue USM Anywhere utilizza il tuo ambiente. La versione
V2(consigliata) utilizza un ID client e un secret OAuth 2.0 ed è obbligatoria per eseguire le azioni Recupera dettagli allarme ed Elenca eventi. La versione legacyV1utilizza un nome utente e una password standard e supporta solo la convalida della connettività e l'importazione degli allarmi legacy.Autorizzazioni utente con privilegi minimi: configura un account di servizio LevelBlue USM Anywhere dedicato con le autorizzazioni minime richieste per le azioni e i connettori utilizzati nei tuoi workflow, come descritto nella tabella seguente:
Componente Autorizzazioni LevelBlue USM Anywhere richieste Get Alarm DetailsRuolo Analyst o ruolo personalizzato di sola lettura con autorizzazione per generare credenziali OAuth 2.0 e visualizzare i record degli allarmi e gli eventi associati. List EventsRuolo Analyst o ruolo personalizzato di sola lettura con l'autorizzazione per generare credenziali OAuth 2.0 e cercare record di eventi di sicurezza storici. PingCredenziali dell'account utente valide in grado di autenticare e leggere lo stato dell'ambiente di base in LevelBlue USM Anywhere. AlienVault USM Anywhere ConnectorRuolo di analista o ruolo personalizzato di sola lettura con autorizzazione per eseguire query sugli allarmi di sicurezza, sui metadati degli allarmi e sui dettagli degli eventi correlati.
Per saperne di più sulla configurazione dei ruoli e sulla generazione delle credenziali client OAuth 2.0, consulta la documentazione ufficiale di LevelBlue USM Anywhere e il riferimento API Get OAuth Token.
Parametri di integrazione
L'integrazione di LevelBlue USM Anywhere richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Api Root |
Obbligatorio. L'URL di base del server LevelBlue USM Anywhere, formattato come |
ClientID |
Obbligatorio. L'ID client OAuth 2.0 associato al tuo account di servizio LevelBlue USM Anywhere quando Se |
Secret |
Obbligatorio. Il client secret OAuth 2.0 associato al tuo account di servizio LevelBlue USM Anywhere quando Se |
Product Version |
Obbligatorio. La versione di autenticazione di LevelBlue USM Anywhere da utilizzare. Per utilizzare le azioni Recupera dettagli allarme ed Elenca eventi, questo parametro deve essere impostato su I valori possibili sono:
Il valore predefinito è |
Use SSL |
Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server LevelBlue USM Anywhere. 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.
Visualizza i dettagli dell'allarme
Utilizza l'azione Get Alarm Details per recuperare metadati completi per un allarme LevelBlue USM Anywhere specifico (tra cui priorità, intento della regola, strategia di attacco, metodo, dettagli di origine e destinazione e stato di soppressione) e visualizzali nella bacheca del caso.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Get Alarm Details richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Alarm ID |
Obbligatorio. L'identificatore univoco dell'allarme LevelBlue USM Anywhere da esaminare. Nei playbook attivati dal connettore AlienVault USM Anywhere, puoi mappare l'identificatore del ticket di avviso direttamente a questo parametro. |
Output azione
L'azione Recupera dettagli allarme 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 enrichment delle entità | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Get Alarm Details (Ottieni dettagli allarme) fornisce la seguente tabella nella bacheca della richiesta:
- Nome tabella:
Alarm <var class="prettyprint readonly">ALARM_ID</var> Details - Colonne:
- ID
- Priorità
- Etichetta Priorità
- Occurred Time
- Ora di ricezione
- Intent della regola
- Strategia di regole
- Metodo della regola
- Nome origine
- Organizzazione di origine
- Paese di origine
- Nome destinazione
- Organizzazione di destinazione
- Paese di destinazione
- Is Suppressed
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Recupera dettagli allarme:
{
"uuid": "5e2ee325-7a04-b082-0842-d06a14552f59",
"status": "open",
"priority": 36,
"priority_label": "medium",
"muted": false,
"suppressed": false,
"timestamp_occured": 1580131109000,
"timestamp_received": 1580131109248,
"rule_intent": "Environmental Awareness",
"rule_strategy": "Windows Event Created",
"rule_method": "Windows Audit Log Cleared",
"source_name": "192.0.2.10",
"source_username": "example_user",
"destination_name": "198.51.100.20",
"sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
"events_count": 1,
"has_alarm": true
}
Messaggi di output
L'azione Recupera dettagli sveglia fornisce i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
Successfully returned details about alarm
ALARM_ID. |
L'azione è riuscita. |
Failed to get alarm details. Error is
ERROR_REASON. |
L'azione non è riuscita. Verifica che l'elemento |
This action is not supported for AlienVault Anywhere V1
integration. Please use V2. |
L'azione non è riuscita. Apri la configurazione dell'integrazione in Google SecOps,
cambia |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera dettagli allarme:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
true o false |
Elenca eventi
Utilizza l'azione Elenca eventi per cercare eventi di sicurezza storici in LevelBlue USM Anywhere per nome account, nome evento, asset di origine, finestra di date o stato di soppressione e visualizza gli eventi corrispondenti nella bacheca della richiesta.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca eventi richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Account Name |
Facoltativo. Il nome dell'account LevelBlue USM Anywhere associato agli eventi di sicurezza da cercare. |
Event Name |
Facoltativo. Il nome completo o parziale dell'evento di sicurezza da cercare, ad esempio |
Source Name |
Facoltativo. Il nome host o l'indirizzo IP dell'asset di origine che ha generato gli eventi di sicurezza. |
Start Time |
Facoltativo. La data di inizio dell'intervallo di ricerca degli eventi, nel formato |
End Time |
Facoltativo. La data di fine dell'intervallo di ricerca degli eventi, formattata come |
Suppressed |
Facoltativo. Se selezionata, l'azione include o corrisponde agli eventi contrassegnati come soppressi in LevelBlue USM Anywhere. |
Events Limit |
Facoltativo. Il numero massimo di eventi di sicurezza corrispondenti da restituire. Il valore predefinito è |
Output azione
L'azione Elenca eventi 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 enrichment delle entità | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca eventi fornisce la seguente tabella nella bacheca richieste:
- Nome tabella:
Alien Vault Anywhere Events - Colonne:
- ID
- Occurred Time
- Ora di ricezione
- Sottocategoria
- Access Control Outcome
- Gravità dell'evento
- Porta di origine
- Nome origine
- Porta di destinazione
- Nome destinazione
- Ha un allarme
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca eventi:
[
{
"access_control_outcome": "OK",
"destination_canonical": "93f4b513-5390-4a8e-be97-949956761775",
"destination_name": "EC2AMAZ-44A6GL4",
"destination_port": "49707",
"destination_username": "EC2AMAZ-44A6GL4$",
"event_category": "Access & Authentication",
"event_name": "Kerberos service ticket was requested",
"event_severity": "INFO",
"event_subcategory": "Authentication",
"has_alarm": false,
"id": "e489d3b0-bb09-8696-e235-23da207dc9b1",
"log": "{\"winlogbeat\":{\"record_number\":\"2369959\",\"event_id\":4769}}",
"packet_type": "log",
"plugin": "AlienVault NIDS",
"plugin_device": "AlienVault Sensor",
"plugin_device_type": "Intrusion Detection",
"plugin_rule": "4769 - A Kerberos service ticket was requested.",
"plugin_version": "-",
"rep_device_address": "192.0.2.15",
"rep_device_canonical": "93f4b513-5390-4a8e-be97-949956761775",
"rep_device_hostname": "EC2AMAZ-44A6GL4",
"rep_device_rule_id": "4769",
"sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
"source_canonical": "93f4b513-5390-4a8e-be97-949956761775",
"source_name": "EC2AMAZ-44A6GL4",
"source_port": "49707",
"source_process": "C:\\Windows\\System32\\lsass.exe",
"source_userid": "S-1-5-18",
"source_username": "example_user",
"suppressed": false,
"tag_names": [],
"timestamp_occured": 1579772348000,
"timestamp_received": 1579772350000,
"used_hint": false,
"was_fuzzied": false,
"links": {
"self": {
"href": "https://example.alienvault.cloud/api/2.0/events/e489d3b0-bb09-8696-e235-23da207dc9b1"
}
}
}
]
Messaggi di output
L'azione Elenca eventi fornisce i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
Successfully returned
EVENTS_COUNT AlienVault Anywhere
events |
L'azione è riuscita. |
Failed to list Alien Vault Anywhere events! Error is
ERROR_REASON |
L'azione non è riuscita. Verifica che il server LevelBlue USM Anywhere sia raggiungibile, controlla che le tue credenziali OAuth 2.0 siano attive e verifica che i valori dei filtri corrispondano a nomi di account o origini validi. |
Unable to parse start time
START_TIME. Valid format is
DD/MM/YYYY. |
L'azione non è riuscita. Aggiorna il parametro |
Unable to parse end time
END_TIME. Valid format is
DD/MM/YYYY. |
L'azione non è riuscita. Aggiorna il parametro |
This action is not supported for AlienVault Anywhere V1
integration. Please use V2. |
L'azione non è riuscita. Apri la configurazione dell'integrazione in Google SecOps,
cambia |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca eventi:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
true o false |
Dindin
Utilizza l'azione Ping per testare la connettività e verificare che le credenziali configurate possano autenticarsi con il server LevelBlue USM Anywhere.
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 enrichment delle entità | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Ping fornisce i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
Connected successfully. |
L'azione è riuscita. |
Failed to connect to the AlienVaultAnywhere! Error is
ERROR_REASON |
L'azione non è riuscita. Verifica che l'URL |
Risultato dello script
La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Ping:
| Nome del risultato dello script | Valore |
|---|---|
success |
true o false |
Connettori
Per scoprire di più sulla configurazione dei connettori in Google SecOps, consulta Importa i dati (connettori).
Connettore AlienVault USM Anywhere
Utilizza il connettore AlienVault USM Anywhere Connector per importare gli allarmi di sicurezza e i relativi eventi correlati da LevelBlue USM Anywhere negli avvisi e nei casi di Google SecOps.
Per informazioni dettagliate sugli endpoint di polling degli allarmi e sui parametri di filtro, consulta il Riferimento API Get a Page of Alarms.
Input del connettore
Il connettore AlienVault USM Anywhere Connector richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
DeviceProductField |
Obbligatorio. Il nome del campo dell'evento utilizzato per compilare l'attributo del prodotto del dispositivo negli avvisi di Google SecOps. Il valore predefinito è |
EventClassId |
Facoltativo. Il nome del campo che determina il nome dell'evento (sottotipo). Il valore predefinito è |
PythonProcessTimeout |
Obbligatorio. Il limite di timeout, in secondi, per il processo Python che esegue lo script corrente. Il valore predefinito è |
Api Root |
Obbligatorio. L'URL di base del server LevelBlue USM Anywhere, formattato come |
ClientID |
Obbligatorio. L'ID client OAuth 2.0 per il tuo service account LevelBlue USM Anywhere quando |
Secret |
Obbligatorio. Il client secret OAuth 2.0 per il tuo account di servizio LevelBlue USM Anywhere quando |
Product Version |
Obbligatorio. La versione di autenticazione di LevelBlue USM Anywhere da utilizzare durante l'importazione degli allarmi. I valori possibili sono:
Il valore predefinito è |
Verify SSL |
Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server LevelBlue USM Anywhere. |
Max Alerts Per Cycle |
Obbligatorio. Il numero massimo di allarmi da importare durante ogni esecuzione del connettore. Il valore predefinito è |
Max Days Backwards |
Obbligatorio. Il numero di giorni precedenti alla prima esecuzione del connettore da cui recuperare gli allarmi. Questo parametro può essere applicato all'iterazione iniziale del connettore dopo l'attivazione del connettore per la prima volta o al valore di riserva per un timestamp del connettore scaduto. Il valore predefinito è |
Padding Period |
Facoltativo. Il buffer di lookback, in ore (da Il valore predefinito è |
Show Suppressed |
Facoltativo. Se selezionata mentre |
Use Suppressed Filter |
Facoltativo. Se selezionata, il connettore filtra gli allarmi in base all'impostazione
Per ulteriori informazioni sulla soppressione degli allarmi in LevelBlue USM Anywhere, consulta Regole di soppressione dalla pagina Regole di orchestrazione. |
Priority |
Facoltativo. Un elenco separato da virgole dei livelli di priorità degli allarmi da importare (ad esempio, I valori possibili sono:
|
Rule Intent |
Facoltativo. Filtra gli allarmi importati in base alla categoria di intenti della minaccia. I valori possibili sono:
|
Rule Strategy |
Facoltativo. Filtra gli allarmi importati in base alla strategia di attacco che ha attivato la regola di rilevamento (ad esempio, |
Rule Method |
Facoltativo. Filtra gli allarmi importati in base al metodo di rilevamento specifico o alla firma della regola (ad esempio, |
Proxy Server Address |
Facoltativo. L'indirizzo del server proxy da utilizzare. |
Proxy Username |
Facoltativo. Il nome utente del proxy con cui eseguire l'autenticazione. |
Proxy Password |
Facoltativo. La password del proxy da utilizzare per l'autenticazione. |
Regole del connettore
- Il connettore supporta i proxy.
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.