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 legacy V1 utilizza 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 Details Ruolo 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 Events Ruolo Analyst o ruolo personalizzato di sola lettura con l'autorizzazione per generare credenziali OAuth 2.0 e cercare record di eventi di sicurezza storici.
    Ping Credenziali dell'account utente valide in grado di autenticare e leggere lo stato dell'ambiente di base in LevelBlue USM Anywhere.
    AlienVault USM Anywhere Connector Ruolo 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 https://SUBDOMAIN.alienvault.cloud.

ClientID

Obbligatorio.

L'ID client OAuth 2.0 associato al tuo account di servizio LevelBlue USM Anywhere quando Product Version è impostato su V2.

Se Product Version è impostato su V1, fornisci invece il nome utente dell'account LevelBlue USM Anywhere in questo campo.

Secret

Obbligatorio.

Il client secret OAuth 2.0 associato al tuo account di servizio LevelBlue USM Anywhere quando Product Version è impostato su V2.

Se Product Version è impostato su V1, fornisci la password dell'account LevelBlue USM Anywhere in questo campo.

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

I valori possibili sono:

  • V1
  • V2

Il valore predefinito è V2.

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 Alarm ID specificato corrisponda a un allarme esistente in LevelBlue USM Anywhere e controlla che le tue credenziali OAuth 2.0 abbiano accesso in lettura agli allarmi.

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 Product Version in V2 e fornisci credenziali OAuth 2.0 ClientID e Secret valide.

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 Kerberos service ticket was requested.

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 DD/MM/YYYY.

End Time

Facoltativo.

La data di fine dell'intervallo di ricerca degli eventi, formattata come DD/MM/YYYY.

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 è 100.

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 Start Time in modo che venga visualizzato prima il giorno, seguito dal mese di due cifre e dall'anno di quattro cifre (ad esempio, 22/04/2026).

Unable to parse end time END_TIME. Valid format is DD/MM/YYYY.

L'azione non è riuscita.

Aggiorna il parametro End Time in modo che venga visualizzato prima il giorno, seguito dal mese di due cifre e dall'anno di quattro cifre (ad esempio, 29/04/2026).

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 Product Version in V2 e configura credenziali OAuth 2.0 valide.

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 API Root sia corretto, controlla che il traffico HTTPS in uscita sulla porta TCP 443 sia consentito e verifica che i valori ClientID e Secret siano validi.

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 è device_product.

EventClassId

Facoltativo.

Il nome del campo che determina il nome dell'evento (sottotipo).

Il valore predefinito è message_plugin.

PythonProcessTimeout

Obbligatorio.

Il limite di timeout, in secondi, per il processo Python che esegue lo script corrente.

Il valore predefinito è 60.

Api Root

Obbligatorio.

L'URL di base del server LevelBlue USM Anywhere, formattato come https://SUBDOMAIN.alienvault.cloud.

ClientID

Obbligatorio.

L'ID client OAuth 2.0 per il tuo service account LevelBlue USM Anywhere quando Product Version è impostato su V2 o il nome utente dell'account quando Product Version è impostato su V1.

Secret

Obbligatorio.

Il client secret OAuth 2.0 per il tuo account di servizio LevelBlue USM Anywhere quando Product Version è impostato su V2 o la password dell'account quando Product Version è impostato su V1.

Product Version

Obbligatorio.

La versione di autenticazione di LevelBlue USM Anywhere da utilizzare durante l'importazione degli allarmi.

I valori possibili sono:

  • V1
  • V2

Il valore predefinito è V2.

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 è 10.

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 è 1.

Padding Period

Facoltativo.

Il buffer di lookback, in ore (da 0 a 12), sottratto dall'ora corrente quando si eseguono query per nuovi allarmi. Configura questa impostazione se i sensori riscontrano un ritardo nella distribuzione dei log in LevelBlue USM Anywhere. I valori al di fuori dell'intervallo da 0 a 12 vengono reimpostati su 0.

Il valore predefinito è 0.

Show Suppressed

Facoltativo.

Se selezionata mentre Use Suppressed Filter è abilitato, il connettore importa solo gli allarmi soppressi. Se non viene selezionata mentre Use Suppressed Filter è abilitata, il connettore importa solo gli allarmi non soppressi.

Use Suppressed Filter

Facoltativo.

Se selezionata, il connettore filtra gli allarmi in base all'impostazione Show Suppressed:

  • Importa tutti gli allarmi (soppressi e non soppressi): cancella Use Suppressed Filter.
  • Importa solo gli allarmi non soppressi: seleziona Use Suppressed Filter e deseleziona Show Suppressed.
  • Importa solo gli allarmi soppressi: seleziona sia Use Suppressed Filter sia Show Suppressed.

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, high,medium). Per importare gli allarmi di tutte le priorità, lascia vuoto questo campo.

I valori possibili sono:

  • high
  • medium
  • low
Rule Intent

Facoltativo.

Filtra gli allarmi importati in base alla categoria di intenti della minaccia.

I valori possibili sono:

  • System Compromise
  • Exploitation & Installation
  • Delivery & Attack
  • Reconnaissance & Probing
  • Environmental Awareness
Rule Strategy

Facoltativo.

Filtra gli allarmi importati in base alla strategia di attacco che ha attivato la regola di rilevamento (ad esempio, Client-Side Attack - Known Vulnerability).

Rule Method

Facoltativo.

Filtra gli allarmi importati in base al metodo di rilevamento specifico o alla firma della regola (ad esempio, Windows Audit Log Cleared).

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.