Trend Micro Cloud App Security

En este documento, se proporcionan instrucciones para integrar Trend Micro Cloud App Security en Google SecOps.

Casos de uso de productos

Realizar acciones activas: enriquecer entidades, buscar correos electrónicos, actualizar la lista de bloqueo, mitigar correos electrónicos o cuentas, etcétera

Cómo generar un token de API

  1. Navega a Administración > APIs de automatización y de integración.
  2. Presiona el botón "Agregar".
  3. Selecciona "Para aplicación externa".
  4. Proporciona un "Nombre" y selecciona todas las casillas de verificación.
  5. Presiona "Crear token".
  6. Copia el "Token".
  7. Actualiza el parámetro "Clave de API" en la configuración de la integración.
  8. Probar la conectividad

Configura la integración de Trend Micro Cloud App Security en Google Security Operations

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API String https://api-eu.tmcas.trendmicro.com Sí Es la raíz de la API de la instancia de Trend Micro Cloud App Security.
Clave de API Contraseña N/A Sí Es la clave de API de la instancia de Trend Micro Cloud App Security.
Verificar SSL Casilla de verificación Marcado Sí Si se habilita, se verifica que el certificado SSL para la conexión con el servidor de Trend Micro Cloud App Security sea válido.

Acciones

Ping

Descripción

Prueba la conectividad con Trend Micro Cloud App Security con los parámetros proporcionados en la página de configuración de la integración en la página de Google SecOps Content Hub.

Parámetros

N/A

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

Si se realiza correctamente (is success = true): Se estableció la conexión con el servidor de Trend Micro Cloud App Security con los parámetros de conexión proporcionados.

Si no se realiza correctamente (is success = false), no se pudo establecer la conexión con el servidor de Trend Micro Cloud App Security. Error: {0}".format(exception.stacktrace)

 General

Agrega entidades a la lista de entidades bloqueadas

Descripción

Agrega entidades a una lista de entidades bloqueadas en Trend Micro Cloud App Security. Entidades admitidas: URL, hash y correo electrónico (entidad de usuario que coincide con el patrón de dirección de correo electrónico).

Parámetros

Nombre Valor predeterminado Es obligatorio Descripción
N/A N/A N/A N/A

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Hash
  • Correo electrónico

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Muro de casos
Caso Listo Reprobada Mensaje
Si se realiza correctamente para 1 entidad verdadero falso Se agregaron correctamente las siguientes entidades a la lista de entidades bloqueadas en Trend Micro Cloud App Security: {\n entity.identifier}
Si no se realiza correctamente para 1 entidad verdadero falso La acción no pudo agregar las siguientes entidades a la lista de entidades bloqueadas en Trend Micro Cloud App Security: {\n entity.identifier}
Si hay duplicados verdadero falso Las siguientes entidades ya forman parte de la lista de entidades bloqueadas en Trend Micro Cloud App Security: {\n entity.identifier}
no es exitoso para todos falso falso No se agregaron entidades con información de Trend Micro Cloud App Security
Error grave, credenciales no válidas, raíz de la API falso verdadero Se produjo un error cuando se ejecutaba la acción "Agregar entidades a la lista de entidades bloqueadas". Motivo: {error traceback}

Mitiga los correos electrónicos

Descripción

Borra o pon en cuarentena los correos electrónicos con Trend Micro Cloud App Security. Nota: En Gmail, solo puedes borrar correos electrónicos.

Parámetros

Nombre Valor predeterminado Es obligatorio Descripción
IDs de mensaje N/A Sí Especifica una lista separada por comas de los IDs de los mensajes que se deben mitigar.
Acción de mitigación

Borrar

Valores posibles:

Borrar

Poner los correos electrónicos en cuarentena

 Sí Especifica qué acción de mitigación se debe aplicar.
Servicio

Gmail

Valores posibles

Gmail

Intercambio

 Sí Especifica el servicio que se usa para los correos electrónicos.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Muro de casos
Caso Listo Reprobada Mensaje
Si se realiza correctamente para 1 message_id Verdadero falso Se mitigaron correctamente los siguientes correos electrónicos en Trend Micro Cloud App Security: {\n IDs de mensajes únicos}
Si no se realiza correctamente para 1 message_id Verdadero falso La acción no pudo mitigar los siguientes correos electrónicos en Trend Micro Cloud App Security: {\n unique message ids}
no es exitoso para todos falso falso Trend Micro Cloud App Security no mitigó ningún correo electrónico.
Error grave, credenciales no válidas, raíz de la API falso verdadero Se produjo un error cuando se ejecutaba la acción "Mitigar correos electrónicos". Motivo: {error traceback}
Si se selecciona "Cuarentena" y el servicio es "Gmail" falso verdadero Se produjo un error cuando se ejecutaba la acción "Mitigar correos electrónicos". Motivo: Solo puedes borrar correos electrónicos en el servicio de Gmail.

