Harmony Mobile

Questo documento fornisce indicazioni su come integrare Harmony Mobile con Google SecOps.

Casi d'uso

  1. Esegui l'arricchimento delle entità
  2. Importazione degli avvisi

Come generare l'ID client e il client secret

  1. Vai alla sezione "Harmony Endpoint"
  2. Vai a "Impostazioni globali".
  3. Vai alla sezione "Chiavi API"
  4. Premi il pulsante "Nuova".
  5. Seleziona il servizio "Harmony Mobile" e il ruolo "Sola lettura"
  6. Copia "Client ID" (ID client) e "Client Secret" (Client secret). Inserisci questi parametri nella configurazione dell'integrazione.

Configura l'integrazione di Harmony Mobile su Google Security Operations

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

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Root API Stringa https://cloudinfra-gw.portal.checkpoint.com Sì Radice dell'API dell'istanza Harmony Mobile.
ID client Stringa N/D Sì ID client dell'account Harmony Mobile.
Client secret Password N/D Sì Client secret dell'account Harmony Mobile.
Verifica SSL Casella di controllo Selezionata Sì Se attivata, verifica che il certificato SSL per la connessione al server Harmony Mobile sia valido.

Azioni

Dindin

Descrizione

Testa la connettività ad Harmony Mobile con i parametri forniti nella pagina di configurazione dell'integrazione nella pagina Google SecOps Content Hub.

Parametri

N/D

Esegui il

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 Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
se l'operazione va a buon fine: "Connessione al server Harmony Mobile con i parametri di connessione forniti riuscita."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:
if not successful: "Failed to connect to the Harmony Mobile server! Error is {0}".format(exception.stacktrace)

 Generale

Arricchisci le entità

Descrizione

Arricchisci le entità utilizzando le informazioni di Harmony Mobile. Entità supportate: nome host.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Crea insight Casella di controllo Selezionata No Se abilitata, l'azione creerà un insight contenente tutte le informazioni recuperate sull'entità.

Esegui il

Questa azione viene eseguita sull'entità Hostname.

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
{
    "client_version": "3.8.6.4637",
    "device_type": "Android",
    "email": "dana@example.com",
    "internal_id": 1,
    "last_connection": "Wed, 14 Jul 2021 05:26:09 +0000",
    "mail_sent": true,
    "mdm": null,
    "model": "HUAWEI / HUAWEI GRA-L09",
    "name": "Dana Doe",
    "number": "+11",
    "os_type": "Android_4_x",
    "os_version": "6.0",
    "risk": "No Risk",
    "status": "Active"
}
Arricchimento delle entità
Nome del campo di arricchimento Logica: quando applicare
client_version Se disponibile in JSON
device_type Se disponibile in JSON
email Se disponibile in JSON
last_connection Se disponibile in JSON
modello Se disponibile in JSON
nome Se disponibile in JSON
numero Se disponibile in JSON
os_type Se disponibile in JSON
os_version Se disponibile in JSON
risk Se disponibile in JSON
stato Se disponibile in JSON
Insight

Esempio di insight sull'entità

Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output

L'azione non deve fallire né interrompere l'esecuzione del playbook:
se sono disponibili dati per uno(is_success = true): "Entità seguenti arricchite con successo utilizzando le informazioni di Harmony Mobile: {entity.identifier}".

Se i dati non sono disponibili per un'entità (is_success=true): "L'azione non è riuscita ad arricchire le seguenti entità utilizzando le informazioni di Harmony Mobile: {entity.identifier}".

Se i dati non sono disponibili per tutte le entità (is_success=false): nessuna delle entità fornite è stata arricchita.

L'azione non dovrebbe riuscire e dovrebbe 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 "Arricchisci entità". Reason: {0}''.format(error.Stacktrace)

 Generale

Tabella della bacheca dei casi

 Titolo: {entity.identifier} Entità

Connettore

Harmony Mobile - Connettore degli avvisi

Descrizione

Estrarre informazioni sugli avvisi da Harmony Mobile. Nota: il filtro della lista consentita funziona con il parametro "alertEvent".

Configura Harmony Mobile - Connettore degli avvisi 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 visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Nome campo prodotto Stringa Nome prodotto Sì Inserisci il nome del campo di origine per recuperare il nome del campo del prodotto.
Nome campo evento Stringa alertType Sì 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 dell'ambiente Stringa .* No

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

Il valore predefinito è .* per rilevare 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 è nullo o vuoto o se il valore dell'ambiente è nullo, il risultato finale dell'ambiente è l'ambiente predefinito.
Timeout dello script (secondi) Numero intero 180 Sì Limite di timeout per il processo Python che esegue lo script corrente.
Root API Stringa https://cloudinfra-gw.portal.checkpoint.com Sì Radice dell'API dell'istanza Harmony Mobile.
ID client Stringa N/D Sì ID client dell'account Harmony Mobile.
Client secret Password N/D Sì Client secret dell'account Harmony Mobile.
Rischio di recupero minimo Numero intero Falso Rischio più basso che deve essere utilizzato per recuperare gli avvisi. Valori possibili: Informational, Low, Medium, High. Se non viene specificato nulla, il connettore importerà gli avvisi con tutti i livelli di rischio.
Numero massimo di ore indietro Numero intero 1 No Numero di ore da cui recuperare gli avvisi.
Numero massimo di avvisi da recuperare Numero intero 100 No Il numero di avvisi da elaborare per un'iterazione del connettore. Valore predefinito: 100.
Utilizza la lista consentita come lista bloccata Casella di controllo Deselezionata Sì Se questa opzione è attiva, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL Casella di controllo Selezionata Sì Se attivata, verifica che il certificato SSL per la connessione al server Harmony Mobile 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 con cui eseguire l'autenticazione.

Regole del connettore

Supporto dei proxy

Il connettore supporta il proxy.

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