> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Einrichtung der NINJIO-Integration

> Verbinden Sie NINJIO mit der Living Security Platform, um Ergebnisse der Security-Awareness-Schulungen und Phishing-Simulationen für Ihre Belegschaft zu importieren.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Weiterführende Ressourcen</h2>
    <ul>
      <li>
        <a href="/de/signals/data-sources">Erfahren Sie, wie Daten aus Integrationen zu Signalen für das Human Risk Management werden</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security Integrationen entdecken</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform öffnen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security Demo anfordern</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Zugangsdaten in der Living Security Platform eingeben">
    <p>
      Wird von der Person durchgeführt, die über Living Security-Zugriff verfügt – dem Programmverantwortlichen oder dem Systemadministrator, sofern dieser eingeladen wurde (delegierte Einrichtung).
    </p>
    <ol>
      <li>
        Gehen Sie zu <strong>Einstellungen → Integrationen → Catalog</strong>, suchen Sie die Kachel{' '}
        <strong>{tile}</strong> und klicken Sie auf <strong>Verbinden</strong>.
      </li>
      <li>
        Füllen Sie die folgenden Felder aus und klicken Sie anschließend auf <strong>Verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Diese Anleitung richtet sich an Ihre {system}-Administratorin bzw. Ihren {system}-Administrator.</strong> Sie beschreibt das Erstellen von API-Zugangsdaten in {system}. Dafür ist Administratorzugriff auf {system} erforderlich – nicht auf die
      Living Security Platform.
    </p>
    <p>
      Wenn Sie als <strong>Programmverantwortlicher</strong> von Living Security {system} nicht selbst administrieren,
      leiten Sie diese Seite an die zuständige Person weiter. Diese führt Teil A durch und übergibt Ihnen die Zugangsdaten
      (oder gibt sie direkt ein, sofern Sie sie in die Plattform eingeladen haben).
      {recommendDelegated && <>
          {' '}Da bei der Einrichtung sensibles Schlüsselmaterial entsteht, empfehlen wir den Weg der{' '}
          <strong>delegierten Einrichtung</strong>, damit das Secret nie an Sie zurückgesendet wird.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## 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](/de/signals/data-sources).

## Was Living Security benötigt

| Zugangsdaten | Beschreibung |
| - | - |
| **API-Schlüssel** | Ein NINJIO-API-Schlüssel mit Lesezugriff auf die Zugriffspunkte für Mitarbeitende, Schulungen und Phishing. Living Security sendet ihn bei jeder Anfrage mit. |

**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.

<Warning>
  **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.
</Warning>

### Was Living Security abruft

| Daten | Detail |
| - | - |
| **Lernende** | Ihr NINJIO-Mitarbeiterverzeichnis: Name, E-Mail-Adresse, Abteilung, Position, Vorgesetzte bzw. Vorgesetzter, Land, Niederlassung und Status „aktiv“. |
| **Schulung** | Wem welche Schulung zugewiesen wurde und wer sie abgeschlossen hat – mit Abschlussdatum, Prüfungsergebnis und Engagement-Wert. |
| **Phishing** | Wer mit einer simulierten Phishing-E-Mail interagiert hat und wer sie gemeldet hat, jeweils mit dem Zeitpunkt. |

<Note>
  **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.
</Note>

### Voraussetzungen

* Ein NINJIO-Konto mit API-Zugriff.
* Administratorzugriff auf [admin.goninjio.com](https://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.*

<Steps>
  <Step title="Den Bereich „Integration“ öffnen">
    1. Melden Sie sich als Administrator bei [admin.goninjio.com](https://admin.goninjio.com/) an.
    2. Wählen Sie oben rechts auf dem Bildschirm **Integration** aus.
  </Step>

  <Step title="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.

    <Warning>
      Kopieren Sie den Schlüssel jetzt. NINJIO zeigt ihn nur einmal an und kann ihn nicht erneut anzeigen.
    </Warning>
  </Step>
</Steps>

***

## 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.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Feld | Wert |
    | - | - |
    | **API-Schlüssel** | Der Schlüssel, den Sie in Teil A erzeugt haben |
  </ConnectInPlatform>
</Steps>

Sie sind nun mit NINJIO verbunden.

***

## Wie oft Daten abgerufen werden

| Daten | Zeitplan |
| - | - |
| Lernende | Täglich |
| Schulungsergebnisse | Alle 6 Stunden |
| Phishing-Ergebnisse | Alle 6 Stunden |

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.

<Note>
  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.
</Note>

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    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.
  </Accordion>

  <Accordion title="403 Forbidden">
    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.
  </Accordion>

  <Accordion title="Verbindung erfolgreich, aber keine Schulungsdaten">
    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.
  </Accordion>

  <Accordion title="Schulung wird als zugewiesen, aber nie als abgeschlossen angezeigt">
    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.
  </Accordion>

  <Accordion title="Einige Lernende fehlen">
    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.
  </Accordion>

  <Accordion title="Phishing-Ergebnisse für eine ältere Simulation fehlen">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.