BlueLiv

Versione integrazione: 8.0

Guida all'integrazione

Lo scopo dell'integrazione è importare le minacce da BlueLiv, utilizzando i filtri pertinenti per mostrare solo le minacce desiderate all'interno di Google Security Operations, utilizzando il connettore per le minacce, e poi eseguire azioni aggiuntive su queste minacce in base ai casi d'uso pertinenti.

In questa guida rapida esamineremo alcuni aspetti per semplificare l'utilizzo dell'integrazione per i clienti di Google SecOps.

Configurazione dell'integrazione

Esamineremo i parametri e dove trovarli in modo che sia più facile per te configurare l'integrazione:

  • Radice API: l'URL che utilizzi per visualizzare la home page di BlueLiv quando viene aggiunto il suffisso /api/v2. Ad esempio: https://tcdach.blueliv.com/api/v2 deve essere il valore di questo parametro.
  • Nome utente: lo stesso nome utente che utilizzi per connetterti alla home page di BlueLiv.
  • Password: la stessa password che utilizzi per connetterti alla home page di BlueLiv.
  • ID organizzazione: puoi individuare facilmente l'ID organizzazione nell'URL che utilizzi per sfogliare il prodotto stesso, ad esempio:

    Per questo esempio, l'ID organizzazione è 117:

    https://tcdach.blueliv.com/dashboard/organizations/117/indexed

Dopo aver esaminato i parametri di integrazione, possiamo approfondire gli altri termini della nostra integrazione.

Tipi di moduli

BlueLiv ha suddiviso la sezione delle minacce in tipi di moduli e in questa integrazione utilizziamo questi tipi per aiutare la piattaforma SOAR e inserire solo le informazioni pertinenti se vuoi filtrare per tipo di modulo. I seguenti tipi di moduli sono attualmente disponibili in BlueLiv:

  • Credenziali
  • Social media
  • Carte di credito
  • Protezione del dominio
  • Malware
  • Data Leakage
  • Hacktivism
  • Dark web
  • Personalizzato
  • Media Tracker
  • App per dispositivi mobili

ID minaccia e ID modulo

https://tcdach.blueliv.com/dashboard/organizations/117/modules/1303/resource/31024379

Ogni minaccia che puoi trovare in BlueLiv ha un UID, un numero che la rappresenta. Anche questo può essere facilmente individuato nell'URL. Una minaccia è chiamata anche risorsa. Ad esempio, qui l'UID della minaccia è 31024379.

Inoltre, per ogni modulo presente in BlueLiv hai un UID, un numero che lo rappresenta. Ad esempio, qui l'UID della minaccia è 1303.

Consiglio relativo alla configurazione

Blueliv consente una sola sessione aperta alla volta. Per motivi di stabilità, è consigliabile utilizzare utenti diversi per la configurazione dell'integrazione e i connettori. Nota: ogni connettore richiede un utente separato.

Casi d'uso

  1. Monitoraggio proattivo delle minacce informatiche
  2. Protezione del brand
  3. Protezione dalle violazioni dei dati
  4. Prevenzione delle attività fraudolente
  5. Rilevamento di contraffazione

Configura l'integrazione di BlueLiv in Google SecOps

Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa

https://example
.blueliv.com/api/v2

Root API dell'istanza BlueLiv.
Nome utente Stringa N/D Nome utente di BlueLiv.
Password Password N/D Password dell'utente
ID organizzazione Stringa N/D Specifica l'ID organizzazione da utilizzare in BlueLiv
Verifica SSL Casella di controllo Deselezionata Se abilitata, verifica che il certificato SSL per la connessione al server IronScales sia valido.

Azioni

Dindin

Descrizione

Testa la connettività a BlueLiv con i parametri forniti nella pagina di configurazione dell'integrazione nella scheda Google Security Operations Marketplace.

Parametri

N/D

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se entrambe le chiamate API sono andate a buon fine: "Connessione al server BlueLiv riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se solo la prima chiamata è andata a buon fine e la seconda no: "Accesso eseguito correttamente con il nome utente e la password, ma sembra che l'ID organizzazione non sia corretto. Controlla il parametro ID organizzazione nella pagina di configurazione dell'integrazione e riprova "

