Skip to main content

​
Was diese Integration beiträgt

NINJIO kann Ergebnisse zu Belegschaft, Schulungen und Phishing-Simulationen beisteuern. Geprüfte Beispiele sind:
  • training.assigned — hat Sicherheitsschulungen zugewiesen bekommen
  • training.completed — schließt Sicherheitsschulungen ab
  • training.passed — besteht Prüfungen zu Sicherheitsschulungen
  • phishing.simulation.clicked — hat auf eine Simulation geklickt, ohne sie zu melden
  • phishing.simulation.reported — meldet Phishing-Simulationen
Diese Beispiele zeigen die Arten normalisierter Aktivitäten, die Living Security verwenden kann. Weitere Informationen finden Sie unter Wie Integrationsdaten zu Signalen werden.

​
Was Living Security benötigt

Berechtigungsbereiche (Scopes): NINJIO vergibt die Berechtigungen für jeden API-Schlüssel pro Zugriffspunkt, mit separaten Lese- und Schreibberechtigungen. Living Security benötigt Lesezugriff auf drei Zugriffspunkte: Mitarbeitende, Schulungen und Phishing. Schreibzugriff wird nicht benötigt und sollte nicht erteilt werden. Erforderliche Rolle: Administrator in Ihrem NINJIO-Konto. Nur Administratoren können auf den Bereich „Integration“ zugreifen, in dem die Schlüssel erstellt werden.
NINJIO zeigt einen neuen Schlüssel nur ein einziges Mal an, nämlich bei seiner Erstellung. Kopieren Sie ihn direkt in die Living Security Platform oder in einen Passwort-Tresor, bevor Sie die Seite verlassen. Ein Schlüssel, den Sie nicht kopiert haben, kann nicht erneut abgerufen werden – Sie müssen einen neuen Schlüssel erzeugen.

​
Was Living Security abruft

Telefonnummern von Lernenden werden nicht gespeichert. NINJIO liefert in den Mitarbeiterdatensätzen eine Telefonnummer mit. Living Security verwirft sie, bevor etwas gespeichert wird, da keine Funktion von Living Security sie verwendet.

​
Voraussetzungen

  • Ein NINJIO-Konto mit API-Zugriff.
  • Administratorzugriff auf admin.goninjio.com.
  • E-Mail-Adressen der Lernenden in NINJIO, die mit den Adressen übereinstimmen, die Ihre anderen verbundenen Systeme verwenden. Über die E-Mail-Adresse ordnet Living Security eine Lernende bzw. einen Lernenden in NINJIO einer Person zu.

​
Teil A — In NINJIO

Ihre NINJIO-Administratorin bzw. Ihr NINJIO-Administrator führt diese Schritte durch.
1

Den Bereich „Integration“ öffnen

  1. Melden Sie sich als Administrator bei admin.goninjio.com an.
  2. Wählen Sie oben rechts auf dem Bildschirm Integration aus.
2

Den API-Schlüssel erstellen

  1. Wählen Sie New API Key aus.
  2. Geben Sie dem Schlüssel einen Namen, den Sie später wiedererkennen – zum Beispiel Living Security.
  3. Erteilen Sie Lesezugriff auf die Zugriffspunkte employee, training und phishing.
  4. Lassen Sie den Schreibzugriff deaktiviert. Living Security liest Daten aus NINJIO nur.
  5. Wählen Sie Generate Key aus.
Kopieren Sie den Schlüssel jetzt. NINJIO zeigt ihn nur einmal an und kann ihn nicht erneut anzeigen.

​
Teil B — In der Living Security Platform

Die Programmverantwortliche bzw. der Programmverantwortliche führt diesen Schritt durch, bei delegierter Einrichtung die Systemadministratorin bzw. der Systemadministrator.
Sie sind nun mit NINJIO verbunden.

​
Wie oft Daten abgerufen werden

Bei der ersten Verbindung ruft Living Security die Schulungsabschlüsse der letzten 12 Monate ab und aktualisiert die Daten anschließend inkrementell. Phishing-Simulationen werden jeweils einmal gelesen und nach ihrem Ende noch zwei Wochen lang erneut geprüft, sodass auch verspätete Klicks und verspätete Meldungen erfasst werden.
Bei einem großen NINJIO-Konto kann es bei der ersten Verbindung mehrere geplante Durchläufe dauern, bis alle Daten gelesen sind. Jeder Durchlauf liest so viel wie möglich, und der nächste setzt dort fort, wo der vorherige aufgehört hat. Die Zahlen steigen daher im Lauf des ersten oder zweiten Tages an und erscheinen nicht alle auf einmal.

​
Fehlerbehebung

Der API-Schlüssel ist falsch oder unvollständig. Die häufigste Ursache ist ein nur teilweise kopierter Schlüssel – NINJIO zeigt ihn nur einmal an, sodass ein abgeschnittenes Einfügen leicht passiert und sich im Nachhinein nicht erkennen lässt. Erzeugen Sie in NINJIO einen neuen Schlüssel und stellen Sie die Verbindung mit diesem erneut her.
Dies ist kein Problem mit den Zugangsdaten. Der Schlüssel wurde authentifiziert, aber für einen der benötigten Zugriffspunkte wurde keine Leseberechtigung erteilt.Das erneute Einfügen desselben Schlüssels hilft nicht. Erstellen Sie in NINJIO einen Schlüssel mit Lesezugriff auf alle drei Zugriffspunkte – employee, training und phishing – und stellen Sie die Verbindung mit diesem Schlüssel erneut her.
Prüfen Sie in NINJIO, ob mindestens eine Schulungskampagne aktiv ist und eine zugeordnete Simulation enthält. Eine Kampagne ohne Simulation bleibt inaktiv und liefert nichts, sodass keine Ergebnisse abgerufen werden können.Wenn Kampagnen aktiv sind, stellen Sie sicher, dass die darin enthaltenen Lernenden in ihren NINJIO-Datensätzen E-Mail-Adressen hinterlegt haben. Eine bzw. ein Lernender ohne E-Mail-Adresse kann keiner Person zugeordnet werden und wird übersprungen.
Dies ist die erwartete Anzeige für eine Schulung, die ein Lernender noch nicht beendet hat. Living Security erfasst die Zuweisung, wenn die NINJIO-Simulation startet, und erfasst den Abschluss separat, sobald NINJIO ein Abschlussdatum meldet.
Living Security ordnet Lernende in NINJIO einer Person anhand der E-Mail-Adresse zu. Weicht die NINJIO-E-Mail-Adresse einer bzw. eines Lernenden von der Adresse in Ihrem Verzeichnis ab – etwa bei einer privaten Adresse, einer alten Domain oder einem Tippfehler –, erfolgt keine Zuordnung.Korrigieren Sie die Adresse in NINJIO, dann wird sie beim nächsten geplanten Abruf zugeordnet.
Living Security prüft eine Phishing-Simulation nach ihrem Ende noch zwei Wochen lang erneut und beendet dies dann. Ergebnisse, die NINJIO nach Ablauf dieses Zeitfensters erfasst, werden nicht mehr übernommen. Wenden Sie sich an den Support, wenn eine ältere Simulation erneut gelesen werden soll.