> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Konfiguracja integracji z KnowBe4

> Połącz KnowBe4 z Living Security Platform, aby importować użytkowników, zapisy na szkolenia oraz wyniki testów bezpieczeństwa phishingowego.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Powiązane zasoby</h2>
    <ul>
      <li>
        <a href="/pl/signals/data-sources">Dowiedz się, w jaki sposób dane z integracji stają się sygnałami w ramach zarządzania ryzykiem związanym z czynnikiem ludzkim (Human Risk Management)</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Poznaj integracje Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Otwórz Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Poproś o demonstrację Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Dodaj wszystkie cztery adresy IP ruchu wychodzącego synchronizacji Living Security</strong> do listy dozwolonych w{' '}
    {system}. Jeśli {system} oczekuje notacji CIDR, wprowadź każdy adres jako pojedynczego hosta z sufiksem <code>/32</code>:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Ruch może wychodzić z dowolnego z tych czterech adresów, dlatego dodanie do listy dozwolonych tylko niektórych z nich powoduje sporadyczne błędy synchronizacji. Te cztery adresy są takie same we wszystkich regionach Living Security. Pełną listę, zasady wprowadzania zmian oraz wskazówki dotyczące rozwiązywania problemów znajdziesz w artykule{' '}
    <a href="/pl/integrations/managing/egress-ip-addresses">
      Konfigurowanie adresów IP ruchu wychodzącego integracji
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Wprowadź dane uwierzytelniające w Living Security Platform">
    <p>
      Czynność wykonuje osoba posiadająca dostęp do Living Security — właściciel programu lub
      administrator systemu, jeśli został zaproszony (konfiguracja delegowana).
    </p>
    <ol>
      <li>
        Przejdź do <strong>Ustawienia → Integracje → Katalog</strong>, znajdź kafelek{' '}
        <strong>{tile}</strong> i kliknij <strong>Połącz</strong>.
      </li>
      <li>
        Wypełnij poniższe pola, a następnie kliknij <strong>Połącz</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Ten przewodnik jest przeznaczony dla administratora systemu {system}.</strong> Opisuje tworzenie
      poświadczeń API w systemie {system}, co wymaga uprawnień administracyjnych w systemie {system}, a nie w
      Living Security Platform.
    </p>
    <p>
      Jeśli jesteś <strong>właścicielem programu</strong> Living Security i nie administrujesz systemem {system},
      przekaż tę stronę osobie, która nim administruje. Osoba ta wykona część A i przekaże Ci poświadczenia
      (lub wprowadzi je bezpośrednio, jeśli została zaproszona do platformy).
      {recommendDelegated && <>
          {' '}Ponieważ konfiguracja generuje poufny materiał kluczowy, zalecamy skorzystanie ze ścieżki{' '}
          <strong>konfiguracji delegowanej</strong>, dzięki której tajny klucz nigdy nie zostanie do Ciebie odesłany.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## 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](/pl/signals/data-sources).

## Czego potrzebuje Living Security

| Dane uwierzytelniające | Opis |
| - | - |
| **Klucz API** | Token okaziciela Reporting API wygenerowany w sekcji **Account Settings → API**. Wysyłany w każdym żądaniu w nagłówku `Authorization: Bearer`. |
| **Region serwera Reporting API** | Region, w którym udostępniono Twoje konto KnowBe4, wybierany z listy (US, EU, Canada, UK, Germany). |

**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.*

<Steps>
  <Step title="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`).

    <Warning>
      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.
    </Warning>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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](/pl/integrations/managing/egress-ip-addresses). Te same cztery adresy obowiązują we wszystkich regionach.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **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.
    </Warning>

    <Note>
      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](/pl/integrations/managing/egress-ip-addresses) i upewnij się, że lista Allowed IP Addresses jest z nią zgodna.
    </Note>
  </Step>

  <Step title="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:

    | Region | Host Reporting API |
    | - | - |
    | Stany Zjednoczone | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Kanada | `ca.api.knowbe4.com` |
    | Wielka Brytania | `uk.api.knowbe4.com` |
    | Niemcy | `de.api.knowbe4.com` |

    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.

    <Note>
      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.
    </Note>
  </Step>
</Steps>

***

## Część B — w Living Security Platform

*Ten krok wykonuje właściciel programu lub administrator systemu, jeśli stosowana jest konfiguracja delegowana.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Pole | Wartość |
    | - | - |
    | **Klucz API** | Token Reporting API z części A, krok 1 |
    | **Region serwera Reporting API** | Region z części A, krok 3 (np. Stany Zjednoczone) |
  </ConnectInPlatform>
</Steps>

Połączenie z KnowBe4 zostało nawiązane.

***

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Token API jest nieprawidłowy lub wygasł. Sprawdź, czy token jest poprawny i czy nie został ponownie wygenerowany w **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    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](/pl/integrations/managing/egress-ip-addresses) znajdują się na liście dozwolonych.
  </Accordion>

  <Accordion title="Puste wyniki (200 OK, ale brak danych)">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.