Skip to main content

Hva denne integrasjonen bidrar med

KnowBe4 kan bidra med utfall knyttet til arbeidsstyrke, opplæring og phishing-simuleringer. Gjennomgåtte eksempler omfatter:
  • training.completed — fullfører sikkerhetsopplæring
  • training.past.due — har forfalt opplæring
  • phishing.simulation.clicked — klikket på en simulering uten å rapportere den
Disse eksemplene viser hvilke typer normalisert aktivitet Living Security kan bruke. Se hvordan integrasjonsdata blir til signaler.

Hva Living Security trenger

Scopes: Ingenting å konfigurere — KnowBe4 Reporting API-tokens er skrivebeskyttede av design og har ingen scopes. Tokenet gir lesetilgang til brukere, påmeldinger til opplæring og resultater fra phishing-sikkerhetstester, og det er nøyaktig dette synkroniseringen leser. Nødvendig rolle: Account Admin i KnowBe4 (bare kontoadministratorer har tilgang til Account Settings → API)

Forutsetninger

  • Du må være logget på KnowBe4-konsollen med rollen Account Admin. Bare kontoadministratorer har tilgang til Account Settings → API for å aktivere Reporting API og generere tokens.

Del A — I KnowBe4

KnowBe4-administratoren din utfører disse trinnene.
1

Aktiver Reporting API og generer et token

  1. Logg på KnowBe4-konsollen din.
  2. Klikk på kontonavnet ditt øverst til høyre og velg Account Settings.
  3. Velg API i navigasjonen til venstre.
  4. Aktiver Reporting API hvis det ikke allerede er aktivert, og generer deretter et nytt API-token.
Gi tokenet et beskrivende formål (f.eks. Living Security Platform) hvis konsollen ber om det.
KnowBe4 viser API-tokenverdien bare én gang når den genereres. Kopier den umiddelbart og lagre den på et sikkert sted (f.eks. en passordhvelv eller en secrets manager). Hvis du navigerer bort uten å kopiere den, må du generere et nytt token.
Reporting API er skrivebeskyttet. Det eksponerer brukere, påmeldinger til opplæring og resultater fra phishing-sikkerhetstester — dataene Living Security henter inn for skåring og rapportering. Det kreves ingen skrivetilgang.
2

Legg til Living Security-egress-IP-adressene i listen over tillatte IP-adresser

KnowBe4 lar deg begrense tilgangen til Reporting API til et bestemt sett med kilde-IP-adresser. Denne innstillingen finnes samme sted som tokenet:
  1. Gå til Account Settings → API → Allowed IP Addresses i KnowBe4-konsollen.
  2. Legg til hver egress-IP-adresse for Living Security i tillatelseslisten. De samme fire adressene gjelder i alle regioner.
Hvis listen over tillatte IP-adresser er konfigurert, håndheves den på nettverksnivå. Tilkoblingsdialogen vil lykkes under autentisering, men datasynkroniseringer vil mislykkes (blokkert på nettverksnivå, vanligvis som 403) helt til Living Security-egress-IP-adressene er lagt til i tillatelseslisten. Hvis du legger til en adresse i denne listen, må du også legge til Living Security-områdene, ellers blir forespørslene våre avvist selv om tokenet ditt er gyldig.
Living Securitys egress-IP-adresser kan endres når infrastrukturen oppdateres, selv om vi holder slike endringer sjeldne. Hvis datasynkroniseringer begynner å feile etter å ha fungert tidligere, kan du se Konfigurere egress-IP-adresser for integrasjoner og kontrollere at listen over tillatte IP-adresser samsvarer.
3

Finn KnowBe4-serverregionen din

KnowBe4 leverer Reporting API fra en regionspesifikk vert. Du velger region i tilkoblingsdialogen i stedet for å skrive inn et vertsnavn:Hvis du er usikker på hvilken region kontoen din bruker, kan du sjekke domenet i URL-en til KnowBe4-konsollen eller kontakte KnowBe4-administratoren din.
Disse fem regionene er de Living Security kan nå. Hvis KnowBe4-kontoen din ligger på en annen server (for eksempel en amerikansk Government-instans), må du kontakte Living Securitys kundestøtte før du starter tilkoblingen.

Del B — I Living Security Platform

Programansvarlig utfører dette trinnet, eller systemadministratoren hvis delegert oppsett brukes.
Du er nå koblet til KnowBe4.

Feilsøking

API-tokenet er ugyldig eller utløpt. Kontroller at tokenet er riktig og ikke er blitt generert på nytt i Account Settings → API.
Enten mangler tokenet tilgang til Reporting API, eller forespørselens IP-adresse står ikke på listen over tillatte IP-adresser. Kontroller at Reporting API er aktivert, og at alle fire egress-IP-adresser for Living Security står i tillatelseslisten.
Reporting API har kanskje ikke data å returnere ennå, eller kontoen tokenet tilhører har ikke innsyn i brukerne og kampanjene Living Security henter inn. Kontroller at tokenet ble generert av en Account Admin.