Trend Micro Cloud App Security

Questo documento fornisce indicazioni su come integrare Trend Micro Cloud App Security con Google SecOps.

Casi d'uso del prodotto

Eseguire azioni attive: arricchire entità, cercare email, aggiornare l'elenco bloccati, mitigare email/account.

Come generare un token API

  1. Vai ad Amministrazione > API di Automation e integrazione.
  2. Premi il pulsante "Aggiungi".
  3. Seleziona "Per applicazione esterna".
  4. Inserisci un nome e seleziona tutte le caselle di controllo.
  5. Premi "Crea token".
  6. Copia "Token".
  7. Aggiorna il parametro "Chiave API" nella configurazione dell'integrazione.
  8. Testa la connettività.

Configura l'integrazione di Trend Micro Cloud App Security 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 https://api-eu.tmcas.trendmicro.com Sì Radice dell'API dell'istanza Trend Micro Cloud App Security.
Chiave API Password N/D Sì Chiave API dell'istanza Trend Micro Cloud App Security.
Verifica SSL Casella di controllo Selezionata Sì Se l'opzione è attiva, verifica che il certificato SSL per la connessione al server Trend Micro Cloud App Security sia valido.

Azioni

Dindin

Descrizione

Testa la connettività a Trend Micro Cloud App Security 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 è andata a buon fine (is success = true): connessione al server Trend Micro Cloud App Security stabilita con i parametri di connessione forniti.

Se non va a buon fine (is success = false) - Failed to connect to the Trend Micro Cloud App Security server! Error: {0}".format(exception.stacktrace)

 Generale

Aggiungi entità alla lista bloccata

Descrizione

Aggiungi entità a una lista bloccata in Trend Micro Cloud App Security. Entità supportate: URL, hash ed email (entità utente che corrisponde al pattern dell'indirizzo email).

Parametri

Nome Valore predefinito Is Mandatory Descrizione
N/D N/D N/D N/D

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Hash
  • Email

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 entità true false Le seguenti entità sono state aggiunte alla lista bloccata in Trend Micro Cloud App Security: {\n entity.identifier}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita ad aggiungere le seguenti entità alla lista bloccata in Trend Micro Cloud App Security: {\n entity.identifier}
Se i duplicati true false Le seguenti entità fanno già parte della lista bloccata in Trend Micro Cloud App Security: {\n entity.identifier}
non hanno avuto successo per tutti false false Nessuna entità è stata aggiunta utilizzando le informazioni di Trend Micro Cloud App Security
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Aggiungi entità alla lista bloccata". Motivo: {error traceback}

Mitigate Emails

Descrizione

Elimina o metti in quarantena le email utilizzando Trend Micro Cloud App Security. Nota: per Gmail puoi solo eliminare le email.

Parametri

Nome Valore predefinito Is Mandatory Descrizione
ID messaggio N/D Sì Specifica un elenco separato da virgole di ID messaggio che devono essere mitigati.
Azione di mitigazione

Elimina

Valori possibili:

Elimina

Quarantena

 Sì Specifica l'azione di mitigazione da applicare.
Servizio

Gmail

Valori possibili

Gmail

Exchange

 Sì Specifica il servizio utilizzato per le email.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 message_id Vero false Mitigazione delle seguenti email in Trend Micro Cloud App Security riuscita: {\n unique message ids}
Se non va a buon fine per 1 message_id Vero false L'azione non è riuscita a mitigare le seguenti email in Trend Micro Cloud App Security: {\n ID messaggio univoci}
non hanno avuto successo per tutti false false Nessuna email è stata mitigata da Trend Micro Cloud App Security.
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Mitiga email". Motivo: {error traceback}
Se è selezionata l'opzione "Quarantena" e il servizio è "Gmail" false true Errore durante l'esecuzione dell'azione "Mitiga email". Motivo: puoi eliminare le email solo nel servizio Gmail.

Descrizione

Cerca le email in base alle entità in Trend Micro Cloud App Security. Entità supportate: URL, hash, email (entità utente che corrisponde al pattern dell'indirizzo email), oggetto dell'email, nome file, IP.

Parametri

Nome Valore predefinito Is Mandatory Descrizione
Numero massimo di giorni indietro 30 No Specifica quanti giorni indietro cercare le email. Il valore massimo è 90. Valore predefinito: 30.
Numero massimo di email da restituire 100 No Specifica il numero di email da restituire. Valore predefinito: 100.

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Hash
  • Email
  • Oggetto email
  • Nome file
  • Indirizzo IP

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
emails=[{list of unique emails}]
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se i dati sono disponibili: true false Informazioni sulle email relative alle entità fornite in Trend Micro Cloud App Security restituite correttamente.
se i dati non sono disponibili false false Non sono state trovate informazioni sulle email relative alle entità in Trend Micro Cloud App Security.
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Ricerca email entità". Motivo: {error traceback}
"Max Days Backwards" > 90 false true Errore durante l'esecuzione dell'azione "Ricerca email entità". Motivo: "Numero massimo di giorni precedenti" deve essere compreso tra 1 e 90.

Arricchisci le entità

Descrizione

Arricchisci le entità con le informazioni di Trend Micro Cloud App Security. Entità supportate: URL, hash ed email (entità utente che corrisponde al pattern dell'indirizzo email).

Parametri

Nome Valore predefinito Is Mandatory Descrizione
N/D N/D N/D N/D

Esegui il

Questa azione viene eseguita sulle seguenti entità:

  • URL
  • Hash
  • Email

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione ha esito positivo per 1 entità true false Informazioni sulle seguenti entità recuperate correttamente da Trend Micro Cloud App Security: {\n entity.identifier}
se non è andata a buon fine per 1 entità true false L'azione non è riuscita a recuperare informazioni sulle seguenti entità da Trend Micro Cloud App Security: {\n entity.identifier}
non hanno avuto successo per tutti false false Nessuna entità è stata arricchita utilizzando le informazioni di Trend Micro Cloud App Security
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Arricchisci entità". Motivo: {error traceback}

Mitigate Accounts

Descrizione

Eseguire azioni di mitigazione sull'account utente tramite Trend Micro Cloud App Security.

Parametri

Nome Valore predefinito Is Mandatory Descrizione
Indirizzi email N/D Sì Specifica un elenco separato da virgole di indirizzi email che devono essere mitigati.
Azione di mitigazione

Disabilita account

Abilita MFA

Reimposta password

Revoca sessioni di accesso

 Sì Specifica l'azione di mitigazione da applicare.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Bacheca casi
Richiesta Operazione riuscita Fail Messaggio
se l'operazione va a buon fine per un indirizzo email. true false Mitigazione riuscita dei seguenti account in Trend Micro Cloud App Security: {\n indirizzi email}
se non è andata a buon fine per 1 entità true false L'azione non è stata in grado di mitigare i seguenti account in Trend Micro Cloud App Security: {\n indirizzi email}
non hanno avuto successo per tutti false false Nessun account è stato mitigato utilizzando le informazioni di Trend Micro Cloud App Security.
Messaggio asincrono false false In attesa del completamento delle azioni di mitigazione…
Errore irreversibile, credenziali non valide, radice API false true Errore durante l'esecuzione dell'azione "Mitiga account". Motivo: {error traceback}

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