Descripción

Busca correos electrónicos según las entidades en Trend Micro Cloud App Security. Entidades admitidas: URL, hash, correo electrónico (entidad de usuario que coincide con el patrón de dirección de correo electrónico), asunto del correo electrónico, nombre de archivo, IP.

Parámetros

Nombre Valor predeterminado Es obligatorio Descripción
Cantidad máxima de días hacia atrás 30 No Especifica cuántos días hacia atrás se deben buscar correos electrónicos. El máximo es 90. Cantidad predeterminada: 30.
Cantidad máxima de correos electrónicos que se devolverán 100 No Especifica cuántos correos electrónicos se deben devolver. Valor predeterminado: 100.

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Hash
  • Correo electrónico
  • Asunto del correo electrónico
  • Nombre del archivo
  • Dirección IP

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
emails=[{list of unique emails}]
Muro de casos
Caso Listo Reprobada Mensaje
si hay datos disponibles: verdadero falso Se devolvió correctamente la información sobre los correos electrónicos relacionados con las entidades proporcionadas en Trend Micro Cloud App Security.
si los datos no están disponibles falso falso No se encontró información sobre los correos electrónicos relacionados con las entidades en Trend Micro Cloud App Security.
Error grave, credenciales no válidas, raíz de la API falso verdadero Se produjo un error cuando se ejecutaba la acción "Búsqueda de correo electrónico de entidad". Motivo: {error traceback}
Si "Cantidad máxima de días hacia atrás" > 90 falso verdadero Se produjo un error cuando se ejecutaba la acción "Búsqueda de correo electrónico de entidad". Motivo: El valor de "Cantidad máxima de días hacia atrás" debe estar entre 1 y 90.

Enriquece entidades

Descripción

Enriquece las entidades con información de Trend Micro Cloud App Security. Entidades admitidas: URL, hash y correo electrónico (entidad de usuario que coincide con el patrón de dirección de correo electrónico).

Parámetros

Nombre Valor predeterminado Es obligatorio Descripción
N/A N/A N/A N/A

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Hash
  • Correo electrónico

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
Muro de casos
Caso Listo Reprobada Mensaje
Si se realiza correctamente para 1 entidad verdadero falso Se recuperó correctamente la información sobre las siguientes entidades de Trend Micro Cloud App Security: {\n entity.identifier}
Si no se realiza correctamente para 1 entidad verdadero falso La acción no pudo recuperar información sobre las siguientes entidades de Trend Micro Cloud App Security: {\n entity.identifier}
no es exitoso para todos falso falso No se enriquecieron entidades con información de Trend Micro Cloud App Security
Error grave, credenciales no válidas, raíz de la API falso verdadero Se produjo un error cuando se ejecutaba la acción "Enrich Entities". Motivo: {error traceback}

Mitiga las cuentas

Descripción

Realiza acciones de mitigación en la cuenta de usuario a través de Trend Micro Cloud App Security.

Parámetros

Nombre Valor predeterminado Es obligatorio Descripción
Direcciones de correo electrónico N/A Sí Especifica una lista separada por comas de las direcciones de correo electrónico que se deben mitigar.
Acción de mitigación

Inhabilitar cuenta

Habilitar la MFA

Restablecer contraseña

Revocar sesiones de acceso

 Sí Especifica qué acción de mitigación se debe aplicar.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Muro de casos
Caso Listo Reprobada Mensaje
si se realiza correctamente para 1 dirección de correo electrónico. verdadero falso Se mitigaron correctamente las siguientes cuentas en Trend Micro Cloud App Security: {\n direcciones de correo electrónico}
Si no se realiza correctamente para 1 entidad verdadero falso La acción no pudo mitigar las siguientes cuentas en Trend Micro Cloud App Security: {\n direcciones de correo electrónico}
no es exitoso para todos falso falso No se mitigó ninguna cuenta con la información de Trend Micro Cloud App Security.
Mensaje asíncrono falso falso Esperando a que finalicen las acciones de mitigación…
Error grave, credenciales no válidas, raíz de la API falso verdadero Se produjo un error cuando se ejecutaba la acción "Mitigar cuenta". Motivo: {error traceback}

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.