> ## 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 NINJIO

> Połącz NINJIO z Living Security Platform, aby importować wyniki szkoleń z zakresu świadomości bezpieczeństwa oraz rezultaty symulacji phishingu dla swoich pracowników.

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 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="NINJIO" />

## Jakie dane dostarcza ta integracja

NINJIO może dostarczać dane dotyczące pracowników, szkoleń oraz rezultatów symulacji phishingu. Sprawdzone przykłady obejmują:

* `training.assigned` — ma przypisane szkolenie z zakresu bezpieczeństwa
* `training.completed` — ukończył(a) szkolenie z zakresu bezpieczeństwa
* `training.passed` — zaliczył(a) testy sprawdzające po szkoleniu z zakresu bezpieczeństwa
* `phishing.simulation.clicked` — kliknął(-ęła) w symulację bez zgłoszenia
* `phishing.simulation.reported` — zgłasza symulacje phishingu

Te przykłady przedstawiają rodzaje znormalizowanej aktywności, które może wykorzystywać Living Security. Zobacz [jak dane z integracji stają się sygnałami](/pl/signals/data-sources).

## Czego wymaga Living Security

| Poświadczenie | Opis |
| - | - |
| **Klucz API** | Klucz API NINJIO z dostępem do odczytu w punktach dostępu dotyczących pracowników, szkoleń i phishingu. Living Security przesyła go w każdym żądaniu. |

**Zakresy uprawnień:** NINJIO określa zakresy każdego klucza API osobno dla każdego *punktu dostępu*, z oddzielnymi uprawnieniami do odczytu i zapisu. Living Security wymaga uprawnienia **odczytu** w trzech punktach: pracownicy, szkolenia i phishing. Dostęp do zapisu nie jest potrzebny i nie należy go przyznawać.

**Wymagana rola:** **Administrator** na Twoim koncie NINJIO. Tylko administratorzy mają dostęp do obszaru Integration, w którym tworzy się klucze.

<Warning>
  **NINJIO wyświetla nowy klucz tylko raz, w momencie jego utworzenia.** Skopiuj go bezpośrednio do Living Security Platform lub do menedżera haseł, zanim opuścisz tę stronę. Klucza, który nie został skopiowany, nie można odzyskać — trzeba wygenerować nowy.
</Warning>

### Jakie dane pobiera Living Security

| Dane | Szczegóły |
| - | - |
| **Uczestnicy szkoleń** | Katalog pracowników w NINJIO: imię i nazwisko, adres e-mail, dział, stanowisko, przełożony, kraj, oddział oraz status aktywny. |
| **Szkolenie** | Kto otrzymał przypisanie poszczególnych szkoleń i kto je ukończył — wraz z datą ukończenia, wynikiem egzaminu i wynikiem zaangażowania. |
| **Wyłudzanie informacji** | Kto wszedł w interakcję z symulowanym e-mailem phishingowym i kto go zgłosił, wraz z czasem zdarzenia. |

<Note>
  **Numery telefonów uczestników szkoleń nie są przechowywane.** NINJIO zwraca numer telefonu w rekordzie pracownika. Living Security usuwa go przed zapisaniem jakichkolwiek danych, ponieważ żadna funkcja Living Security z niego nie korzysta.
</Note>

### Wymagania wstępne