Se l'operazione non va a buon fine: "Impossibile connettersi a BlueLiv! Error is {0}".format(exception.stacktrace)

Generale

Arricchisci entità

Descrizione

Arricchisci le entità utilizzando le informazioni del modulo Threat Context di Blueliv. Entità supportate: IP, hash, URL, autore di minacce, campagna per le minacce, firma della minaccia, dominio, CVE.

Parametri

Nome Valore predefinito È obbligatorio Descrizione
Punteggio più basso da contrassegnare come sospetto 5 Specifica il punteggio minimo che deve avere l'entità per essere contrassegnata come sospetta. Massimo: 10.
Crea approfondimento Vero No Se attivata, l'azione creerà insight contenenti informazioni sulle entità.

Run On

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Hash
  • URL
  • Utente malintenzionato
  • Campagna per le minacce
  • Firma per le minacce
  • CVE
Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore Esempio
operazione riuscita Vero/Falso success:False
Bacheca casi
Custodia Operazione riuscita Errore Messaggio
Se hai arricchito alcune entità true falso Arricchimento riuscito delle seguenti entità utilizzando le informazioni di Blueliv: {entity.identifier}
Se non arricchito alcuni true falso L'azione non è riuscita ad arricchire le seguenti entità utilizzando le informazioni di Blueliv: {entity.identifier}
se non arricchito tutto falso falso Nessuna entità è stata arricchita utilizzando le informazioni di Blueliv.
Errore irreversibile, credenziali non valide, radice API falso true Errore durante l'esecuzione dell'azione "Arricchisci entità". Motivo: {error traceback}
Se il modulo "Contesto minaccia" non è disponibile falso Vero Errore durante l'esecuzione dell'azione "Arricchisci entità". Motivo: la tua istanza non supporta il modulo "Contesto minaccia".

Aggiungere un commento a una minaccia

Descrizione

L'azione aggiungerà un commento di testo desiderato a una minaccia specifica.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di modulo Stringa N/D Specifica il tipo di modulo a cui appartiene la risorsa.
ID modulo Stringa N/D Specifica l'ID modulo a cui appartiene la risorsa.
ID risorsa Stringa N/D Specifica l'ID risorsa a cui aggiungere il commento.
Testo del commento Stringa N/D Fornisci il commento che vuoi aggiungere alla risorsa.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Type (Entity \ General)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

In caso di esito positivo: "Successfully added the comment to threat ID: "+{threat_ID}

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Failed to perform action "Add Comment to a Threat {0}".format(exception.stacktrace)

Generale
Tabella Bacheca casi

Name: "Threat ID "+{threat_id}+" Comments:

Colonna:

  • Riga del commento
  • ID commento
  • Contenuti
  • Data creazione
  • Commentatore

Contrassegnare una minaccia come preferita

Descrizione

L'azione contrassegnerà la minaccia specificata come minaccia preferita in BlueLiv.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Valori DDL È obbligatorio Descrizione
Tipo di modulo Stringa N/D Specifica il tipo di modulo a cui appartiene la risorsa.
ID modulo Stringa N/D Specifica l'ID modulo a cui appartiene la risorsa.
ID risorsa Stringa N/D Specifica l'ID risorsa a cui aggiungere il commento.
Stato preferito DDL Aggiunti a Speciali dall'utente

Non aggiunti a Speciali

Aggiunti a Speciali dall'utente

Gruppo aggiunto a Speciali

Tutti i file aggiunti a Speciali

Fornisci lo stato Preferito che vuoi applicare alla minaccia specificata.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Type (Entity \ General)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

In caso di esito positivo: "ID minaccia contrassegnato correttamente come preferito: "+{threat_ID}+""

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Failed to perform action "Mark Threat as a Favorite {0}".format(exception.stacktrace)

Generale

Aggiungere etichette alle minacce

Descrizione

