--- title: "Integrando Datos de Cato con TrendAI" slug: "integrating-cato-data-with-trendai" updated: 2026-10-23T23:16:17Z published: 2026-10-23T23:16:17Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-trendai" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrando Datos de Cato con TrendAI > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## "Resumen" Utiliza la integración de TrendAI para analizar datos de red y seguridad de Cato junto con otros datos de seguridad en TrendAI Vision One Agentic SIEM. La integración nativa envía datos a través de HTTPS a un colector de eventos HTTP de TrendAI, para que tu SOC pueda buscar registros de Cato y utilizarlos en su control y flujos de trabajo de investigación. Configuras la integración en la Aplicación de Gestión de Cato (CMA). Cato envía matrices JSON con `Content-Type: application/json` y se autentica con un token de portador generado en TrendAI. ### Fuentes de Datos de TrendAI Puedes seleccionar **Eventos**, **Flujos**, o ambos: - **Eventos:** Registros de actividad de red y seguridad, como coincidencias de políticas, amenazas, cambios de conectividad y actividad de auditoría. - **Flujos:** Registros de flujo de red que añaden contexto de aplicación y usuario, y detalles de sesión agregados, como bytes, paquetes y duración. Cada registro incluye un campo `data_source` con el valor `events` o `flows`. Los datos de flujo pueden generar significativamente más volumen que los datos de eventos, dependiendo de tu tráfico. ### "Requisitos previos" - Permiso de Editor para **Integraciones** en la sección de **Recursos** de la CMA. Para más información, consulte [Gestión de Roles de Administrador Usando RBAC](/v1/docs/managing-admin-roles-using-rbac). - Un arrendatario de TrendAI Vision One con Agentic SIEM y permiso para configurar repositorios y coleccionistas de eventos HTTP. - Suficientes créditos Agentic SIEM para la ingesta de datos de terceros y la retención requerida. - Los requisitos previos descritos en [Comenzando con las Integraciones de Eventos](/v1/docs/getting-started-with-event-integrations), incluyendo cualquier lista de permitidos de IP requerida. ## Casos de Uso Estos ejemplos asumen que las fuentes de datos relevantes se ingieren y los campos utilizados para correlacionar registros se analizan de manera consistente. ### Eventos Comenzando desde una alerta de endpoint de TrendAI, busca eventos de Cato en el Explorador de Datos XDR para información de host, dirección IP y tiempo coincidente y para investigar actividades de red relacionadas. ### Flujos Revisa los flujos de Cato alrededor de la alerta de endpoint para evaluar qué destinos contactó el host y cuánto datos transfirió. ## Creación de la Integración de TrendAI Crea un colector de recolección de eventos HTTP en un repositorio de TrendAI, prueba su punto de conexión con curl, luego usa su URL de punto de conexión y token JWT para configurar la integración en el CMA. ### Paso 1: Crear el Colector de Eventos HTTP en TrendAI **Para preparar el destino de TrendAI:** 1. Inicia sesión en TrendAI Vision One y ve a **Agentic SIEM & XDR > Fuente de Datos y Gestión de Registro > Repositorios de registros de terceros**. 2. Crea un repositorio de registros o abre uno existente. Selecciona la configuración de ingesta y retención que coincida con cómo piensas usar los datos. No puedes cambiar el tipo de ingesta de un repositorio después de su creación. La ingesta analítica admite análisis, correlación y búsqueda de amenazas; la ingesta de archivo está destinada a consultas infrecuentes y requisitos de retención. 3. En el panel del repositorio, abre la pestaña **Recolectores** y haz clic en **Agregar recolector**. 4. Selecciona el proveedor y producto para los datos de Cato, elige **JSON** como el formato de registro, y selecciona la zona horaria utilizada por los registros. 5. Introduce un nombre para el colector y una descripción. 6. Selecciona **recolección de eventos HTTP** como el método y copia la URL del endpoint generado `/hec` para el recolector. 7. Haga clic en **Agregar**. 8. En la pantalla de **Generar token JWT**, selecciona el período de expiración y haz clic en **Generar token**. 9. Copia el token, guárdalo de manera segura y haz clic en **Cerrar**. 10. En la pestaña **Recolectores** del repositorio, verifica los detalles del recolector y la URL del punto de conexión. ### Paso 2: Prueba el Endpoint con curl Antes de configurar la integración en el CMA, envía una solicitud de prueba directamente a TrendAI. Esto ayuda a aislar problemas de punto de conexión y autenticación de la integración de Cato. **Para probar el endpoint:** 1. Usa la URL completa del endpoint generada `/hec` del Paso 1 en lugar de la URL de ejemplo. Introduce el token JWT del colector en el mensaje oculto. 2. Actualiza las marcas de tiempo de muestra a la hora UTC actual, luego ejecuta el siguiente comando: Ejecuta todo el ejemplo en un shell interactivo **Bash** (ejecuta `bash` primero si es necesario). Introduce las credenciales en los mensajes ocultos; no las insertes en el comando. El ejemplo deshabilita la traza del shell y pasa los encabezados de autenticación a través de la entrada estándar utilizando `--header @-`, manteniendo las credenciales fuera del historial de shell y argumentos de línea de comandos de curl. Las variables de credenciales temporales se descartan cuando el ejemplo termina. ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_TOKEN  IFS= read -r -s -p 'Token JWT de TrendAI: ' CATO_TEST_TOKEN  builtin printf '\n' >&2  case "$CATO_TEST_TOKEN" in    ''|*$'\r'*) builtin printf 'Ingrese una credencial no vacía sin caracteres de retorno.\n' >&2; exit 1 ;;  esac  builtin printf '%s\n' "Authorization: Bearer ${CATO_TEST_TOKEN}" | \    curl -q --fail --show-error --include --max-time 30 -X POST 'https:///ingest/api/v1/third_party_log/hec' \  --header @- \  -H "Content-Type: application/json" \  -d '[{"timestamp": "2026-04-07T10:00:03Z", "msg": "línea de registro json 1"},{"timestamp": "2026-04-07T10:00:05Z", "msg": "línea de registro json 2"}]' ) ``` 3. Verifique la respuesta HTTP para detectar un error. Una solicitud exitosa devuelve un estado HTTP 2xx. 4. En TrendAI, busque `línea de registro json 1` y `línea de registro json 2` en el repositorio de destino. Confirme que ambos registros aparecen por separado. Esta prueba verifica si el destino acepta la solicitud de muestra. Verifique los datos de Cato y el análisis después de configurar la integración a continuación. ### Paso 3: Crear la Integración en el CMA **Para crear la integración TrendAI:** 1. Desde el menú de navegación del CMA, vaya a **Recursos > Integraciones**. 2. Abra la pestaña **Integraciones Configuradas** y haga clic en **Nuevo**. 3. Seleccione **TrendAI** y la capacidad de **Exportación de Datos**. 4. Ingrese un **Nombre** y una **Descripción** opcional. 5. Para **URL de Ingestión**, pegue el URL completo generado del endpoint `/hec` desde el colector TrendAI. 6. Para el **Token de Portador**, pegue el token JWT del colector. Ingrese solo el token; Cato agrega el prefijo `Bearer`. 7. En **Fuentes de Datos**, selecciona **Eventos**, **Flujos**, o ambos. 8. (Opcionalmente) Configure filtros de eventos y flujos para controlar qué registros se envían. Consulte [Filtros](/docs/es/integrating-cato-data-with-trendai#filters). 9. Haga clic en **Guardar**. Cato almacena el token cifrado y no lo muestra de nuevo. Actualice la integración cuando rote el token JWT. Cato se autentica con el JWT usando el encabezado `Authorization: Bearer <token>`. ### Paso 4: Verificar Ingestión y Análisis **Para verificar que los datos de Cato lleguen a TrendAI:** 1. En el CMA, revise el estado de la integración. Actualice la página si es necesario y verifique si hay errores de autenticación o del destino. 2. En TrendAI, abra el repositorio y revise el estado del colector y la información de ingestión. 3. Generar un evento reciente de Cato o tráfico de red para cada fuente de datos seleccionada. 4. Abrir **XDR Data Explorer** y buscar registros recientes de Cato usando un valor distintivo o el campo `data_source`. Permitir varios minutos para la ingestión. 5. Verificar que los registros aparezcan individualmente y que sus marcas de tiempo y campos analizados coincidan con la actividad de Cato. Para cada fuente seleccionada, confirmar el valor correspondiente de `events` o `flows`. ## Filtros Utilizar filtros de eventos y flujos para limitar los datos de Cato exportados a TrendAI. Esto ayuda a controlar el volumen de ingestión y enfocar las investigaciones en la actividad relevante. Dentro de un grupo, las condiciones de filtro usan lógica Y. Grupos separados utilizan lógica O. - **Filtro de eventos:** Haga clic en **Agregar filtro** para definir una condición, o **Agregar grupo** para añadir otro grupo de filtros. - **Filtro de flujos:** Disponible cuando se selecciona **Flujos**. Utiliza la misma lógica de agrupamiento que el filtro de eventos. Filtros demasiado restrictivos pueden excluir todos los registros sin informar un error. Si no llegan datos, verifique las fuentes de datos seleccionadas y las condiciones de filtro. ## Limitaciones Conocidas - La ingestión de datos de terceros utiliza créditos de Agentic SIEM. La retención más allá del período predeterminado requiere créditos adicionales. - El tipo de ingestión de un repositorio no puede cambiarse después de la creación. Para usar un tipo de ingestión diferente, cree otro repositorio. - Si el token JWT expira o es revocado, la entrega se detiene hasta que actualice el token en el CMA. - No se puede personalizar el formato, tipo de contenido o encabezado de autenticación de la solicitud de integración de Cato. ## Resolución de problemas | Incidente | Solución | | --- | --- | | La autenticación falla con HTTP 401 o 403 | Confirme que el token JWT pertenece al recolector de destino y no ha expirado o sido revocado. Genere un reemplazo si es necesario y actualice **Bearer Token** en el CMA. | | El destino es inalcanzable | Copie la URL completa del endpoint desde los detalles del recolector de TrendAI, y confirme que el recolector esté disponible en su tenant. | | El destino devuelve HTTP 400 o 415 | Confirme que el endpoint sea la URL `/hec` generada para este colector, que el token sea un JWT válido y no expirado, y que el cuerpo de la solicitud sea un array JSON. Cato envía el cuerpo con `Content-Type: application/json`. | | La integración parece estar bien pero no llegan datos | Revise la selección de fuentes de datos y filtros, genere actividades coincidentes en Cato y verifique la información de ingesta y configuración del repositorio del colector TrendAI. | | Solo llegan eventos o solo llegan flujos | Verifique que las fuentes requeridas estén seleccionadas y que sus filtros permitan la coincidencia de registros. Confirme que cada fuente se envíe al destino configurado para ello. | | Llegan los registros pero los campos no se analizan | Revise las selecciones de proveedor, producto y formato de registro del colector contra la configuración utilizada en el Paso 1. | ## Recursos adicionales - [TrendAI: Recolección de Eventos HTTP](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-dslm-tlc-api) - [TrendAI: Repositorios](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-log-repositories)