Skip to main content

Mitä tämä integraatio tuo mukanaan

KnowBe4 voi tuottaa työvoimaan, koulutukseen ja tietojenkalastelusimulaatioihin liittyviä tuloksia. Tarkastettuja esimerkkejä ovat:
  • training.completed — suorittaa tietoturvakoulutuksen
  • training.past.due — koulutus on myöhässä
  • phishing.simulation.clicked — klikkasi simulaatiota ilmoittamatta siitä
Nämä esimerkit osoittavat, minkä tyyppistä normalisoitua toimintaa Living Security voi hyödyntää. Katso miten integraatiodatasta muodostuu signaaleja.

Mitä Living Security tarvitsee

Oikeusalueet (scopes): Määritettäviä ei ole — KnowBe4 Reporting API -tunnukset ovat suunnittelultaan vain luku -tyyppisiä, eikä niille määritetä oikeusalueita. Tunnus antaa lukuoikeuden käyttäjiin, koulutusilmoittautumisiin ja tietojenkalastelun tietoturvatestien tuloksiin, eli juuri niihin tietoihin, joita synkronointi lukee. Vaadittu rooli: Account Admin KnowBe4:ssä (vain tilin ylläpitäjät voivat käyttää kohtaa Account Settings → API)

Edellytykset

  • Sinun on oltava kirjautuneena KnowBe4-konsoliin Account Admin -roolilla. Vain tilin ylläpitäjät voivat käyttää kohtaa Account Settings → API, jossa Reporting API otetaan käyttöön ja tunnukset luodaan.

Osa A — KnowBe4:ssä

KnowBe4-ylläpitäjäsi suorittaa nämä vaiheet.
1

Ota Reporting API käyttöön ja luo tunnus

  1. Kirjaudu KnowBe4-konsoliin.
  2. Napsauta tilisi nimeä oikeassa yläkulmassa ja valitse Account Settings.
  3. Valitse vasemmasta siirtymisvalikosta API.
  4. Ota Reporting API käyttöön, jos se ei ole jo käytössä, ja luo sitten uusi API-tunnus.
Anna tunnukselle kuvaava käyttötarkoitus (esim. Living Security Platform), jos konsoli sitä pyytää.
KnowBe4 näyttää API-tunnuksen arvon vain kerran, kun se luodaan. Kopioi se heti ja tallenna turvalliseen paikkaan (esim. salasanaholviin tai salaisuuksien hallintaan). Jos poistut sivulta kopioimatta tunnusta, sinun on luotava uusi tunnus.
Reporting API on vain luku -tyyppinen. Se tarjoaa käyttäjät, koulutusilmoittautumiset ja tietojenkalastelun tietoturvatestien tulokset — eli tiedot, jotka Living Security ottaa vastaan pisteytystä ja raportointia varten. Kirjoitusoikeutta ei tarvita.
2

Lisää Living Securityn egress-IP-osoitteet Allowed IP Addresses -luetteloon

KnowBe4:ssä Reporting API -käyttö voidaan rajata tiettyihin lähde-IP-osoitteisiin. Tämä asetus sijaitsee samassa paikassa kuin tunnus:
  1. Siirry KnowBe4-konsolissa kohtaan Account Settings → API → Allowed IP Addresses.
  2. Lisää jokainen Living Securityn egress-IP-osoite sallittujen luetteloon. Samat neljä osoitetta koskevat kaikkia alueita.
Jos Allowed IP Addresses -luettelo on määritetty, sitä valvotaan verkkokerroksella. Yhteysikkuna onnistuu todennuksessa, mutta datasynkronoinnit epäonnistuvat (estyvät verkkokerroksella ja näkyvät tyypillisesti muodossa 403), kunnes Living Securityn egress-IP-osoitteet on lisätty sallittujen luetteloon. Jos lisäät luetteloon minkä tahansa osoitteen, sinun on lisättävä myös Living Securityn osoitealueet, muuten pyyntömme hylätään, vaikka tunnuksesi on kelvollinen.
Living Securityn egress-IP-osoitteet voivat muuttua infrastruktuuripäivitysten yhteydessä, vaikka tällaiset muutokset ovat harvinaisia. Jos datasynkronoinnit alkavat epäonnistua aiemman toimivuuden jälkeen, tarkista Integraation egress-IP-osoitteiden määrittäminen ja varmista, että Allowed IP Addresses -luettelo vastaa niitä.
3

Selvitä KnowBe4-palvelinalueesi

KnowBe4 tarjoaa Reporting API:n aluekohtaisesta isännästä. Valitset alueen yhteysikkunassa etkä kirjoita isäntänimeä itse:Jos et ole varma, mitä aluetta tilisi käyttää, tarkista KnowBe4-konsolisi URL-osoitteen verkkotunnus tai ota yhteyttä KnowBe4-ylläpitäjääsi.
Nämä viisi aluetta ovat ne, joihin Living Security voi muodostaa yhteyden. Jos KnowBe4-tilisi on toisella palvelimella (esimerkiksi Yhdysvaltain hallinnon instanssissa), ota yhteyttä Living Securityn tukeen ennen yhteyden muodostamisen aloittamista.

Osa B — Living Security Platformissa

Ohjelman omistaja suorittaa tämän vaiheen, tai järjestelmän ylläpitäjä, jos käytössä on delegoitu käyttöönotto.
Yhteys KnowBe4:ään on nyt muodostettu.

Vianmääritys

API-tunnus on virheellinen tai vanhentunut. Varmista, että tunnus on oikea eikä sitä ole luotu uudelleen kohdassa Account Settings → API.
Joko tunnuksella ei ole Reporting API -käyttöoikeutta, tai pyynnön IP-osoite ei ole Allowed IP Addresses -luettelossa. Varmista, että Reporting API on otettu käyttöön ja että kaikki neljä Living Securityn egress-IP-osoitetta ovat sallittujen luettelossa.
Reporting API:lla ei välttämättä ole vielä palautettavaa dataa, tai tunnuksen tilillä ei ole näkyvyyttä käyttäjiin ja kampanjoihin, joita Living Security ottaa vastaan. Varmista, että tunnuksen on luonut Account Admin.