Conectar o NinjaOne
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.ninjaoneestá 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.
| Fase | O quê | Intervalo padrão |
|---|---|---|
| Inventário | Dispositivos 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 ignoradas | 15 minutos |
| Métricas | Minutos 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 instalados | 15 minutos |
| Alertas | Alertas ativos, um alerta para cada um, com a condição do NinjaOne como regra | 5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid |
Preparar o NinjaOne
- Abra Administration › Apps › API › Client App IDs e selecione Add.
- Escolha a plataforma de aplicativo API Services (machine-to-machine), somente o escopo Monitoring e o tipo de concessão Client Credentials.
- Salve e copie o ID do cliente e o segredo do cliente.
- Anote a região da sua instância:
app.ninjarmm.com(Estados Unidos),eu.,oc.ouca.ninjarmm.com.
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
- Abra Settings › Sources, selecione Add a source e escolha NinjaOne.
- Em General, digite um Name e escolha a Entity.
- Em Connection, escolha a Region e digite o Client ID e o Client secret.
- 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.
- Mantenha Pending patches para trazer os patches aprovados do sistema operacional e de software que ainda não estão instalados.
- Em Ingest mode, escolha Hybrid (recommended) ou Polling quando o NinjaOne não conseguir alcançar o servidor do Excubius.
- Se quiser, em Webhook, digite um Webhook secret.
- 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çalhosAuthorizationex-custom-*.
As atividades de condição TRIGGERED e RESET abrem e fecham alertas no Excubius; as outras atividades são ignoradas.
Testar e sincronizar
- Na página da fonte, selecione Test. Cada leitura é listada com o resultado: credenciais, organizações, dispositivos, alertas e patches.
- 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.