L'azione aggiungerà il nome dell'etichetta specificato agli ID minaccia specificati.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di modulo Stringa N/D Specifica il tipo di modulo a cui appartiene la risorsa.
ID modulo Stringa N/D Specifica l'ID modulo a cui appartiene la risorsa.
ID risorsa Stringa N/D Specifica gli ID risorsa, in un elenco separato da virgole, a cui aggiungere le etichette.
Nomi delle etichette Stringa N/D Specifica i nomi delle etichette che vuoi applicare alle minacce specificate in un elenco separato da virgole. Fai attenzione alle lettere minuscole e maiuscole.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Type (Entity \ General)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se alcune etichette non sono state trovate: "Non è stato possibile trovare le seguenti etichette in BlueLiv: +(unsuccessful_label names_list)+. Controlla i nomi delle etichette che hai fornito nei parametri dell'azione e riprova".

Se non sono state trovate alcune minacce: "Impossibile trovare le seguenti minacce in BlueLiv":+(unsuccessful_threat_IDs)+". Controlla gli ID minaccia che hai fornito nei parametri dell'azione e riprova"

Se l'operazione è andata a buon fine: "Le seguenti etichette sono state aggiunte correttamente:" +(successful_label_names_list)+ " ai seguenti ID minaccia: "+(successful_threat_IDs_list)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se non sono state trovate etichette: "Non è stato possibile trovare nessuna delle seguenti etichette in BlueLiv: +(unsuccessful_label names_list)+. Controlla i nomi delle etichette che hai fornito nei parametri dell'azione e riprova".

Se non sono state trovate minacce: "Non è stato possibile trovare nessuna delle seguenti minacce in BlueLiv":+(unsuccessful_threat_IDs_list)+". Controlla gli ID minaccia che hai fornito nei parametri dell'azione e riprova".

Se l'operazione non va a buon fine: "Failed to perform action "Add Labels to Threats".format(exception.stacktrace)

Generale

Rimuovere le etichette dalle minacce

Descrizione

L'azione rimuoverà le etichette specificate dagli ID minaccia specificati.

Parametri
Nome Valore predefinito È obbligatorio Descrizione
Tipo di modulo N/D Specifica il tipo di modulo a cui appartiene la risorsa.
ID modulo Specifica l'ID modulo a cui appartiene la risorsa
ID risorsa Specifica un elenco separato da virgole di ID risorsa da cui vuoi rimuovere le etichette.
Nomi delle etichette Specifica un elenco separato da virgole di etichette da rimuovere. Fai attenzione alle lettere minuscole e maiuscole.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Custodia Operazione riuscita Errore Messaggio
Se alcune etichette non sono state trovate true falso "Impossibile trovare le seguenti etichette in BlueLiv: \n {labels}. Controlla i nomi delle etichette che hai fornito nei parametri dell'azione e riprova."
Se non sono state trovate alcune minacce true falso Impossibile trovare le seguenti minacce dal modulo {module} {threat IDs}: {threat IDs}. Controlla gli ID minaccia che hai fornito nei parametri dell'azione e riprova
Se l'operazione ha esito positivo per alcuni: true falso Le seguenti etichette sono state rimosse dalla seguente minaccia {threat ID} in Blueliv: {successful_labels}
Se alcune non sono ancora state applicate: true falso Le seguenti etichette non facevano già parte della minaccia {threat ID} in Blueliv: {labels already not a part}
Se non vengono trovate etichette falso true Errore durante l'esecuzione dell'azione "Rimuovi etichette dalle minacce". Motivo: nessuna delle etichette è stata trovata. Controlla l'ortografia.
Se non sono state trovate minacce falso true Errore durante l'esecuzione dell'azione "Rimuovi etichette dalle minacce". Motivo: nessuna delle minacce è stata trovata. Controlla l'ortografia.
Errore irreversibile, credenziali non valide, radice API falso true Errore durante l'esecuzione dell'azione "Rimuovi etichette dalle minacce". Motivo: {error traceback}
Se il tipo o l'ID del modulo non è valido falso true Errore durante l'esecuzione dell'azione "Rimuovi etichette dalle minacce". Motivo: è stato fornito un ID modulo o un tipo di modulo non valido.

