--- title: "Integrando Datos de Cato con Google SecOps" slug: "integrating-cato-data-with-google-secops" updated: 2026-10-23T23:16:19Z published: 2026-10-23T23:16:19Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-google-secops" --- > ## 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 Google SecOps > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## "Resumen" Utiliza la integración de Google SecOps para analizar datos de red y de seguridad de Cato junto con otros datos de telemetría de seguridad en Google Security Operations (Google SecOps, anteriormente Chronicle). La integración nativa envía datos directamente a un feed webhook HTTPS de Google SecOps para su monitorización e investigación. Configuras la integración en la Aplicación de Gestión de Cato (CMA). Cato envía JSON delimitado por nuevas líneas, con un registro por línea, y se autentica con una clave de API de Google Cloud y la clave secreta del webhook del feed. Esta integración es separada de la integración de Google Chronicle que recupera datos a través de la API `eventsFeed` de Cato. ### Fuentes de Datos de Google SecOps Puedes seleccionar **Eventos**, **Flujos**, o ambos: - **Eventos:** Registros de actividad de red y seguridad, como coincidencias de políticas, amenazas, cambios de conectividad y auditorías. - **Flujos:** Registros de flujo de red que añaden contexto de aplicación y usuario y detalles de sesiones agregadas, 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** del CMA. Para más información, consulte [Gestionando Roles de Administrador usando RBAC](/v1/docs/managing-admin-roles-using-rbac). - Una instancia de Google SecOps vinculada a un proyecto Google Cloud, con la API de Chronicle habilitada. - Permiso para crear un feed webhook en Google SecOps y una clave de API en el proyecto de Google Cloud vinculado. - Los requisitos previos descritos en [Comenzando con las Integraciones de Eventos](/v1/docs/getting-started-with-event-integrations), incluyendo cualquier lista blanca de IP requerida. ## Casos de Uso Estos ejemplos presuponen que las fuentes de datos relevantes se ingieren y que los campos utilizados para correlacionar registros se analizan de manera coherente. ### Eventos Después de validar los mapeos UDM, crea una regla YARA-L que correlacione un inicio de sesión sospechoso con un evento de amenaza de Cato para el mismo usuario en un intervalo de tiempo definido. ### Flujos Utiliza búsquedas estadísticas para identificar transferencias salientes inusualmente grandes, luego examina los eventos de Cato asociados para contexto de políticas o amenazas. ## Creación de la Integración de Google SecOps Crear un flujo de webhook y una Clave API de Google Cloud, prueba el endpoint con curl, luego ingresa la URL del flujo y las credenciales en el CMA. ### Paso 1: Crear el Flujo de Webhook HTTPS en Google SecOps **Para crear el flujo de webhook:** 1. Iniciar sesión en Google SecOps y vaya a **Configuración > Flujos**. 2. Haga clic en **Agregar nuevo** e ingrese un **Nombre de flujo**, como `Cato Networks`. 3. Para **Tipo de fuente**, seleccione **Webhook**. 4. Seleccione el **Tipo de registro** para los registros de Cato. 5. Haz clic en **Siguiente**. 6. Establezca el **Delimitador de división** a `\n` para que Google SecOps ingiera cada registro JSON delimitado por nueva línea como una entrada de registro separada. 7. (Opcional) Configure un **Espacio de nombres del recurso** y **Etiquetas de ingestión**. 8. Haga clic en **Siguiente**, revise la configuración del flujo, y haga clic en **Enviar**. 9. Haga clic en **Generar Clave Secreta**. Copia la clave y guárdala de manera segura antes de salir de la pantalla. Google no la muestra de nuevo. 10. En la pestaña **Detalles**, copia la URL del endpoint del flujo desde **Información del Endpoint**. Utilice la URL completa, incluido el sufijo `:importPushLogs`. 11. Confirme que el flujo está activado. Generar otra clave secreta invalida la clave anterior. Si rota el secreto después de configurar Cato, actualice la **Clave de Acceso Webhook** en el CMA de inmediato para evitar una brecha en la entrega. ### Paso 2: Crear la Clave API de Google Cloud **Para crear la clave API:** 1. En la consola de Google Cloud, seleccione el proyecto vinculado a su instancia de Google SecOps. 2. Vaya a **APIs & Servicios > Credenciales**. 3. Haga clic en **Crear credenciales > Clave API**. 4. Restrinja la clave a la **API de Chronicle** y guarde la restricción. 5. Copie la Clave API y guárdela de manera segura. También puede usar una Clave API existente restringida a la API de Chronicle para el proyecto vinculado. ### Paso 3: Probar el Endpoint con curl Antes de configurar la integración en el CMA, envíe una solicitud de prueba directamente a Google SecOps. Esto ayuda a aislar problemas de endpoint y autenticación de la integración de Cato. **Para probar el endpoint:** 1. Reemplace `ENDPOINT_URL` con el URL completo del feed del endpoint del Paso 1. Cuando se indique, introduzca la clave API de Google Cloud del Paso 2 y la clave secreta del feed del Paso 1. 2. Actualice las marcas de tiempo de muestra a la hora UTC actual, luego ejecute el siguiente comando. Mantenga cada objeto JSON en su propia línea; el comando envía ambos registros en una sola solicitud: Ejecute todo el ejemplo en un shell interactivo **Bash** (ejecute `bash` primero si es necesario). Ingrese credenciales en los mensajes ocultos; no las inserte en el comando. El ejemplo desactiva el seguimiento del shell y pasa los encabezados de autenticación a través de la entrada estándar usando `--header @-`, manteniendo las credenciales fuera del historial del shell y de los argumentos de la línea de comandos de curl. Las variables temporales de credenciales se descartan cuando finaliza el ejemplo. ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_API_KEY CATO_TEST_WEBHOOK_SECRET  IFS= read -r -s -p 'Clave API de Google Cloud: ' CATO_TEST_API_KEY  builtin printf '\n' >&2  case "$CATO_TEST_API_KEY" in    ''|*$'\r'*) builtin printf 'Ingrese una credencial no vacía sin retornos de carro.\n' >&2; exit 1 ;;  esac  IFS= read -r -s -p 'Clave secreta del webhook: ' CATO_TEST_WEBHOOK_SECRET  builtin printf '\n' >&2  case "$CATO_TEST_WEBHOOK_SECRET" in    ''|*$'\r'*) builtin printf 'Ingrese una credencial no vacía sin retornos de carro.\n' >&2; exit 1 ;;  esac  builtin printf '%s\n' "X-goog-api-key: ${CATO_TEST_API_KEY}" "X-Webhook-Access-Key: ${CATO_TEST_WEBHOOK_SECRET}" | \    curl -q --fail --show-error --include --max-time 30 -X POST "ENDPOINT_URL" \  --header @- \  -H "Content-Type: application/json" \  --data-binary '{"message":"evento de prueba de Cato 1","timestamp":"2026-07-14T12:00:00Z"} {"message":"evento de prueba de Cato 2","timestamp":"2026-07-14T12:00:01Z"}' ) ``` 3. Verifique la respuesta HTTP por un error. Una solicitud exitosa devuelve un estado HTTP 2xx. 4. En Google SecOps, busque los registros sin procesar recientes por `evento de prueba de Cato 1` y `evento de prueba de Cato 2`. Permita varios minutos para la ingestión, luego confirme que aparecen como dos entradas de registro separadas. Si ambos registros aparecen en una entrada de registro, verifique que el **delimitador de separación** del feed esté configurado en `\n`. Esta muestra verifica la conectividad y la separación de registros; no valida todos los mapeos de análisis para Eventos y Flujos de Cato. Esta prueba verifica si el destino acepta la solicitud de muestra y la divide en entradas de registro individuales. Verifique los datos y el análisis de Cato después de configurar la integración a continuación. ### Paso 4: Crear la Integración en el CMA **Para crear la integración de Google SecOps:** 1. Desde el menú de navegación de CMA, vaya a **Recursos > Integraciones**. 2. Abra la pestaña **Integraciones Configuradas** y haga clic en **Nuevo**. 3. Seleccione **Google SecOps** y la capacidad de **Datos Exportados**. 4. Ingrese un **Nombre** y una **Descripción** opcional. 5. Para **URL del Webhook**, pegue el URL completo del feed del endpoint del Paso 1. 6. Para la **Clave API de Google Cloud**, pegue la clave API restringida al API Chronicle. 7. Para la **Clave de Acceso Webhook**, pegue la clave secreta del feed. 8. En **Fuentes de Datos**, selecciona **Eventos**, **Flujos**, o ambos. 9. (Opcionalmente) Configure los filtros de eventos y flujos para controlar qué registros se envían. Vea [Filtros](/docs/es/integrating-cato-data-with-google-secops#filters). 10. Haga clic en Guardar. Cato guarda ambas claves cifradas y no las muestra nuevamente. Al editar la integración, deje una clave sin cambios para mantener su valor almacenado o ingrese un reemplazo. Cato establece automáticamente los encabezados `X-goog-api-key`, `X-Webhook-Access-Key`, y `Content-Type: application/json`. No necesita configurar encabezados. ### Paso 5: Verificar la Ingestión y Análisis **Para verificar que los datos de Cato lleguen a Google SecOps:** 1. En el CMA, revise el estado de la integración. Refresque la página si es necesario y verifique si hay errores de autenticación o destino. 2. En Google SecOps, vaya a **Configuración > Feeds**, abra el feed de Cato, y revise su estado y el tiempo de última ingestión. 3. Genere un evento de Cato reciente o tráfico de red para cada fuente de datos seleccionada. 4. Busque en los registros en bruto recientes utilizando una etiqueta de ingestión configurada en el feed o un valor de registro distintivo de Cato. También puede buscar el campo `data_source` con el valor `events` o `flows`. Permita varios minutos para la ingestión. 5. Verifique que los registros individuales estén analizados y que sus marcas de tiempo y campos asignados correspondan con la actividad de Cato. ## Filtros Utilice filtros de eventos y flujos para limitar los datos de Cato exportados a Google SecOps. Esto ayuda a controlar el volumen de ingestión y enfocar las investigaciones en actividades relevantes. Las condiciones del filtro dentro de un grupo utilizan 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. Los Filtros que son demasiado restrictivos pueden excluir todos los registros sin informar un Error. Si no llegan datos, verifique las fuentes de datos seleccionadas y las condiciones del filtro. ## Limitaciones Conocidas - Google SecOps admite un tamaño máximo de solicitud webhook de 4 MB y un rendimiento máximo de 15,000 consultas por segundo (QPS) por instancia. - La manera en que los registros de Cato se mapean en UDM depende del tipo de Registro del feed y la configuración del parser. - Regenerar el secreto del feed invalida la clave anterior. Actualice la **Clave de Acceso del Webhook** en el CMA cuando rote el secreto. - No puede personalizar el formato del cuerpo de la solicitud, el tipo de contenido o los nombres de cabecera de la integración de Cato. ## Resolución de problemas | Incidente | Solución | | --- | --- | | La Autenticación falla con HTTP 401 o 403. | Verifique que la Clave API de Google Cloud pertenezca al proyecto vinculado y permita el API de Chronicle. Confirme que el secreto del feed no haya sido reemplazado y actualice las credenciales en el CMA si es necesario. | | El Destino es inalcanzable. | Copie la URL completa del feed endpoint desde **Detalles > Información del Endpoint**, incluyendo `:importPushLogs`, y confirme que el feed esté habilitado. | | La integración parece saludable pero no llegan datos. | Verifique la selección de fuentes de datos y filtros, genere actividad de Cato coincidente y revise el estado de ingestión del feed y los errores del parser. | | Solo llegan eventos o solo llegan flujos. | Confirme que las fuentes requeridas estén seleccionadas y que sus filtros permitan registros coincidentes. Verifique que cada fuente se envíe al feed configurado para ella. | | Llegan registros raw pero los campos no se parsean. | Revise el tipo de Log del feed y la configuración del parser contra el setup en el Paso 1. | | Las Solicitudes son rechazadas o la ingestión se retrasa a un volumen alto. | Revise los Errores de destino por el tamaño de la solicitud o los límites de rendimiento y contacte al Soporte de Cato con el rango de tiempo afectado y los detalles del error, excluyendo claves de API y secretos webhook. | ## Recursos adicionales - [Google SecOps: Configurar un Webhook de SIEM](https://docs.cloud.google.com/chronicle/docs/ingestion/setup-siem-webhook)