Trend Micro Apex Central

Questo documento fornisce indicazioni su come integrare Trend Micro Apex Central con Google SecOps.

Come ottenere la chiave API

Per saperne di più su come ottenere la chiave API, consulta Aggiunta di un'applicazione.

Configura l'integrazione di Trend Micro Apex Central in 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 http://x.x.x.x Sì Radice API dell'istanza Trend Micro Apex Central.
ID applicazione Stringa N/D Sì ID applicazione dell'istanza Trend Micro Apex Central.
Chiave API Password N/D Sì Chiave API dell'istanza Trend Micro Apex Central.
Verifica SSL Casella di controllo Selezionata Sì Se l'opzione è attiva, verifica che il certificato SSL per la connessione al server Trend Micro Apex Central sia valido.

Azioni

Dindin

Descrizione

Testa la connettività a Trend Micro Apex Central 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 del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

Se l'operazione va a buon fine:
print Successfully connected to the Trend Micro Apex Central server with the provided connection parameters!

Non riuscito: impossibile connettersi al server Trend Micro Apex Central. Error: {0}".format(exception.stacktrace)

Generale

Arricchisci le entità

Descrizione

Arricchisci le entità con le informazioni di Trend Micro Apex Central. Entità supportate: indirizzo IP, indirizzo MAC, nome host, URL, hash.

Parametri

entità
Nome Valore predefinito Is Mandatory Descrizione
Crea insight sugli endpoint Vero No Se abilitata, l'azione creerà un insight contenente le informazioni relative agli endpoint arricchiti.
Crea insight UDSO Vero No Se abilitata, l'azione creerà un insight contenente le informazioni relative alle entità che corrispondono all'UDSO.
Contrassegna le entità UDSO Vero NoSe abilitata, l'azione contrassegnerà come sospette tutte le entità visualizzate nell'elenco degli oggetti sospetti definiti dall'utente.
Estrai dominio Falso No Se abilitata, l'azione estrarrà la parte del dominio dell'entità URL e la utilizzerà per l'arricchimento.

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Indirizzo MAC
  • Nome host
  • URL
  • Hash

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Arricchimento delle entità

Host, IP, MAC

Nome del campo di arricchimento Logica - Quando applicarle
ip_address Restituisce se esiste nel risultato JSON.
mac_address Restituisce se esiste nel risultato JSON.
nome host Restituisce se esiste nel risultato JSON.
has_endpoint_sensor Restituisce se esiste nel risultato JSON.
isolation_status Restituisce se esiste nel risultato JSON.
ad_domain Restituisce se esiste nel risultato JSON.

URL, hash, IP

Nome del campo di arricchimento Logica - Quando applicarle
tipo Restituisce se esiste nel risultato JSON.
nota Restituisce se esiste nel risultato JSON.
azione Restituisce se esiste nel risultato JSON.
scadenza Restituisce se esiste nel risultato JSON.
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 l'operazione ha esito positivo per 1 entità: Informazioni sulle seguenti entità recuperate correttamente da Trend Micro Apex Central: {\n entity.identifier}

  • Se non va a buon fine per 1 entità - L'azione non è riuscita a recuperare informazioni sulle seguenti entità da Trend Micro Apex Central: {\n entity.identifier}

  • Non riuscito per tutti: nessuna entità è stata arricchita utilizzando le informazioni di Trend Micro Apex Central

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

  • Errore irreversibile, credenziali non valide, radice API - Errore durante l'esecuzione dell'azione "Arricchisci entità". Motivo: {error traceback}
Generale
Tabella della bacheca casi

Nome: Found Endpoints

Colonna:

Indirizzo IP

Indirizzo MAC

Nome host

Has Endpoint Sensor

Stato di isolamento

Dominio AD

(Host, IP, MAC)
Tabella della bacheca casi

Nome: Found UDSO

Colonna:

Entità

Nota

Azione

(URL, hash, IP)

Crea file UDSO

Descrizione

Crea un oggetto sospetto definito dall'utente in base a un file in Trend Micro Apex Central.

Problemi noti

Quando si utilizzano file .eml, l'azione non restituirà il risultato JSON.

Parametri

Nome Valore predefinito Is Mandatory Descrizione
Percorsi file N/D Sì Specifica un elenco separato da virgole di percorsi file da utilizzare per creare un UDSO.
Azione

Blocca

Valori possibili:

Blocca

Log

Quarantena

