Pular para o conteúdo principal
Versão: 0.4 · atual

Conectar o NinjaOne

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

Conecte o NinjaOne para trazer os dispositivos Windows, Linux e macOS das suas organizações para o Excubius, com o último contato, os patches pendentes e os alertas do próprio NinjaOne. Este guia mostra o cliente de API com privilégios mínimos no lado do NinjaOne, como adicionar a fonte e como receber alertas por webhook.

Antes de começar​

  • Você precisa da função Entity admin (Administrador de entidade) na entidade à qual os dispositivos pertencem.
  • No NinjaOne, você pode adicionar um aplicativo cliente de API em Administration › Apps › API.
  • O recurso sources.ninjaone está ativado. Consulte Fontes.

O que o Excubius lê​

O NinjaOne é lido por meio da API pública v2 dele, apenas com solicitações GET, além da solicitação de um token OAuth.

FaseO quêIntervalo padrão
InventárioDispositivos detalhados e os nomes das organizações. Os dispositivos Windows, Linux e macOS se tornam hosts com o sistema operacional, o último contato, o indicador de offline e a organização deles como a marca client. Outras classes de nó, como dispositivos de rede, monitores de nuvem e hipervisores, são contadas e ignoradas15 minutos
MétricasMinutos desde o último contato (aviso após 15, crítico após 60) e, a menos que você desative essa opção, patches pendentes do sistema operacional e de software que foram aprovados e não estão instalados15 minutos
AlertasAlertas ativos, um alerta para cada um, com a condição do NinjaOne como regra5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid

Preparar o NinjaOne​

  1. Abra Administration › Apps › API › Client App IDs e selecione Add.
  2. Escolha a plataforma de aplicativo API Services (machine-to-machine), somente o escopo Monitoring e o tipo de concessão Client Credentials.
  3. Salve e copie o ID do cliente e o segredo do cliente.
  4. Anote a região da sua instância: app.ninjarmm.com (Estados Unidos), eu., oc. ou ca.ninjarmm.com.
aviso

Dê ao cliente somente o escopo Monitoring. Os escopos Management e Control podem alterar dispositivos e executar scripts, e o Excubius nunca precisa deles.

Adicionar a fonte​

  1. Abra Settings › Sources, selecione Add a source e escolha NinjaOne.
  2. Em General, digite um Name e escolha a Entity.
  3. Em Connection, escolha a Region e digite o Client ID e o Client secret.
  4. Se quiser, liste as Organizations a ler, como IDs de organização separados por vírgulas. Deixe vazio para ler todas as organizações que o cliente pode ver.
  5. Mantenha Pending patches para trazer os patches aprovados do sistema operacional e de software que ainda não estão instalados.
  6. Em Ingest mode, escolha Hybrid (recommended) ou Polling quando o NinjaOne não conseguir alcançar o servidor do Excubius.
  7. Se quiser, em Webhook, digite um Webhook secret.
  8. Selecione Create source e copie a URL do webhook. Ela é exibida apenas uma vez.

Receber alertas por webhook​

O NinjaOne envia webhooks para uma URL registrada por meio da API dele (PUT /v2/webhook). Um administrador faz isso uma vez, com um aplicativo de API autorizado a gerenciar o NinjaOne, nunca com o cliente somente leitura que você forneceu ao Excubius.

  • Registre a URL que o Excubius mostrou.
  • Se você definiu um segredo de webhook, adicione o cabeçalho X-Custom-Webhook-Secret: <secret>. O NinjaOne aceita os cabeçalhos Authorization e x-custom-*.

As atividades de condição TRIGGERED e RESET abrem e fecham alertas no Excubius; as outras atividades são ignoradas.

Testar e sincronizar​

  1. Na página da fonte, selecione Test. Cada leitura é listada com o resultado: credenciais, organizações, dispositivos, alertas e patches.
  2. Selecione Sync now para trazer os dispositivos, as métricas e os alertas sem esperar.

Os dispositivos aparecem como hosts Windows, Linux e macOS, correspondidos com os mesmos servidores de outras fontes e marcados com a organização deles. As verificações do NinjaOne e a verificação de patches pendentes aparecem neles, e os alertas do NinjaOne aparecem na Alert inbox.