Elenco minacce entità

Descrizione

Elenca le minacce correlate alle entità in Blueliv. Entità supportate: tutte.

Limitazioni note

L'API Blueliv potrebbe non restituire alcun risultato, anche se la stringa corrisponde esattamente al nome della minaccia. Di seguito è riportato un esempio:

https://pastebin.com/YRkUCLGc: l'URL viene visualizzato quando si esegue la ricerca utilizzando la parola chiave "pastebin".

https://pastebin.com/YRkUCLGc - non viene visualizzato quando si esegue la ricerca utilizzando la parola chiave "https://pastebin.com/YRkUCLGc".

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Filtro per etichetta CSV N/D No Specifica un elenco di etichette separate da virgole che verranno utilizzate per filtrare le minacce. Nota: il filtro delle etichette funziona con la logica "OR".
Filtro dei moduli CSV N/D No Specifica un elenco di moduli separati da virgole che verranno utilizzati per filtrare le minacce.
Numero massimo di minacce da restituire Numero intero 50 No Specifica il numero di minacce da restituire per entità. Se non viene specificato nulla, l'azione restituirà 50 minacce.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione
Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "id": xxxxxxx,
    "module_id": xxxx,
    "module_name": "Data Leakage",
    "module_short_name": "xxx-xxxxx",
    "module_type": "DATA_LEAKAGE",
    "url": "xxx",
    "content_type": "text/html",
    "countries_id": "xx",
    "analysis_result": "INFORMATIVE",
    "analysis_calc_result": "INFORMATIVE",
    "created_at": 1626163680000,
    "checked_at": 1626163680000,
    "changed_at": 1626163680000,
    "user_rating": 0,
    "read": true,
    "fav": "NOT_STARRED",
    "issued": false,
    "labels": [
        {
            "id": 36116,
            "name": "GithubCodeByFilename",
            "background_color": 16777215,
            "text_color": 0,
            "type": "GLOBAL"
        },
        {
            "id": 160,
            "name": "Public",
            "background_color": 45960,
            "text_color": 16777215,
            "type": "GLOBAL"
        }
    ],
    "tlpStatus": "AMBER",
    "searchPhrase": "credit card",
    "followedUp": false,
    "history": []
},
Bacheca casi
Tipo di risultato Valore/Descrizione Type (Entity \ General)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili per una(is_success = true): "Successfully listed available threats to the following entities in Blueliv: {entity.identifier}".

Se non sono presenti minacce per una (is_success=true): "Non sono state trovate minacce correlate alle seguenti entità in Blueliv: {entity.identifier}"

Se non sono presenti minacce per una (is_success=true): "Non sono state trovate minacce correlate alle entità fornite in Blueliv"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Elenca minacce entità". Motivo: {0}''.format(error.Stacktrace)

Generale
Tabella Bacheca casi

Titolo: {entity.identifier}

Nome modulo

URL

Titolo

Etichette

Ora di creazione:

Entità

Connettore

BlueLiv - Threats Connector

Descrizione

Estrai le minacce alla sicurezza da BlueLiv. Il connettore recupera tutte le minacce più recenti dai moduli BlueLiv.

I filtri per la lista consentita e la lista nera funzionano con i tipi di moduli BlueLiv. Ad esempio, se vuoi ricevere minacce solo dai moduli di attivismo informatico, puoi attivare la lista consentita e digitare il nome del tipo "Attivismo informatico".

Per ogni tipo di modulo, esiste una struttura diversa di dati inseriti in Google SecOps. Modifica la mappatura nella tua istanza Google SecOps per soddisfare al meglio le tue esigenze. Assicurati di visualizzare i diversi valori "event_type" per ogni evento restituito da BlueLiv.

Per il tipo di minaccia Malware, al momento forniamo solo i dati di base sugli eventi. A breve aggiungeremo un evento aggiuntivo per gestire meglio i dati speciali restituiti da un tipo di minaccia malware.

