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

# NINJIO-integratie instellen

> Koppel NINJIO aan het Living Security Platform om resultaten van security awareness-trainingen en uitkomsten van phishingsimulaties voor uw personeelsbestand te importeren.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Gerelateerde bronnen</h2>
    <ul>
      <li>
        <a href="/nl/signals/data-sources">Lees hoe integratiegegevens worden omgezet in Human Risk Management-signalen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ontdek de integraties van Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Open het Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Vraag een demo van Living Security aan</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Voer de inloggegevens in het Living Security Platform in">
    <p>
      Uit te voeren door degene die toegang heeft tot Living Security — de programma-eigenaar, of de
      systeembeheerder als deze is uitgenodigd (gedelegeerde installatie).
    </p>
    <ol>
      <li>
        Ga naar <strong>instellingen → Integraties → Catalog</strong>, zoek de tegel{' '}
        <strong>{tile}</strong> en klik op <strong>verbinden</strong>.
      </li>
      <li>
        Vul de onderstaande velden in en klik vervolgens op <strong>verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Deze handleiding is bedoeld voor uw {system}-beheerder.</strong> Hierin wordt beschreven hoe u API-referenties aanmaakt in {system}. Hiervoor is beheerderstoegang tot {system} vereist, niet tot het
      Living Security Platform.
    </p>
    <p>
      Als u de <strong>programma-eigenaar</strong> van Living Security bent en {system} niet beheert,
      stuur deze pagina dan door naar de persoon die dat wel doet. Die persoon voltooit deel A en geeft de referenties aan u terug
      (of voert ze rechtstreeks in als u diegene hebt uitgenodigd voor het platform).
      {recommendDelegated && <>
          {' '}Omdat tijdens de installatie gevoelig sleutelmateriaal wordt gegenereerd, raden wij het{' '}
          <strong>gedelegeerde installatietraject</strong> aan, zodat het geheim nooit naar u wordt teruggestuurd.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## Wat deze integratie bijdraagt

NINJIO kan resultaten aanleveren over het personeelsbestand, trainingen en phishingsimulaties. Beoordeelde voorbeelden zijn onder andere:

* `training.assigned` — heeft een securitytraining toegewezen gekregen
* `training.completed` — rondt een securitytraining af
* `training.passed` — slaagt voor de toetsen van een securitytraining
* `phishing.simulation.clicked` — heeft op een simulatie geklikt zonder deze te melden
* `phishing.simulation.reported` — meldt phishingsimulaties

Deze voorbeelden laten de soorten genormaliseerde activiteit zien die Living Security kan gebruiken. Zie [hoe integratiegegevens Signalen worden](/nl/signals/data-sources).

## Wat Living Security nodig heeft

| Inloggegevens | Beschrijving |
| - | - |
| **API-sleutel** | Een NINJIO API-sleutel met leestoegang tot de toegangspunten voor medewerkers, training en phishing. Living Security verstuurt deze bij elk verzoek. |

**Scopes:** NINJIO beperkt elke API-sleutel per *toegangspunt*, met aparte lees- en schrijfrechten. Living Security heeft **leesrechten** nodig op drie toegangspunten: medewerkers, training en phishing. Schrijftoegang is niet nodig en mag niet worden verleend.

**Vereiste rol:** een **Administrator** in uw NINJIO-account. Alleen beheerders hebben toegang tot het gedeelte Integration waar sleutels worden aangemaakt.

<Warning>
  **NINJIO toont een nieuwe sleutel slechts één keer, op het moment dat deze wordt aangemaakt.** Kopieer de sleutel direct naar het Living Security Platform, of naar een wachtwoordkluis, voordat u wegnavigeert. Een sleutel die u niet hebt gekopieerd, kan niet meer worden opgehaald — u moet dan een nieuwe sleutel genereren.
</Warning>

### Wat Living Security ophaalt

| Gegevens | Details |
| - | - |
| **Cursisten** | Uw NINJIO-medewerkersmap: naam, e-mailadres, afdeling, functietitel, manager, land, vestiging en actieve status. |
| **Training** | Aan wie elke training is toegewezen en wie deze heeft afgerond — met afrondingsdatum, examenscore en betrokkenheidsscore. |
| **Phishing** | Wie heeft gereageerd op een gesimuleerde phishingmail en wie deze heeft gemeld, met het tijdstip waarop dit gebeurde. |

<Note>
  **Telefoonnummers van Cursisten worden niet opgeslagen.** NINJIO geeft een telefoonnummer terug in het medewerkersrecord. Living Security verwijdert dit voordat er iets wordt opgeslagen, omdat geen enkele functie van Living Security het gebruikt.
</Note>

### Vereisten

* Een NINJIO-account met API-toegang.
* Beheerderstoegang tot [admin.goninjio.com](https://admin.goninjio.com/).
* E-mailadressen van Cursisten in NINJIO die overeenkomen met de adressen die uw andere gekoppelde systemen gebruiken. Living Security koppelt een NINJIO-Cursist aan een persoon via het e-mailadres.

***

## Deel A — In NINJIO

*Uw NINJIO-beheerder voert deze stappen uit.*

<Steps>
  <Step title="Open het gedeelte Integration">
    1. Meld u als beheerder aan bij [admin.goninjio.com](https://admin.goninjio.com/).
    2. Selecteer **Integration** rechtsboven in het scherm.
  </Step>

  <Step title="Maak de API-sleutel aan">
    1. Selecteer **New API Key**.
    2. Geef de sleutel een naam die u later herkent — bijvoorbeeld `Living Security`.
    3. Verleen **leestoegang** tot de toegangspunten **employee**, **training** en **phishing**.
    4. Laat schrijftoegang uitgeschakeld. Living Security leest alleen gegevens uit NINJIO.
    5. Selecteer **Generate Key**.

    <Warning>
      Kopieer de sleutel nu. NINJIO toont deze één keer en kan hem daarna niet opnieuw tonen.
    </Warning>
  </Step>
</Steps>

***

## Deel B — In het Living Security Platform

*De programmaeigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Veld | Waarde |
    | - | - |
    | **API-sleutel** | De sleutel die u in Deel A hebt gegenereerd |
  </ConnectInPlatform>
</Steps>

U bent nu verbonden met NINJIO.

***

## Hoe vaak gegevens worden opgehaald

| Gegevens | Schema |
| - | - |
| Cursisten | Dagelijks |
| Trainingsresultaten | Elke 6 uur |
| Phishingresultaten | Elke 6 uur |

Bij de eerste koppeling haalt Living Security de trainingsafrondingen van de afgelopen 12 maanden op en houdt daarna de gegevens stapsgewijs bij. Phishingsimulaties worden eenmaal uitgelezen en tot twee weken na afloop opnieuw gecontroleerd, zodat late klikken en late meldingen alsnog worden vastgelegd.

<Note>
  Een eerste koppeling met een groot NINJIO-account kan meerdere geplande runs nodig hebben om alles uit te lezen. Elke run leest zoveel als mogelijk is en de volgende run gaat verder waar de vorige is gestopt, zodat de aantallen in de eerste een à twee dagen oplopen in plaats van ineens te verschijnen.
</Note>

***

## Probleemoplossing

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    De API-sleutel is onjuist of onvolledig. De meest voorkomende oorzaak is een sleutel die slechts gedeeltelijk is gekopieerd — NINJIO toont de sleutel één keer, waardoor een afgekapte plakactie makkelijk gebeurt en achteraf niet te herkennen is. Genereer een nieuwe sleutel in NINJIO en maak opnieuw verbinding met die sleutel.
  </Accordion>

  <Accordion title="403 Forbidden">
    Dit is **geen** probleem met de inloggegevens. De sleutel is geauthenticeerd, maar voor een van de benodigde toegangspunten is geen leesrecht verleend.

    Dezelfde sleutel opnieuw plakken helpt niet. Maak in NINJIO een sleutel aan met **leestoegang** tot alle drie de toegangspunten — employee, training en phishing — en maak opnieuw verbinding met die sleutel.
  </Accordion>

  <Accordion title="Verbinding geslaagd, maar geen trainingsgegevens">
    Controleer in NINJIO of ten minste één trainingscampagne **actief** is en een gekoppelde simulatie heeft. Een campagne zonder simulatie blijft inactief en levert niets op, waardoor er geen resultaten zijn om op te halen.

    Als campagnes actief zijn, controleer dan of de Cursisten daarin een e-mailadres in hun NINJIO-record hebben. Een Cursist zonder e-mailadres kan niet aan een persoon worden gekoppeld en wordt overgeslagen.
  </Accordion>

  <Accordion title="Training wordt weergegeven als toegewezen maar nooit afgerond">
    Dat is de verwachte weergave voor een training die een Cursist nog niet heeft afgerond. Living Security legt de toewijzing vast wanneer de NINJIO-simulatie start en legt de afronding apart vast wanneer NINJIO een afrondingsdatum meldt.
  </Accordion>

  <Accordion title="Sommige Cursisten ontbreken">
    Living Security koppelt een NINJIO-Cursist aan een persoon via het **e-mailadres**. Een Cursist van wie het NINJIO-e-mailadres afwijkt van het adres in uw directory — een privéadres, een oud domein of een typefout — wordt niet gekoppeld.

    Corrigeer het adres in NINJIO, dan wordt de Cursist bij de volgende geplande ophaalronde gekoppeld.
  </Accordion>

  <Accordion title="Phishingresultaten ontbreken voor een oudere simulatie">
    Living Security controleert een phishingsimulatie tot twee weken na afloop opnieuw en stopt daarna. Resultaten die NINJIO na die periode vastlegt, worden niet opgehaald. Neem contact op met support als u wilt dat een oudere simulatie opnieuw wordt uitgelezen.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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