Skip to main content

​
Hvad denne integration bidrager med

KnowBe4 kan bidrage med resultater vedrørende arbejdsstyrke, træning og phishing-simulering. Gennemgåede eksempler omfatter:
  • training.completed — gennemfører sikkerhedstræning
  • training.past.due — har forsinket træning
  • phishing.simulation.clicked — har klikket på en simulering uden at rapportere den
Disse eksempler viser de typer af normaliseret aktivitet, som Living Security kan anvende. Se hvordan integrationsdata bliver til signaler.

​
Hvad Living Security har brug for

Scopes: Ingen at konfigurere — KnowBe4 Reporting API-tokens er skrivebeskyttede af design og har ingen scopes. Tokenet giver læseadgang til brugere, tilmeldinger til træning og resultater af phishing-sikkerhedstests, hvilket netop er det, synkroniseringen læser. Påkrævet rolle: Account Admin i KnowBe4 (kun kontoadministratorer har adgang til Account Settings → API)

​
Forudsætninger

  • Du skal være logget ind på din KnowBe4-konsol med rollen Account Admin. Kun kontoadministratorer har adgang til Account Settings → API for at aktivere Reporting API og generere tokens.

​
Del A — I KnowBe4

Din KnowBe4-administrator udfører disse trin.
1

Aktivér Reporting API og generér et token

  1. Log ind på din KnowBe4-konsol.
  2. Klik på dit kontonavn i øverste højre hjørne, og vælg Account Settings.
  3. Vælg API i navigationen til venstre.
  4. Aktivér Reporting API, hvis det ikke allerede er aktiveret, og generér derefter et nyt API-token.
Giv tokenet et beskrivende formål (f.eks. Living Security Platform), hvis din konsol beder om et.
KnowBe4 viser værdien af API-tokenet kun én gang, når det genereres. Kopiér det straks, og gem det et sikkert sted (f.eks. i en adgangskodeboks eller en secrets manager). Hvis du forlader siden uden at kopiere det, skal du generere et nyt token.
Reporting API er skrivebeskyttet. Det stiller brugere, tilmeldinger til træning og resultater af phishing-sikkerhedstests til rådighed — de data, som Living Security indlæser til scoring og rapportering. Der kræves ingen skriveadgang.
2

Føj Living Security-egress-IP'erne til listen Allowed IP Addresses

KnowBe4 giver dig mulighed for at begrænse adgangen til Reporting API til et bestemt sæt kilde-IP-adresser. Denne indstilling findes samme sted som tokenet:
  1. Gå til Account Settings → API → Allowed IP Addresses i din KnowBe4-konsol.
  2. Føj hver Living Security-egress-IP-adresse til allowlisten. De samme fire adresser gælder i alle regioner.
Hvis listen Allowed IP Addresses er konfigureret, håndhæves den på netværkslaget. Forbindelsesdialogen lykkes på godkendelsestidspunktet, men datasynkroniseringer mislykkes (blokeret på netværkslaget og viser sig typisk som en 403), indtil Living Security-egress-IP’erne er føjet til allowlisten. Hvis du tilføjer en adresse til denne liste, skal du også tilføje Living Security-intervallerne, ellers afvises vores anmodninger, selv om dit token er gyldigt.
Living Securitys egress-IP-adresser kan ændre sig, når infrastrukturen opdateres, selv om vi sjældent foretager sådanne ændringer. Hvis datasynkroniseringer begynder at fejle, efter at de tidligere fungerede, skal du se Konfiguration af egress-IP-adresser for integrationer og kontrollere, at listen Allowed IP Addresses stemmer overens.
3

Identificér din KnowBe4-serverregion

KnowBe4 leverer Reporting API fra en regionsspecifik vært. Du vælger din region i forbindelsesdialogen i stedet for at skrive et værtsnavn:Hvis du er usikker på, hvilken region din konto bruger, kan du se domænet i URL’en til din KnowBe4-konsol eller kontakte din KnowBe4-administrator.
Disse fem regioner er dem, som Living Security kan nå. Hvis din KnowBe4-konto ligger på en anden server (f.eks. en amerikansk Government-instans), skal du kontakte Living Securitys support, før du starter forbindelsen.

​
Del B — I Living Security Platform

Programejeren udfører dette trin, eller systemadministratoren, hvis der anvendes delegeret opsætning.
Du er nu forbundet til KnowBe4.

​
Fejlfinding

API-tokenet er ugyldigt eller udløbet. Kontrollér, at tokenet er korrekt, og at det ikke er blevet genereret på ny under Account Settings → API.
Enten mangler tokenet adgang til Reporting API, eller anmodningens IP-adresse står ikke på listen Allowed IP Addresses. Kontrollér, at Reporting API er aktiveret, og at alle fire Living Security-egress-IP-adresser står på allowlisten.
Reporting API har muligvis endnu ikke data at returnere, eller tokenets konto har ikke indsigt i de brugere og kampagner, som Living Security indlæser. Kontrollér, at tokenet er genereret af en Account Admin.