Sì Specifica l'azione da applicare all'UDSO.
Nota N/D Falso Specifica una nota aggiuntiva per l'UDSO fornito. Avviso: la nota non può contenere più di 256 caratteri.
Scadenza (giorni) N/D Falso Specifica tra quanti giorni deve scadere l'UDSO. Se non viene fornito alcun valore, l'UDSO non scadrà mai.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione va a buon fine per 1 file true false Creazione dell'UDSO basato sui seguenti file in Trend Micro Apex Central riuscita: {\n percorsi file}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita a creare l'UDSO in base ai seguenti file in Trend Micro Apex Central: {\n percorsi file}
Se esiste già true false I seguenti UDSO esistono già in Trend Micro Apex Central: {\n percorsi file}
non hanno avuto successo per tutti false false Non sono stati creati UDSO in Trend Micro Apex Central.
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Crea UDSO file". Motivo: {error traceback}
Se la nota è superiore a 256 caratteri false true Errore durante l'esecuzione dell'azione "Crea UDSO file". Motivo: la nota non può contenere più di 256 caratteri.

Crea UDSO entità

Descrizione

Crea un oggetto sospetto definito dall'utente in base alle entità in Trend Micro Apex Central. Entità supportate: IP, URL, hash.

Parametri

Nome Valore predefinito Is Mandatory Descrizione
Azione

Blocca

Valori possibili:

Blocca

Log

Sì Specifica l'azione da applicare all'UDSO.
Nota N/D Falso Specifica una nota aggiuntiva per l'UDSO fornito. Avviso: la nota non può contenere più di 256 caratteri.
Scadenza (giorni) N/D Falso Specifica tra quanti giorni deve scadere l'UDSO. Se non viene fornito alcun valore, l'UDSO non scadrà mai.

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • URL
  • Hash

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 entità true false Creazione di un UDSO basato sulle seguenti entità in Trend Micro Apex Central: {\n entity.identifier}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita a creare l'UDSO in base alle seguenti entità in Trend Micro Apex Central: {\n entity.identifier}
Se esiste già true false I seguenti UDSO esistono già in Trend Micro Apex Central: {\n entity.identifier}
non hanno avuto successo per tutti false false Non sono stati creati UDSO in Trend Micro Apex Central.
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Crea UDSO entità". Motivo: {error traceback}
Se la nota è superiore a 256 caratteri false true Errore durante l'esecuzione dell'azione "Crea UDSO entità". Motivo: la nota non può contenere più di 256 caratteri.

Unisolate Endpoints

Descrizione

Annulla l'isolamento degli endpoint in Trend Micro Apex Central. Entità supportate: IP, Mac, nome host.

Parametri

Nome Valore predefinito È obbligatorio Descrizione
N/D N/D N/D N/D

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Indirizzo MAC
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 entità true false I seguenti endpoint sono stati isolati correttamente in Trend Micro Apex Central: {\n entity.identifier}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita a deisolare i seguenti endpoint in Trend Micro Apex Central: {\n entity.identifier}
non hanno avuto successo per tutti false false Nessun endpoint è stato deisolato in Trend Micro Apex Central.
Messaggio asincrono false false È stato avviato l'annullamento dell'isolamento dei seguenti endpoint: {entity.identifier}. In attesa del completamento dell'annullamento dell'isolamento.
Messaggio di timeout false false

L'azione ha avviato l'annullamento dell'isolamento, ma è ancora in attesa per i seguenti endpoint: {entity.identifier}.

Valuta la possibilità di aumentare il timeout nell'IDE.

Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Annulla l'isolamento degli endpoint". Motivo: {error traceback}

Isola gli endpoint

Descrizione

Isola gli endpoint in Trend Micro Apex Central. Entità supportate: IP, Mac, nome host.

Parametri

Nome Valore predefinito È obbligatorio Descrizione
N/D N/D N/D N/D

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Indirizzo MAC
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 entità true false I seguenti endpoint sono stati isolati in Trend Micro Apex Central: {\n entity.identifier}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita a isolare i seguenti endpoint in Trend Micro Apex Central: {\n entity.identifier}
non hanno avuto successo per tutti false false Nessun endpoint è stato isolato in Trend Micro Apex Central.
Messaggio asincrono false false Isolamento degli endpoint avviato sui seguenti endpoint: {entity.identifier}. In attesa del completamento dell'isolamento.
Messaggio di timeout true false

L'azione ha avviato l'isolamento, ma è ancora in attesa per i seguenti endpoint: {entity.identifier}.

Valuta la possibilità di aumentare il timeout nell'IDE.

Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Isola endpoint". Motivo: {error traceback}

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