Skip to main content

​
Co tato integrace poskytuje

KnowBe4 může poskytovat data o pracovní síle, školení a výsledcích phishingových simulací. Prověřené příklady zahrnují:
  • training.completed — dokončí školení v oblasti zabezpečení
  • training.past.due — má školení po termínu
  • phishing.simulation.clicked — kliknul na simulaci, aniž by ji nahlásil
Tyto příklady ukazují typy normalizované aktivity, které může Living Security využívat. Viz jak se data z integrací stávají signály.

​
Co Living Security potřebuje

Rozsahy oprávnění (scopes): Není nutné nic konfigurovat — tokeny rozhraní KnowBe4 Reporting API jsou ze své podstaty určeny pouze pro čtení a nemají přiřazené rozsahy. Token poskytuje přístup pro čtení k uživatelům, přihlášením do školení a výsledkům testů zabezpečení proti phishingu, což je přesně to, co synchronizace čte. Požadovaná role: Account Admin v KnowBe4 (do části Account Settings → API mají přístup pouze správci účtu)

​
Předpoklady

  • Musíte být přihlášeni do konzoly KnowBe4 s rolí Account Admin. Pouze správci účtu mají přístup do části Account Settings → API, kde lze povolit Reporting API a generovat tokeny.

​
Část A — v KnowBe4

Tyto kroky provede váš správce KnowBe4.
1

Povolte Reporting API a vygenerujte token

  1. Přihlaste se do konzoly KnowBe4.
  2. Klikněte na název svého účtu v pravém horním rohu a vyberte Account Settings.
  3. V levé navigaci vyberte API.
  4. Pokud ještě není povoleno, povolte Reporting API a poté vygenerujte nový token API.
Pokud vás konzole vyzve k zadání účelu, uveďte popisný účel tokenu (např. Living Security Platform).
KnowBe4 zobrazí hodnotu tokenu API pouze jednou, a to při jeho vygenerování. Ihned ji zkopírujte a uložte na bezpečné místo (např. do správce hesel nebo trezoru tajných klíčů). Pokud stránku opustíte, aniž byste token zkopírovali, musíte vygenerovat nový.
Reporting API je určeno pouze pro čtení. Zpřístupňuje uživatele, přihlášení do školení a výsledky testů zabezpečení proti phishingu — tedy data, která Living Security přijímá pro účely hodnocení a reportování. Přístup pro zápis není vyžadován.
2

Přidejte odchozí IP adresy Living Security do seznamu Allowed IP Addresses

KnowBe4 umožňuje omezit přístup k Reporting API na určitou sadu zdrojových IP adres. Toto nastavení se nachází na stejném místě jako token:
  1. V konzole KnowBe4 přejděte do části Account Settings → API → Allowed IP Addresses.
  2. Přidejte do seznamu povolených každou odchozí IP adresu Living Security. Stejné čtyři adresy platí ve všech oblastech.
Pokud je seznam Allowed IP Addresses nakonfigurován, je vynucován na síťové vrstvě. Dialog připojení při ověřování uspěje, ale synchronizace dat selžou (budou zablokovány na síťové vrstvě, což se obvykle projeví jako 403), dokud nebudou odchozí IP adresy Living Security přidány do seznamu povolených. Pokud do tohoto seznamu přidáte jakoukoli adresu, musíte přidat také rozsahy Living Security, jinak budou naše požadavky odmítnuty, i když je váš token platný.
Odchozí IP adresy Living Security se mohou při aktualizaci infrastruktury změnit, i když takové změny provádíme jen výjimečně. Pokud synchronizace dat začnou selhávat poté, co dříve fungovaly, zkontrolujte Konfiguraci odchozích IP adres integrací a ověřte, že seznam Allowed IP Addresses odpovídá.
3

Zjistěte oblast svého serveru KnowBe4

KnowBe4 poskytuje Reporting API z hostitele specifického pro danou oblast. Oblast vyberete v dialogu připojení, název hostitele nezadáváte:Pokud si nejste jisti, kterou oblast váš účet používá, zkontrolujte doménu v adrese URL konzoly KnowBe4 nebo se obraťte na svého správce KnowBe4.
Těchto pět oblastí je dostupných pro Living Security. Pokud je váš účet KnowBe4 na jiném serveru (například v instanci pro vládu USA), obraťte se před zahájením připojení na podporu Living Security.

​
Část B — v Living Security Platform

Tento krok provede vlastník programu, nebo správce systému, pokud se používá delegované nastavení.
Nyní jste připojeni ke KnowBe4.

​
Řešení potíží

Token API je neplatný nebo mu vypršela platnost. Ověřte, že je token správný a že nebyl znovu vygenerován v části Account Settings → API.
Buď token nemá přístup k Reporting API, nebo IP adresa požadavku není v seznamu Allowed IP Addresses. Ověřte, že je Reporting API povoleno a že všechny čtyři odchozí IP adresy Living Security jsou v seznamu povolených.
Reporting API možná zatím nemá žádná data k vrácení, nebo účet, ke kterému token patří, nemá přístup k uživatelům a kampaním, které Living Security přijímá. Ověřte, že token vygeneroval uživatel s rolí Account Admin.