Tema
En este artículo se explica cómo configurar el proceso de retransmisión de datos desde NinjaOne a una solución de gestión de información y eventos de seguridad (SIEM) mediante webhooks que se envían a medida que se producen las actividades en NinjaOne.
Entorno
Gestión de puntos finales de NinjaOne
Descripción
Aunque NinjaOne realiza un seguimiento de las acciones históricas realizadas dentro de la plataforma, muchas organizaciones necesitan agregar estos registros en una herramienta SIEM. También puede recuperar esta información a través de la API.
Antes de empezar, tenga en cuenta las siguientes notas importantes:
- Los webhooks permiten la transmisión de eventos en tiempo real desde NinjaOne a su SIEM.
- Puede configurar webhooks para eventos específicos, como alertas de dispositivos, condiciones de políticas o notificaciones específicas de la integración.
- Este artículo utiliza Splunk como ejemplo para contextualizar, pero puede implementar esta metodología con cualquier herramienta SIEM que admita webhooks.
- Las diferentes herramientas SIEM pueden tener métodos de configuración de webhooks únicos.
Índice
Selecciona una categoría para obtener más información:
Sincronizar mensajes de actividad
NinjaOne está configurado para transmitir webhooks a un Splunk HTTP Event Collector (HEC). Para ello, sigue estos pasos:
- Utilice el siguiente recurso para crear un HEC en Splunk: Configurar y utilizar el colector de eventos HTTP en Splunk Web - Documentación de Splunk (enlace externo).
- Acceda a NinjaOne como administrador del sistema y vaya a Administración → Aplicaciones → API.
- Coloca el cursor sobre el icono del signo de interrogación en la barra de título de la API y haz clic en Documentación de la API. También puedes acceder a este enlace desde el icono de recursos de ayuda situado en la esquina superior derecha de la consola.


- En la página API pública, busca el punto final /v2/webhook. Consulta Referencia de la API pública de NinjaOne | Pasos para configurar la integración de webhooks para obtener más información sobre los requisitos para utilizar este punto final.
- Utilice la documentación proporcionada para decidir qué tipos de actividades desea transmitir a la herramienta SIEM.
- NinjaOne clasifica las actividades según el tipo de acción a la que se refieren. Por ejemplo, CONDITION recuperaría solo los registros relacionados con alertas activadas y reinicios. ACTIONSET correspondería a cualquier automatización que se esté ejecutando o acción realizada por un técnico.
- Es posible que no todos los tipos de actividad sean relevantes para sus necesidades de recopilación de datos, por lo que solo debe seleccionar aquellos que deban registrarse en la herramienta SIEM. Además, puede añadir información adicional utilizando los parámetros EXPAND .
- Si desea personalizar la carga útil, consulte la siguiente sección para saber cómo hacerlo. Ejemplo de carga útil: Ejemplo de carga útil de configureWebhooks - Pastebin.com (enlace externo).
- Haga clic en «Probarlo» en la API pública y pegue la siguiente carga útil de ejemplo en el campo «Cuerpo de la solicitud ».

- Haga clic en «Ejecutar». Al finalizar, debería aparecer un código de respuesta 204.
Una vez completado este proceso, las actividades de NinjaOne se enviarán como webhooks al SIEM, donde podrán ser procesadas. En el menú «Canales de notificación» de NinjaOne, verás una entrada de webhook sin nombre. Es importante que no modifiques esta entrada de ninguna manera para garantizar que los webhooks se transmitan continuamente a tu SIEM.
En General → Actividades del sistema, habilita la actividad de fallo de webhook para que te avise si se han producido problemas con los webhooks o si el webhook se desactiva, de modo que puedas identificarlos y solucionarlos rápidamente.
Personalizar una carga útil de ejemplo
Hemos creado una carga útil de ejemplo que puede personalizar en Ejemplo de carga útil configureWebhooks - Pastebin.com. Para ello, abra el enlace y siga estos pasos:
- Inserte la URL del Splunk HEC que se creó en el paso 1 de la sección de este artículo titulada «Sincronizar mensajes de actividad». Asegúrese de que su URL termine con lo siguiente para que los webhooks de NinjaOne se analicen correctamente:
/services/collector/raw - Personalice el activityType que desea transmitir a la herramienta SIEM. Tenga en cuenta que cada clave activityType utiliza un asterisco o comodín (*) como valor en la carga útil JSON.
- Personalice los parámetros de expansión deseados.
- Copie el token que NinjaOne creó para Splunk HEC en el paso 1 de la sección de este artículo titulada «Sincronizar mensajes de actividad». Pegue el token en el valor bajo «headers» en la carga útil JSON. «Splunk» o el nombre de su otra herramienta SIEM debe preceder al token; por ejemplo: Splunk 123456.
Recursos adicionales
Para obtener más información sobre las actividades en NinjaOne, consulta NinjaOne Endpoint Management: Feed de notificaciones de actividad de dispositivos y sistemas.
Si desea probar los webhooks antes de integrarlos directamente en su SIEM, Webhook.site - Probar, transformar y automatizar solicitudes web y correos electrónicos (enlace externo) es un sitio web útil para la validación.