Conectar NinjaOne
Conecta NinjaOne para traer a Excubius los dispositivos Windows, Linux y macOS de tus organizaciones, con su último contacto, sus parches pendientes y las alertas propias de NinjaOne. Esta guía muestra el cliente de API con privilegios mínimos del lado de NinjaOne, cómo agregar la fuente y cómo recibir alertas por webhook.
Antes de empezar
- Necesitas el rol Administrador de entidad en la entidad a la que pertenecen los dispositivos.
- En NinjaOne, puedes agregar una aplicación cliente de API en Administration › Apps › API.
- La función
sources.ninjaoneestá activada. Consulta Fuentes.
Lo que lee Excubius
NinjaOne se lee mediante su API pública v2, solo con solicitudes GET, más la solicitud de un token de OAuth.
| Fase | Qué | Intervalo predeterminado |
|---|---|---|
| Inventario | Los dispositivos detallados y los nombres de las organizaciones. Los dispositivos Windows, Linux y macOS se convierten en hosts con su sistema operativo, su último contacto, su indicador de desconexión y su organización como la etiqueta client. Las demás clases de nodo, como los dispositivos de red, los monitores en la nube y los hipervisores, se cuentan y se omiten | 15 minutos |
| Métricas | Minutos desde el último contacto (advertencia a partir de 15, crítico a partir de 60) y, salvo que lo desactives, los parches pendientes del sistema operativo y de software que están aprobados y no instalados | 15 minutos |
| Alertas | Las alertas activas, una alerta por cada una, con la condición de NinjaOne como regla | 5 minutos en Sondeo; conciliación cada 15 minutos en Híbrido |
Preparar NinjaOne
- Abre Administration › Apps › API › Client App IDs y selecciona Add.
- Elige la plataforma de aplicación API Services (machine-to-machine), solo el ámbito Monitoring y el tipo de concesión Client Credentials.
- Guarda y luego copia el ID de cliente y el secreto de cliente.
- Anota la región de tu instancia:
app.ninjarmm.com(Estados Unidos),eu.,oc.oca.ninjarmm.com.
Concede al cliente solo el ámbito Monitoring. Los ámbitos Management y Control pueden cambiar dispositivos y ejecutar scripts, y Excubius nunca los necesita.
Agregar la fuente
- Abre Configuración › Fuentes, selecciona Añadir una fuente y elige NinjaOne.
- En General, escribe un Nombre y elige la Entidad.
- En Conexión, elige la Región y escribe el ID de cliente y el Secreto de cliente.
- Si quieres, enumera las Organizaciones que se leen, como ID de organización separados por comas. Déjalo vacío para leer todas las organizaciones que el cliente puede ver.
- Conserva Parches pendientes para traer los parches del sistema operativo y de software aprobados que todavía no están instalados.
- En Modo de ingesta, elige Híbrido (recomendado), o Sondeo cuando NinjaOne no pueda llegar al servidor de Excubius.
- Si quieres, en Webhook, escribe un Secreto del webhook.
- Selecciona Crear la fuente y copia la URL del webhook. Solo se muestra una vez.
Recibir alertas por webhook
NinjaOne envía webhooks a una URL registrada mediante su API (PUT /v2/webhook). Un administrador lo hace una vez, con una aplicación de API que tenga permiso para administrar NinjaOne, nunca con el cliente de solo lectura que diste a Excubius.
- Registra la URL que mostró Excubius.
- Si configuraste un secreto del webhook, agrega el encabezado
X-Custom-Webhook-Secret: <secret>. NinjaOne acepta los encabezadosAuthorizationyx-custom-*.
Las actividades de condición TRIGGERED y RESET abren y cierran alertas en Excubius; las demás actividades se ignoran.
Probar y sincronizar
- En la página de la fuente, selecciona Probar. Cada lectura aparece con su resultado: credenciales, organizaciones, dispositivos, alertas y parches.
- Selecciona Sincronizar ahora para traer dispositivos, métricas y alertas sin esperar.
Los dispositivos aparecen como hosts Windows, Linux y macOS, emparejados con los mismos servidores de otras fuentes y etiquetados con su organización. Las comprobaciones de NinjaOne y la comprobación de parches pendientes aparecen en ellos, y las alertas de NinjaOne aparecen en la Bandeja de alertas.