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: 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 | No | Se 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:
L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:
|
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.