Important: This integration is a preview and subject to change. The certification process is underway.
"Resumen"
Utilice la integración de Stellar Cyber para analizar los datos de red y seguridad de Cato en Stellar Cyber Open XDR. La integración nativa envía datos directamente a un webhook de XDR Connect, donde configura la normalización y los mapeos de campos para sus flujos de trabajo de búsqueda y caza de amenazas.
Usted configura la integración en la Aplicación de Gestión de Cato (CMA). Cato envía solicitudes HTTPS POST que contienen matrices JSON y se autentica con un token de API de Stellar Cyber.
Esta Integración de Datos Exportados es distinta de la integración API de Stellar Cyber.
Fuentes de Datos de Stellar Cyber
Cato admite la exportación de las siguientes fuentes de datos:
Eventos: Registros de actividad de red y seguridad, tales 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 agregados de la sesión, 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 un volumen significativamente mayor que los datos de eventos, dependiendo de su tráfico.
Seleccione la fuente de datos Cato que coincida con la configuración de destino de Stellar Cyber.
"Requisitos previos"
Permiso de editor para Integraciones en la sección de Recursos del CMA. Para más información, consulte Gestión de Roles de Administrador Usando RBAC.
Un despliegue de Stellar Cyber con XDR Connect disponible. Para más información, consulte Stellar Cyber: Configuración del Conector XDR.
Configuración de acceso Agregar/Editar/Eliminar conector XDR en RBAC de Stellar Cyber para el administrador que crea el destino, y permiso para generar un token API con privilegio de Ingestión del Conector XDR.
Registros JSON representative de Cato para las fuentes de datos que planea exportar, para usar al configurar la normalización.
Los requisitos previos descritos en Introducción a las Integraciones de Eventos, incluyendo cualquier lista de permisos IP necesaria.
Casos de Uso
Eventos
Enviar eventos de Cato a Stellar Cyber para investigar actividad de red y seguridad junto con otros datos. Por ejemplo, un analista puede buscar un evento de amenaza reciente de Cato y revisar su información de usuario, aplicación y sitio. Las reglas de Búsqueda de Amenazas Automática pueden proporcionar más detecciones y alertas personalizadas.
Flujos
Usar registros de flujo para añadir contexto de sesión a una investigación. Los bytes transferidos, el recuento de paquetes, y la duración de la sesión ayudan a un analista a evaluar si la actividad sospechosa involucró una conexión breve o una gran transferencia que pueda justificar una investigación adicional.
Using a Custom TLS Certificate (Optional)
If your destination presents a certificate signed by a private Certificate Authority (CA), or a self-signed certificate, you can include the root CA certificate in the configuration. The destination’s server certificate is verified before sending data.
Note: This is server certificate verification only. It is not client-certificate (mTLS) authentication.
For destinations that use a private CA, paste the root CA certificate and any intermediate certificates. For self-signed certificates, paste the server’s own certificate. Enter only public certificates in PEM text format, up to a maximum size of 128 KiB. PFX, P12, and DER files, private keys, and CSRs are not supported. Never paste a private key. If your destination uses a certificate from a publicly trusted CA, leave the option cleared.
If your destination is an on-premises SIEM or collector, you may need to allow the Cato Management Application (CMA) IP addresses to receive logs. Add these addresses to the allow list in Cato Remote Port Forwarding and in any firewall between Cato and your destination. See the CMA IP allow list for the current addresses.
Creación de la Integración de Stellar Cyber
Crear un token de API de Stellar Cyber y un conector XDR, luego usar la URL del webhook generada y el token para configurar la integración de Exportación de Datos en el CMA.
Paso 1: Crear el Token de API de Stellar Cyber
Stellar Cyber recomienda un rol solo de ingestión con el privilegio de Ingestión del Conector XDR. Las claves API están asociadas con una identidad en lugar de con un conector individual.
Para crear el token API:
Iniciar sesión en Stellar Cyber usando una cuenta con permiso para crear la clave API requerida.
Haga clic en su nombre de cuenta y seleccione Perfil.
En la pestaña de Claves API, cree un token de API para una identidad con el privilegio de Ingestión del Conector XDR.
Copie el token y guárdelo de manera segura. Elija su vencimiento de acuerdo con la política de rotación de su organización; Stellar Cyber recomienda un vencimiento de 90 días.
Paso 2: Crear el Conector XDR en Stellar Cyber
Para crear el conector de destino:
Vaya a Sistema > Integraciones > Conectores, haga clic en Crear y seleccione Conector XDR.
Ingrese un nombre de conector único, como
cato_events.En Entrada de Registro Crudo, pegue un registro JSON representativo de Cato para la fuente que planea exportar. Incluya los campos que deben mapearse, incluyendo un sello de tiempo y
fuente_de_datos.En el paso General, bajo Generar Enlace de Conector, haga clic en Generar y copiar Enlace de Conector. Guarde la URL completa de webhook generada.
Seleccione el Arrendatario de destino.
(Opcionalmente) Configure Mapeo de Arrendatario para enrutar registros usando un identificador de arrendatario en el JSON entrante. Configure la tabla de mapeo adecuada si los registros contienen IDs de arrendatario del proveedor.
En el paso de Normalización, configure Proveedor, Fuente y Espacio de Nombres.
Seleccione el Tipo de Índice que coincide con la fuente. Stellar Cyber describe Syslog para eventos y Tráfico para flujos de red. No se puede cambiar esta selección después de crear el conector.
En Mapeo de Campos, habilite Mapeo de Sello de Tiempo y seleccione el campo de fuente y formato de sello de tiempo. Sin este mapeo, Stellar Cyber utiliza el tiempo de ingestión como el sello de tiempo del evento.
Configurar mapeos de campos en bruto a campos del esquema Stellar Cyber o campos de espacio de nombres personalizados. Utilice Usar Plantilla si tiene una plantilla de mapeo.
Haga clic en Mostrar Salida y verifique la muestra normalizada, los tipos de campo y la marca de tiempo.
(Opcionalmente) Configure el enriquecimiento en el paso de Enriquecimiento.
Haz clic en Finalizar & Aplicar.
Utilice la URL completa generada para su implementación. Las instancias alojadas generalmente usan HTTPS en el puerto 443. Los destinos del Analizador de Datos utilizan el nombre de host generado y el puerto 8889.
Paso 3: Crear la Integración en el CMA
Para crear la integración de Stellar Cyber:
Desde el menú de navegación del CMA, vaya a Recursos > Integraciones.
Abra la pestaña de Integraciones Configuradas y haga clic en Nuevo.
Seleccione Stellar Cyber y la capacidad de Exportación de Datos.
Introduzca un Nombre y una Descripción opcional.
Para URL de Ingesta, pegue la URL completa del webhook generado en el Paso 2.
(Opcional) Para incluir un certificado TLS personalizado, marque la casilla Confiar en una CA privada o certificado autofirmado y pegue el certificado raíz de la CA. Para más información, consulte Uso de un Certificado TLS Personalizado.
Para Token de Portador, pegue el token API con privilegio de ingesta. Ingrese solo el token; Cato añade el prefijo
Bearer.Bajo Fuentes de Datos, seleccione la fuente que coincide con el Tipo de Índice y la configuración de normalización del destino de Stellar Cyber.
(Opcionalmente) Configure los filtros para la fuente seleccionada. Vea Filtros.
Haga clic en Guardar.
Cato almacena el token API cifrado y no lo muestra nuevamente. Actualice la integración cuando rote el token.
Paso 4: Verificar Ingesta y Normalización
Para verificar que los datos de Cato lleguen a Stellar Cyber:
En el CMA, abra Integraciones Configuradas y confirme que la integración sale de Configuración y no muestra un error de autenticación o de destino. Actualice la página si es necesario.
Genere un evento Cato reciente o tráfico de red para cada fuente de datos configurada.
En Stellar Cyber, vaya a Sistema > Integraciones > Conectores y localice el conector XDR Connect.
Después de que los registros lleguen, haga clic en Ver Eventos. Confirme que cada registro de Cato aparezca individualmente.
Seleccione Más Información para un registro. En la pestaña de JSON, inspeccione los campos analizados. En la pestaña de Detalles, verifique los campos normalizados.
Verifique el arrendatario de destino, índice, espacio de nombres y marca de tiempo. Confirme que
data_sourcecoincida con la fuente configurada de Cato.
Filtros
Utilice filtros de eventos y flujos para limitar los datos de Cato exportados a Stellar Cyber. Esto ayuda a controlar el volumen de ingestión y enfocar las investigaciones en actividades relevantes.
Las condiciones de filtro dentro de un grupo usan lógica Y. Los grupos separados utilizan la 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 seleccionan 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, revise la fuente de datos seleccionada y las condiciones del filtro.
Limitaciones conocidas
El tipo de índice y el espacio de nombres no se pueden cambiar después de crear un conector XDR de Stellar Cyber. Elija la configuración de destino antes de habilitar la exportación.
Un conector tiene un arrendatario de destino predeterminado. La derivación de registros a otros arrendatarios requiere Mapeo de Arrendatarios y un identificador apropiado en el JSON entrante.
Stellar Cyber no admite la integración de alertas de terceros ni las detecciones basadas en ML para los datos ingeridos a través de XDR Connect. Las reglas de Búsqueda Automática de Amenazas pueden proporcionar detecciones adicionales y alertas personalizadas.
Las claves API están basadas en la identidad. Use un token con privilegios solo de ingestión y rotéelo de acuerdo con su política.
No puede personalizar el formato del cuerpo de la solicitud de integración de Cato, el tipo de contenido o el encabezado de autenticación.
Resolución de problemas
Incidente | Solución |
|---|---|
La autenticación falla con HTTP 401 o 403 | Confirme que el token de API es válido y su identidad tiene el privilegio Ingestión del Conector XDR. Reemplace un token expirado o revocado y actualice el Token de Portador en el CMA. |
El destino es inalcanzable o devuelve HTTP 404 | Copie el enlace de webhook generado completo. Verifique el nombre de host de la instancia y, para un destino de Analizador de Datos, el puerto 8889 y la conectividad de la red. |
Las solicitudes son rechazadas o los registros individuales no aparecen | Inspeccione la respuesta del destino y contacte con el Soporte de Cato con el rango de tiempo afectado y los detalles del error, excluyendo el token de API. |
Los datos llegan en el índice o espacio de nombres incorrecto | Verifique el tipo de índice y el espacio de nombres del destino. Estos no se pueden editar después de la creación; cree un destino con los valores correctos y actualice la integración correspondiente de Cato. |
Los campos o las marcas de tiempo son incorrectos | Revise las mapeaciones de campos y marcas de tiempo en el paso de Normalización. Use una muestra representativa y Mostrar Salida para verificar el resultado. Sin mapeo de marca de tiempo, la marca de tiempo del evento es el tiempo de ingestión. |
La integración parece saludable pero no llegan datos | Revise la selección de fuente de datos y filtros, genere actividad coincidente de Cato y verifique el inquilino predeterminado y cualquier configuración de Mapeo de Inquilino. |
Solo llega una fuente esperada | Verifique la selección de fuente de datos y los filtros de cada integración de Cato con respecto a la configuración de destino Stellar. |