* Konto NINJIO z dostępem do API.
* Dostęp administratora do [admin.goninjio.com](https://admin.goninjio.com/).
* Adresy e-mail uczestników szkoleń w NINJIO zgodne z adresami używanymi w pozostałych połączonych systemach. Adres e-mail służy Living Security do dopasowania uczestnika szkolenia z NINJIO do osoby.

***

## Część A — w NINJIO

*Te kroki wykonuje administrator NINJIO.*

<Steps>
  <Step title="Otwórz obszar Integration">
    1. Zaloguj się w [admin.goninjio.com](https://admin.goninjio.com/) jako administrator.
    2. Wybierz **Integration** w prawym górnym rogu ekranu.
  </Step>

  <Step title="Utwórz klucz API">
    1. Wybierz **New API Key**.
    2. Nadaj kluczowi nazwę, którą łatwo rozpoznasz w przyszłości — na przykład `Living Security`.
    3. Przyznaj dostęp do **odczytu** w punktach dostępu **employee**, **training** i **phishing**.
    4. Pozostaw dostęp do zapisu niezaznaczony. Living Security jedynie odczytuje dane z NINJIO.
    5. Wybierz **Generate Key**.

    <Warning>
      Skopiuj klucz teraz. NINJIO wyświetla go tylko raz i nie można go pokazać ponownie.
    </Warning>
  </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="NINJIO">
    | Pole | Wartość |
    | - | - |
    | **Klucz API** | Klucz wygenerowany w części A |
  </ConnectInPlatform>
</Steps>

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

***

## Jak często dane są pobierane

| Dane | Harmonogram |
| - | - |
| Uczestnicy szkoleń | Codziennie |
| Wyniki szkoleń | Co 6 godzin |
| Wyniki symulacji phishingu | Co 6 godzin |

Przy pierwszym połączeniu Living Security pobiera ukończone szkolenia z ostatnich 12 miesięcy, a następnie na bieżąco uzupełnia dane przyrostowo. Każda symulacja phishingu jest odczytywana jednorazowo, a następnie ponownie sprawdzana przez dwa tygodnie po zakończeniu, aby uwzględnić późne kliknięcia i późne zgłoszenia.

<Note>
  Pierwsze połączenie z dużym kontem NINJIO może wymagać kilku zaplanowanych uruchomień, zanim wszystkie dane zostaną odczytane. Każde uruchomienie odczytuje tyle danych, ile to możliwe, a kolejne kontynuuje od miejsca zatrzymania, dlatego liczby rosną stopniowo w ciągu pierwszej doby lub dwóch, zamiast pojawić się jednocześnie.
</Note>

***

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Klucz API jest nieprawidłowy lub niekompletny. Najczęstszą przyczyną jest częściowo skopiowany klucz — NINJIO wyświetla go tylko raz, więc łatwo wkleić obcięty ciąg znaków, a później nie da się tego zauważyć. Wygeneruj nowy klucz w NINJIO i ponownie nawiąż połączenie, używając go.
  </Accordion>

  <Accordion title="403 Forbidden">
    To **nie** jest problem z poświadczeniami. Klucz został uwierzytelniony, ale do jednego z wymaganych punktów dostępu nie przyznano uprawnienia do odczytu.

    Ponowne wklejenie tego samego klucza nie pomoże. W NINJIO utwórz klucz z dostępem do **odczytu** we wszystkich trzech punktach dostępu — employee, training i phishing — i ponownie nawiąż połączenie, używając go.
  </Accordion>

  <Accordion title="Połączono pomyślnie, ale brak danych szkoleniowych">
    Sprawdź w NINJIO, czy co najmniej jedna kampania szkoleniowa jest **aktywna** i ma dołączoną symulację. Kampania bez symulacji pozostaje nieaktywna i nie dostarcza danych, więc nie ma wyników do pobrania.

    Jeśli kampanie są aktywne, upewnij się, że uczestnicy szkoleń w nich uwzględnieni mają adresy e-mail w rekordach NINJIO. Uczestnik szkolenia bez adresu e-mail nie może zostać dopasowany do osoby i jest pomijany.
  </Accordion>

  <Accordion title="Szkolenie jest wyświetlane jako przypisane, ale nigdy nie ukończone">
    Jest to oczekiwany sposób wyświetlania szkolenia, którego uczestnik nie ukończył. Living Security rejestruje przypisanie w momencie rozpoczęcia symulacji w NINJIO, a ukończenie rejestruje oddzielnie, gdy NINJIO przekaże datę ukończenia.
  </Accordion>

  <Accordion title="Brakuje niektórych uczestników szkoleń">
    Living Security dopasowuje uczestnika szkolenia z NINJIO do osoby na podstawie **adresu e-mail**. Uczestnik, którego adres e-mail w NINJIO różni się od adresu zapisanego w Twoim katalogu — na przykład adres prywatny, stara domena lub literówka — nie zostanie dopasowany.

    Popraw adres w NINJIO, a zostanie on dopasowany podczas następnego zaplanowanego pobierania danych.
  </Accordion>

  <Accordion title="Brak wyników symulacji phishingu dla starszej symulacji">
    Living Security ponownie sprawdza symulację phishingu przez dwa tygodnie po jej zakończeniu, a następnie przestaje. Wyniki zarejestrowane przez NINJIO po tym okresie nie są pobierane. Jeśli potrzebujesz ponownego odczytu starszej symulacji, skontaktuj się z pomocą techniczną.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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