Skip to main content

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

​
Wat Living Security nodig heeft

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

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

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 toe aan de toegestane lijst. Dezelfde vier adressen gelden voor alle regio’s.
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.
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 en controleer of de lijst Allowed IP Addresses overeenkomt.
3

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

​
Deel B — In het Living Security Platform

De programma-eigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.
U bent nu verbonden met KnowBe4.

​
Probleemoplossing

Het API-token is ongeldig of verlopen. Controleer of het token juist is en niet opnieuw is gegenereerd in Account Settings → API.
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 op de toegestane lijst staan.
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.