NinjaOne RMM

Über die NinjaOne-Integration überträgt SEC AUDITOR Sicherheitsereignisse direkt in Ihr RMM. Neue, erneut aufgetretene und behobene Findings werden automatisch als Tickets in NinjaOne angelegt, sodass sie im selben Werkzeug sichtbar sind, mit dem Sie Ihre Endpunkte ohnehin verwalten, statt in einem separaten System nachgeschlagen werden zu müssen.

Voraussetzungen

Einen aktiven SEC AUDITOR Account mit Serviceprovider-Zugang
Administrator-Zugriff auf Ihren NinjaOne-Mandanten, um eine Client-Anwendung anzulegen
Ein NinjaOne-Technikerkonto (empfohlen: ein dediziertes Servicekonto), über das Tickets erstellt werden

Einrichtung

1. Client-Anwendung in NinjaOne anlegen

Legen Sie einmalig pro NinjaOne-Mandant eine Client-Anwendung an, über die SEC AUDITOR sich authentifiziert:

In NinjaOne zu Administration → Apps → API → Client-App-IDs wechseln und auf „Client-Anwendung hinzufügen" klicken
Im folgenden Dialog als Anwendungs-Plattform API-Dienste (Maschine-zu-Maschine) wählen und einen beliebigen, wiedererkennbaren Namen eintragen (z. B. „SEC AUDITOR Integration")
Als Umleitungs-URI https://app.sec-auditor.com/services/ninjaone/callback eintragen – zeichengenau, ohne Slash am Ende
Bei den Scopes sowohl Überwachen (monitoring) als auch Verwalten (management) aktivieren – beide werden benötigt, Steuerung wird nicht benötigt
Bei den erlaubten Grant-Typen Berechtigungscode, Client-Anmeldeinformationen und Aktualisierungstoken aktivieren
Client-ID und Client Secret notieren – das Secret wird von NinjaOne nur einmal angezeigt

Hinweis

Stellen Sie zusätzlich sicher, dass das Ticketing-Modul unter Administration → Apps → Ticketing aktiviert ist und mindestens ein aktives Ticket-Formular existiert. Das Standardformular „Default" reicht aus und wird automatisch verwendet.

2. Integration in SEC AUDITOR konfigurieren

Die Integration lässt sich unter „Domäne → Einstellungen → Integrationen → NinjaOne“ konfigurieren.

Client-ID, Client Secret und die Region Ihres NinjaOne-Mandanten eintragen und speichern
Über „Verbindung testen" prüfen, ob die Zugangsdaten korrekt sind und Zugriff auf Ihre Organisationen besteht (das Ticketing-Modul selbst wird hierbei noch nicht geprüft)
Die gewünschte NinjaOne-Organisation aus dem Dropdown auswählen
Über „Mit NinjaOne verbinden“ mit einem NinjaOne-Technikerkonto anmelden – in dessen Namen werden künftig alle Tickets angelegt. Dieser zweite Anmeldeschritt ist notwendig, weil NinjaOnes Ticketing-API für jedes Ticket einen menschlichen Ersteller verlangt und reine Maschinen-Zugangsdaten dafür nicht akzeptiert
Auslöser (neu / erneut aufgetreten / behoben) festlegen und die gewünschten Kritikalitätsstufen einzeln auswählen (Standard: Kritisch, Hoch und Mittel aktiv, Niedrig und Info aus), Integration aktivieren und speichern

Ab jetzt wird jedes Sicherheitsereignis, das die konfigurierten Filter erfüllt, automatisch als Ticket an NinjaOne übergeben.

Ticket-Inhalt

Jedes Ticket enthält im Betreff den Änderungstyp und den Titel des Findings (z. B. „NEW …“), in der Beschreibung Details wie betroffenes Objekt, Kritikalität sowie einen direkten Link zurück ins SEC AUDITOR Dashboard. Priorität und Status des Tickets richten sich nach der Kritikalität des Findings.

Geräteverknüpfung

Betrifft ein Finding einen Computer, versucht SEC AUDITOR automatisch, das Ticket zusätzlich mit dem passenden Gerät in NinjaOne zu verknüpfen (per Hostname-Abgleich gegen die Geräteliste der ausgewählten Organisation). Voraussetzung dafür ist, dass das betreffende Gerät in NinjaOne enrolled ist und sein Hostname mit dem Namen im Active Directory übereinstimmt. Schlägt die Geräteverknüpfung fehl oder ist sie mehrdeutig, wird das Ticket trotzdem angelegt – nur eben ohne Geräteverknüpfung.

Fehlerbehebung

Meldung	Ursache → Lösung
Fehler beim Speichern der Zugangsdaten / Verbindungstest schlägt fehl	Client-ID oder Client Secret falsch, oder falsche Region ausgewählt → Zugangsdaten und Region in NinjaOne mit den Einstellungen in SEC AUDITOR abgleichen
Fehlermeldung zur Umleitungs-URI beim Verbinden	Die Umleitungs-URI in der NinjaOne-Client-Anwendung fehlt oder weicht ab → exakt `https://app.sec-auditor.com/services/ninjaone/callback` eintragen, ohne Slash am Ende
„Mit NinjaOne verbinden“ ist nötig, obwohl Zugangsdaten bereits hinterlegt sind	Für die Ticket-Erstellung reicht die reine Zugangsdaten-Verbindung nicht aus, es wird zusätzlich ein Technikerkonto benötigt → Schritt „Mit NinjaOne verbinden" ausführen
Hinweis „NinjaOne-Verbindung abgelaufen“	Die Verbindung zum Technikerkonto wurde in NinjaOne widerrufen oder ist abgelaufen → in den Einstellungen erneut über „Mit NinjaOne verbinden" anmelden
Fehlermeldung, dass kein Aktualisierungstoken enthalten war, beim Verbinden mit dem Technikerkonto	Der Client-Anwendung in NinjaOne fehlt der Grant-Typ „Aktualisierungstoken" → Grant-Typ in der NinjaOne-Client-Anwendung ergänzen und den Verbindungsschritt erneut ausführen
Kein Ticket-Formular verfügbar	Im NinjaOne-Mandanten existiert kein aktives Ticket-Formular → im Ticketing-Modul ein Formular anlegen
Es werden keine Tickets angelegt	Auslöser- oder Kritikalitäts-Filter der Integration greifen nicht auf das Ereignis zu, oder die Integration ist deaktiviert → Einstellungen unter „Domäne → Einstellungen → Integrationen → NinjaOne“ prüfen
Ticket wurde angelegt, aber ohne verknüpftes Gerät	Das Gerät ist in NinjaOne nicht enrolled, der Hostname weicht vom Namen im Active Directory ab, oder mehrere Geräte kommen als Treffer infrage → Gerätenamen abgleichen bzw. doppelte/veraltete Geräteeinträge in NinjaOne bereinigen
Fehlermeldung zu fehlenden Berechtigungen bei der Geräteauflösung	Der Client-Anwendung in NinjaOne fehlt der Scope „Überwachen (monitoring)“ → Scope in der NinjaOne-Client-Anwendung ergänzen