Skip to main content

​
Co wnosi ta integracja

KnowBe4 może dostarczać dane dotyczące pracowników, szkoleń oraz rezultatów symulacji phishingu. Sprawdzone przykłady obejmują:
  • training.completed — ukończył(a) szkolenie z zakresu bezpieczeństwa
  • training.past.due — ma zaległe szkolenie
  • phishing.simulation.clicked — kliknął(-ęła) w symulację bez zgłoszenia
Przykłady te pokazują typy znormalizowanej aktywności, które może wykorzystywać Living Security. Zobacz jak dane z integracji stają się sygnałami.

​
Czego potrzebuje Living Security

Zakresy uprawnień: Brak elementów do skonfigurowania — tokeny KnowBe4 Reporting API są z założenia tylko do odczytu i nie mają zakresów. Token zapewnia dostęp do odczytu użytkowników, zapisów na szkolenia oraz wyników testów bezpieczeństwa phishingowego, czyli dokładnie tych danych, które są odczytywane podczas synchronizacji. Wymagana rola: Account Admin w KnowBe4 (tylko administratorzy konta mają dostęp do Account Settings → API)

​
Wymagania wstępne

  • Musisz być zalogowany(-a) do konsoli KnowBe4 z rolą Account Admin. Tylko administratorzy konta mają dostęp do Account Settings → API, gdzie można włączyć Reporting API i generować tokeny.

​
Część A — w KnowBe4

Te kroki wykonuje administrator KnowBe4.
1

Włączenie Reporting API i wygenerowanie tokenu

  1. Zaloguj się do konsoli KnowBe4.
  2. Kliknij nazwę swojego konta w prawym górnym rogu i wybierz Account Settings.
  3. W nawigacji po lewej stronie wybierz API.
  4. Włącz Reporting API, jeśli nie jest jeszcze włączone, a następnie wygeneruj nowy token API.
Jeśli konsola wyświetli prośbę o podanie przeznaczenia tokenu, nadaj mu opisowe przeznaczenie (np. Living Security Platform).
KnowBe4 wyświetla wartość tokenu API tylko raz — podczas jego generowania. Skopiuj ją natychmiast i zapisz w bezpiecznym miejscu (np. w menedżerze haseł lub magazynie sekretów). Jeśli opuścisz stronę bez skopiowania tokenu, konieczne będzie wygenerowanie nowego.
Reporting API jest tylko do odczytu. Udostępnia użytkowników, zapisy na szkolenia oraz wyniki testów bezpieczeństwa phishingowego — dane, które Living Security pobiera na potrzeby oceny i raportowania. Dostęp do zapisu nie jest wymagany.
2

Dodanie adresów IP ruchu wychodzącego Living Security do listy Allowed IP Addresses

KnowBe4 umożliwia ograniczenie dostępu do Reporting API do określonego zestawu źródłowych adresów IP. To ustawienie znajduje się w tym samym miejscu co token:
  1. W konsoli KnowBe4 przejdź do Account Settings → API → Allowed IP Addresses.
  2. Dodaj do listy dozwolonych każdy adres IP ruchu wychodzącego Living Security. Te same cztery adresy obowiązują we wszystkich regionach.
Jeśli lista Allowed IP Addresses jest skonfigurowana, jest egzekwowana na poziomie sieci. Okno połączenia zakończy się powodzeniem na etapie uwierzytelniania, ale synchronizacje danych będą kończyć się błędem (blokada na poziomie sieci, zwykle objawiająca się jako 403), dopóki adresy IP ruchu wychodzącego Living Security nie zostaną dodane do listy dozwolonych. Jeśli dodasz jakikolwiek adres do tej listy, musisz dodać także zakresy Living Security, w przeciwnym razie nasze żądania zostaną odrzucone, mimo że token jest prawidłowy.
Adresy IP ruchu wychodzącego Living Security mogą ulec zmianie podczas aktualizacji infrastruktury, choć takie zmiany zdarzają się rzadko. Jeśli synchronizacje danych zaczną kończyć się błędem po okresie prawidłowego działania, sprawdź stronę Konfigurowanie adresów IP ruchu wychodzącego integracji i upewnij się, że lista Allowed IP Addresses jest z nią zgodna.
3

Ustalenie regionu serwera KnowBe4

KnowBe4 udostępnia Reporting API z hosta właściwego dla danego regionu. Region wybiera się w oknie połączenia, zamiast wpisywać nazwę hosta:Jeśli nie masz pewności, z którego regionu korzysta Twoje konto, sprawdź domenę adresu URL konsoli KnowBe4 lub skontaktuj się z administratorem KnowBe4.
Jest to pięć regionów, z którymi Living Security może nawiązać połączenie. Jeśli Twoje konto KnowBe4 znajduje się na innym serwerze (na przykład w instancji US Government), skontaktuj się z pomocą techniczną Living Security przed rozpoczęciem konfiguracji połączenia.

​
Część B — w Living Security Platform

Ten krok wykonuje właściciel programu lub administrator systemu, jeśli stosowana jest konfiguracja delegowana.
Połączenie z KnowBe4 zostało nawiązane.

​
Rozwiązywanie problemów

Token API jest nieprawidłowy lub wygasł. Sprawdź, czy token jest poprawny i czy nie został ponownie wygenerowany w Account Settings → API.
Token nie ma dostępu do Reporting API albo adres IP żądania nie znajduje się na liście Allowed IP Addresses. Sprawdź, czy Reporting API jest włączone i czy wszystkie cztery adresy IP ruchu wychodzącego Living Security znajdują się na liście dozwolonych.
Reporting API może jeszcze nie mieć danych do zwrócenia albo konto, dla którego wygenerowano token, nie ma wglądu w użytkowników i kampanie pobierane przez Living Security. Sprawdź, czy token został wygenerowany przez administratora z rolą Account Admin.