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

# KnowBe4-integratie instellen

> Koppel KnowBe4 aan het Living Security Platform om gebruikers, trainingsinschrijvingen en resultaten van phishing-beveiligingstests 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 EgressIpSafelist = ({system}) => <Note>
    <strong>Voeg alle vier de uitgaande IP-adressen voor synchronisatie van Living Security toe</strong> aan de allowlist in{' '}
    {system}. Voer elk adres in als afzonderlijke host met <code>/32</code> als {system} CIDR-notatie verwacht:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Het verkeer kan via elk van de vier adressen uitgaan. Als u slechts een deel ervan op de allowlist zet, leidt dat tot onregelmatige
    synchronisatiefouten. Deze vier adressen zijn in elke regio van Living Security gelijk. Zie{' '}
    <a href="/nl/integrations/managing/egress-ip-addresses">
      Uitgaande IP-adressen van Integraties configureren
    </a>{' '}
    voor de volledige lijst, het wijzigingsbeleid en probleemoplossing.
  </Note>;

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="KnowBe4" />

## Wat deze integratie bijdraagt

KnowBe4 kan resultaten op het gebied van personeelsbestand, training en phishingsimulaties aanleveren. Beoordeelde voorbeelden zijn onder meer:

* `training.completed` — rondt beveiligingstraining af
* `training.past.due` — heeft achterstallige training
* `phishing.simulation.clicked` — heeft op een simulatie geklikt zonder dit te melden

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

## Wat Living Security nodig heeft

| Referentie | Beschrijving |
| - | - |
| **API-sleutel** | Een bearer-token voor de Reporting API, gegenereerd onder **Account Settings → API**. Wordt bij elk verzoek meegestuurd in de header `Authorization: Bearer`. |
| **Reporting API server region** | De regio waarin uw KnowBe4-account is ingericht, te kiezen uit een lijst (US, EU, Canada, UK, Germany). |

**Scopes:** Er hoeft niets te worden geconfigureerd — KnowBe4 Reporting API-tokens zijn van nature alleen-lezen en hebben geen scopes. Het token geeft leestoegang tot gebruikers, trainingsinschrijvingen en resultaten van phishing-beveiligingstests, en dat is precies wat de synchronisatie uitleest.

**Vereiste rol:** **Account Admin** in KnowBe4 (alleen accountbeheerders hebben toegang tot **Account Settings → API**)

### Vereisten

* U moet zijn aangemeld bij uw KnowBe4-console met de rol **Account Admin**. Alleen accountbeheerders hebben toegang tot **Account Settings → API** om de Reporting API in te schakelen en tokens te genereren.

***

## Deel A — In KnowBe4

*Uw KnowBe4-beheerder voert deze stappen uit.*

