Skip to main content

Vad den här integrationen bidrar med

KnowBe4 kan bidra med resultat avseende arbetsstyrka, utbildning och phishing-simuleringar. Granskade exempel inkluderar:
  • training.completed — slutför säkerhetsutbildning
  • training.past.due — har försenad utbildning
  • phishing.simulation.clicked — klickade på en simulering utan att rapportera den
Dessa exempel visar vilka typer av normaliserad aktivitet som Living Security kan använda. Se hur integrationsdata blir signaler.

Vad Living Security behöver

Behörighetsomfång: Inget att konfigurera — Reporting API-token i KnowBe4 är skrivskyddade till sin utformning och har inga behörighetsomfång. Token ger läsåtkomst till användare, utbildningsregistreringar och resultat från phishing-säkerhetstester, vilket är exakt vad synkroniseringen läser. Obligatorisk roll: Account Admin i KnowBe4 (endast kontoadministratörer har åtkomst till Account Settings → API)

Förutsättningar

  • Du måste vara inloggad i din KnowBe4-konsol med rollen Account Admin. Endast kontoadministratörer har åtkomst till Account Settings → API för att aktivera Reporting API och generera token.

Del A — I KnowBe4

Din KnowBe4-administratör utför dessa steg.
1

Aktivera Reporting API och generera en token

  1. Logga in i din KnowBe4-konsol.
  2. Klicka på ditt kontonamn i det övre högra hörnet och välj Account Settings.
  3. Välj API i navigeringen till vänster.
  4. Aktivera Reporting API om det inte redan är aktiverat och generera sedan en ny API-token.
Ange ett beskrivande syfte för token (t.ex. Living Security Platform) om din konsol ber om det.
KnowBe4 visar API-token-värdet endast en gång när den genereras. Kopiera den direkt och lagra den på en säker plats (t.ex. ett lösenordsvalv eller en hemlighetshanterare). Om du lämnar sidan utan att kopiera den måste du generera en ny token.
Reporting API är skrivskyddat. Det exponerar användare, utbildningsregistreringar och resultat från phishing-säkerhetstester — de data som Living Security importerar för poängsättning och rapportering. Ingen skrivåtkomst krävs.
2

Lägg till Living Securitys utgående IP-adresser i listan Allowed IP Addresses

I KnowBe4 kan du begränsa åtkomsten till Reporting API till en viss uppsättning käll-IP-adresser. Den här inställningen finns på samma plats som token:
  1. Gå till Account Settings → API → Allowed IP Addresses i din KnowBe4-konsol.
  2. Lägg till varje utgående IP-adress för Living Security i tillåtelselistan. Samma fyra adresser gäller i alla regioner.
Om listan Allowed IP Addresses är konfigurerad tillämpas den på nätverksnivå. Anslutningsdialogen lyckas vid autentiseringen, men datasynkroniseringar misslyckas (blockeras på nätverksnivå och visas vanligtvis som 403) tills Living Securitys utgående IP-adresser har lagts till i tillåtelselistan. Om du lägger till någon adress i den här listan måste du även lägga till Living Securitys adressintervall, annars avvisas våra begäranden trots att din token är giltig.
Living Securitys utgående IP-adresser kan ändras när infrastrukturen uppdateras, även om sådana ändringar är sällsynta. Om datasynkroniseringar börjar misslyckas efter att tidigare ha fungerat, se Konfigurera utgående IP-adresser för integrationer och kontrollera att listan Allowed IP Addresses stämmer överens.
3

Identifiera din KnowBe4-serverregion

KnowBe4 tillhandahåller Reporting API från en regionsspecifik värd. Du väljer region i anslutningsdialogen i stället för att skriva in ett värdnamn:Om du är osäker på vilken region ditt konto använder kan du kontrollera domänen i webbadressen till din KnowBe4-konsol eller kontakta din KnowBe4-administratör.
Dessa fem regioner är de som Living Security kan nå. Om ditt KnowBe4-konto finns på en annan server (till exempel en amerikansk myndighetsinstans) ska du kontakta Living Securitys support innan du påbörjar anslutningen.

Del B — I Living Security Platform

Programansvarig utför det här steget, eller systemadministratören om delegerad konfigurering används.
Du är nu ansluten till KnowBe4.

Felsökning

API-token är ogiltig eller har upphört att gälla. Kontrollera att token är korrekt och inte har genererats om under Account Settings → API.
Antingen saknar token åtkomst till Reporting API, eller så finns begärans IP-adress inte i listan Allowed IP Addresses. Kontrollera att Reporting API är aktiverat och att alla fyra utgående IP-adresser för Living Security finns i tillåtelselistan.
Reporting API har kanske ännu inga data att returnera, eller så saknar tokenens konto insyn i de användare och kampanjer som Living Security importerar. Kontrollera att token genererades av en Account Admin.