Configura BlueLiv - Threats Connector in Google SecOps

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

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome campo prodotto Stringa ProductName Inserisci il nome del campo di origine per recuperare il nome del campo prodotto.
Nome campo evento Stringa event_type Inserisci il nome del campo di origine per recuperare il nome del campo evento.
Nome campo ambiente Stringa "" No

Descrive il nome del campo in cui è memorizzato il nome dell'ambiente.

Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.

Pattern regex ambiente Stringa .* No

Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente".

Il valore predefinito è .* per acquisire tutto e restituire il valore invariato.

Utilizzato per consentire all'utente di manipolare il campo dell'ambiente tramite la logica delle espressioni regolari.

Se il pattern regex è null o vuoto oppure il valore dell'ambiente è null, il risultato finale dell'ambiente è l'ambiente predefinito.

Timeout dello script (secondi) Numero intero 180 Limite di timeout per il processo Python che esegue lo script corrente.
URL API Stringa https://example.blueliv.com/api/v2 Root API dell'istanza BlueLiv.
Nome utente Stringa N/D Nome utente per BlueLiv
Password Password N/D Password utente per BlueLiv
ID organizzazione Stringa N/D Specifica l'ID organizzazione da utilizzare in BlueLiv
Recupero ore massime a ritroso Numero intero 1 No Numero di ore da cui recuperare gli eventi.
Numero massimo di minacce da recuperare Numero intero 10 No

Il numero di minacce da elaborare per un'iterazione del connettore.
Nota: il valore massimo qui è 100.

Gravità Stringa Media

La gravità sarà uno dei seguenti valori: Bassa, Media, Alta, Critica.
Verrà assegnata agli avvisi di Google SecOps creati da questo connettore.

Risultati dell'analisi da importare Stringa (valori: NOT_AVAILABLE, NOT_IMPORTANT, NOT_PROCESSABLE, POSITIVE, NEGATIVE, INFORMATIVE, IMPORTANT) N/D No

Filtra le minacce in base all'analisi dell'analista relativa a questa minaccia, inserisci solo le minacce con il risultato dell'analisi scelto. Fornisci un elenco separato da virgole dei risultati dell'analisi che vuoi importare.
Valori possibili: NOT_AVAILABLE, NOT_IMPORTANT, NOT_PROCESSABLE, POSITIVE, NEGATIVE, INFORMATIVE, IMPORTANT

Etichette da utilizzare come filtro Stringa (elenco separato da virgole) N/D No Fornisci un elenco separato da virgole dei nomi delle etichette in base alle quali vuoi filtrare. Presta attenzione alle lettere maiuscole e minuscole e scrivi le etichette esattamente come appaiono nell'interfaccia utente di BlueLiv.
Stato di lettura da importare Stringa (valori: "Only Read", "Only Unread") N/D No Filtra le minacce in base al loro stato di lettura, in modo che il connettore le acquisisca di conseguenza. Se non viene fornito alcun valore, recupereremo entrambi. Opzioni: "Solo letti", "Solo non letti".
Should Ingest only starred threats? Casella di controllo Deselezionata No Se selezionata, verranno importate solo le minacce contrassegnate con una stella (preferite)
Should Ingest threats related to incidents? Stringa (values:, Only Incidents, Only Non Incidents) N/D No Il connettore deve filtrare le minacce controllando la relazione con un incidente. Se non viene fornito alcun valore, verranno recuperati entrambi. Le opzioni sono: Only Incidents (Solo incidenti) per importare solo le minacce correlate agli incidenti e Only Non Incidents (Solo non incidenti) per importare solo le minacce non correlate agli incidenti.
Utilizzare la lista consentita come lista nera Casella di controllo Deselezionata Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL Casella di controllo Deselezionata Se abilitato, verifica che il certificato SSL per la connessione al server BlueLiv sia valido.
Indirizzo del server proxy Stringa N/D No L'indirizzo del server proxy da utilizzare.
Nome utente proxy Stringa N/D No Il nome utente del proxy con cui eseguire l'autenticazione.
Password proxy Password N/D No La password del proxy per l'autenticazione.

Regole del connettore

Supporto proxy

Il connettore supporta il proxy.

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