<Steps>
  <Step title="De Reporting API inschakelen en een token genereren">
    1. Meld u aan bij uw KnowBe4-console.
    2. Klik rechtsboven op uw accountnaam en selecteer **Account Settings**.
    3. Selecteer in de navigatie links **API**.
    4. Schakel de **Reporting API** in als deze nog niet is ingeschakeld en genereer vervolgens een nieuw API-token.

    Geef het token een beschrijvend doel (bijvoorbeeld `Living Security Platform`) als uw console hierom vraagt.

    <Warning>
      KnowBe4 toont de waarde van het API-token **slechts één keer**, op het moment dat het wordt gegenereerd. Kopieer het direct en bewaar het op een veilige plaats (bijvoorbeeld in een wachtwoordkluis of secrets manager). Als u de pagina verlaat zonder het te kopiëren, moet u een nieuw token genereren.
    </Warning>

    <Note>
      De Reporting API is alleen-lezen. Deze geeft toegang tot gebruikers, trainingsinschrijvingen en resultaten van phishing-beveiligingstests — de gegevens die Living Security importeert voor scoring en rapportage. Schrijftoegang is niet nodig.
    </Note>
  </Step>

  <Step title="De uitgaande IP-adressen van Living Security toevoegen aan de lijst Allowed IP Addresses">
    Met KnowBe4 kunt u de toegang tot de Reporting API beperken tot een specifieke set bron-IP-adressen. Deze instelling bevindt zich op dezelfde plek als het token:

    1. Ga in uw KnowBe4-console naar **Account Settings → API → Allowed IP Addresses**.
    2. Voeg elk [uitgaand IP-adres van Living Security](/nl/integrations/managing/egress-ip-addresses) toe aan de toegestane lijst. Dezelfde vier adressen gelden voor alle regio's.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Als de lijst Allowed IP Addresses is geconfigureerd, wordt deze afgedwongen op netwerkniveau.** Het verbindingsvenster slaagt bij de authenticatie, maar gegevenssynchronisaties mislukken (geblokkeerd op netwerkniveau, meestal zichtbaar als een `403`) totdat de uitgaande IP-adressen van Living Security aan de toegestane lijst zijn toegevoegd. Als u een adres aan deze lijst toevoegt, moet u ook de IP-bereiken van Living Security toevoegen, anders worden onze verzoeken geweigerd, ook al is uw token geldig.
    </Warning>

    <Note>
      De uitgaande IP-adressen van Living Security kunnen veranderen wanneer de infrastructuur wordt bijgewerkt, hoewel dit zelden gebeurt. Als gegevenssynchronisaties na eerder correct te hebben gewerkt beginnen te mislukken, raadpleeg dan [Uitgaande IP-adressen van integraties configureren](/nl/integrations/managing/egress-ip-addresses) en controleer of de lijst Allowed IP Addresses overeenkomt.
    </Note>
  </Step>

  <Step title="Uw KnowBe4-serverregio bepalen">
    KnowBe4 levert de Reporting API vanaf een regiospecifieke host. U selecteert uw regio in het verbindingsvenster in plaats van een hostnaam in te typen:

    | Regio | Reporting API-host |
    | - | - |
    | Verenigde Staten | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Canada | `ca.api.knowbe4.com` |
    | Verenigd Koninkrijk | `uk.api.knowbe4.com` |
    | Duitsland | `de.api.knowbe4.com` |

    Als u niet zeker weet welke regio uw account gebruikt, controleer dan het domein van de URL van uw KnowBe4-console of neem contact op met uw KnowBe4-beheerder.

    <Note>
      Deze vijf regio's zijn de regio's die Living Security kan bereiken. Als uw KnowBe4-account op een andere server staat (bijvoorbeeld een US Government-instantie), neem dan contact op met de support van Living Security voordat u de verbinding start.
    </Note>
  </Step>
</Steps>

***

## Deel B — In het Living Security Platform

*De programma-eigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Veld | Waarde |
    | - | - |
    | **API-sleutel** | Het Reporting API-token uit deel A, stap 1 |
    | **Reporting API server region** | De regio uit deel A, stap 3 (bijvoorbeeld Verenigde Staten) |
  </ConnectInPlatform>
</Steps>

U bent nu verbonden met KnowBe4.

***

## Probleemoplossing

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Het API-token is ongeldig of verlopen. Controleer of het token juist is en niet opnieuw is gegenereerd in **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Of het token heeft geen toegang tot de Reporting API, of het IP-adres van het verzoek staat niet op de lijst Allowed IP Addresses. Controleer of de Reporting API is ingeschakeld en of alle vier de [uitgaande IP-adressen van Living Security](/nl/integrations/managing/egress-ip-addresses) op de toegestane lijst staan.
  </Accordion>

  <Accordion title="Lege resultaten (200 OK maar geen gegevens)">
    Mogelijk heeft de Reporting API nog geen gegevens om terug te geven, of heeft het account van het token geen inzicht in de gebruikers en campagnes die Living Security importeert. Controleer of het token is gegenereerd door een Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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