Connecter NinjaOne
Connectez NinjaOne pour faire entrer dans Excubius les appareils Windows, Linux et macOS de vos organisations, avec leur dernier contact, leurs correctifs en attente et les alertes propres à NinjaOne. Ce guide présente le client d'API de moindre privilège côté NinjaOne, la façon d'ajouter la source et celle de recevoir les alertes par webhook.
Avant de commencer
- Vous devez disposer du rôle Entity admin sur l'entité à laquelle appartiennent les appareils.
- Dans NinjaOne, vous pouvez ajouter une application cliente d'API sous Administration › Apps › API.
- La fonctionnalité
sources.ninjaoneest activée. Consultez Sources.
Ce qu'Excubius lit
Excubius lit NinjaOne par son API publique v2, avec uniquement des requêtes GET, plus la requête d'un jeton OAuth.
| Phase | Contenu | Intervalle par défaut |
|---|---|---|
| Inventaire | Les appareils détaillés et les noms des organisations. Les appareils Windows, Linux et macOS deviennent des hôtes, avec leur système d'exploitation, leur dernier contact, l'indicateur hors ligne et leur organisation comme étiquette client. Les autres classes de nœuds, comme les appareils réseau, les moniteurs cloud et les hyperviseurs, sont comptées puis ignorées | 15 minutes |
| Métriques | Les minutes écoulées depuis le dernier contact (avertissement après 15, critique après 60) et, sauf si vous la désactivez, les correctifs du système d'exploitation et des logiciels en attente, approuvés et non installés | 15 minutes |
| Alertes | Les alertes actives, une alerte chacune, avec la condition NinjaOne comme règle | 5 minutes en Polling ; rapprochement toutes les 15 minutes en Hybrid |
Préparer NinjaOne
- Ouvrez Administration › Apps › API › Client App IDs et sélectionnez Add.
- Choisissez la plateforme d'application API Services (machine-to-machine), l'étendue Monitoring uniquement et le type d'octroi Client Credentials.
- Enregistrez, puis copiez l'ID client et le secret client.
- Notez la région de votre instance :
app.ninjarmm.com(États-Unis),eu.,oc.ouca.ninjarmm.com.
Donnez au client uniquement l'étendue Monitoring. Les étendues Management et Control peuvent modifier des appareils et exécuter des scripts, et Excubius n'en a jamais besoin.
Ajouter la source
- Ouvrez Settings › Sources, sélectionnez Add a source et choisissez NinjaOne.
- Sous General, saisissez un Name et choisissez l'Entity.
- Sous Connection, choisissez la Region et saisissez le Client ID et le Client secret.
- Si vous le souhaitez, listez les Organizations à lire, sous forme d'ID d'organisation séparés par des virgules. Laissez le champ vide pour lire toutes les organisations que le client peut voir.
- Conservez Pending patches pour importer les correctifs approuvés du système d'exploitation et des logiciels qui ne sont pas encore installés.
- Sous Ingest mode, choisissez Hybrid (recommended), ou Polling lorsque NinjaOne ne peut pas joindre le serveur Excubius.
- Si vous le souhaitez, sous Webhook, saisissez un Webhook secret.
- Sélectionnez Create source et copiez l'URL du webhook. Elle n'est affichée qu'une seule fois.
Recevoir les alertes par webhook
NinjaOne envoie des webhooks à une URL enregistrée par son API (PUT /v2/webhook). Un administrateur le fait une seule fois, avec une application d'API autorisée à gérer NinjaOne, jamais avec le client en lecture seule que vous avez donné à Excubius.
- Enregistrez l'URL qu'Excubius a affichée.
- Si vous avez défini un secret de webhook, ajoutez l'en-tête
X-Custom-Webhook-Secret: <secret>. NinjaOne accepte les en-têtesAuthorizationetx-custom-*.
Les activités de condition TRIGGERED et RESET ouvrent et ferment des alertes dans Excubius ; les autres activités sont ignorées.
Tester et synchroniser
- Sur la page de la source, sélectionnez Test. Chaque lecture est listée avec son résultat : informations d'identification, organisations, appareils, alertes et correctifs.
- Sélectionnez Sync now pour importer immédiatement les appareils, les métriques et les alertes, sans attendre.
Les appareils apparaissent comme des hôtes Windows, Linux et macOS, rapprochés des mêmes serveurs issus d'autres sources et étiquetés avec leur organisation. Les vérifications NinjaOne et la vérification des correctifs en attente apparaissent sur ces hôtes, et les alertes NinjaOne apparaissent dans l'Alert inbox.