Saltar al contenido principal
Versión: 0.4 · actual

Conectar NinjaOne

Guía paso a pasoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

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.ninjaone está 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.

FaseQuéIntervalo predeterminado
InventarioLos 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 omiten15 minutos
MétricasMinutos 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 instalados15 minutos
AlertasLas alertas activas, una alerta por cada una, con la condición de NinjaOne como regla5 minutos en Sondeo; conciliación cada 15 minutos en Híbrido

Preparar NinjaOne​

  1. Abre Administration › Apps › API › Client App IDs y selecciona Add.
  2. Elige la plataforma de aplicación API Services (machine-to-machine), solo el ámbito Monitoring y el tipo de concesión Client Credentials.
  3. Guarda y luego copia el ID de cliente y el secreto de cliente.
  4. Anota la región de tu instancia: app.ninjarmm.com (Estados Unidos), eu., oc. o ca.ninjarmm.com.
aviso

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​

  1. Abre Configuración › Fuentes, selecciona Añadir una fuente y elige NinjaOne.
  2. En General, escribe un Nombre y elige la Entidad.
  3. En Conexión, elige la Región y escribe el ID de cliente y el Secreto de cliente.
  4. 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.
  5. Conserva Parches pendientes para traer los parches del sistema operativo y de software aprobados que todavía no están instalados.
  6. En Modo de ingesta, elige Híbrido (recomendado), o Sondeo cuando NinjaOne no pueda llegar al servidor de Excubius.
  7. Si quieres, en Webhook, escribe un Secreto del webhook.
  8. 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 encabezados Authorization y x-custom-*.

Las actividades de condición TRIGGERED y RESET abren y cierran alertas en Excubius; las demás actividades se ignoran.

Probar y sincronizar​

  1. En la página de la fuente, selecciona Probar. Cada lectura aparece con su resultado: credenciales, organizaciones, dispositivos, alertas y parches.
  2. 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.