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

# Налаштування інтеграції з NINJIO

> Підключіть NINJIO до Living Security Platform, щоб імпортувати результати навчання з кібербезпеки та результати Phishing simulation для вашого Workforce.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Пов’язані ресурси</h2>
    <ul>
      <li>
        <a href="/uk/signals/data-sources">Дізнайтеся, як дані інтеграцій перетворюються на сигнали Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ознайомтеся з інтеграціями Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Відкрийте Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Замовте демонстрацію Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Введіть облікові дані в Living Security Platform">
    <p>
      Виконується особою, яка має доступ до Living Security, — власником програми або
      системним адміністратором, якщо його було запрошено (делеговане налаштування).
    </p>
    <ol>
      <li>
        Перейдіть до <strong>Settings → Integrations → Catalog</strong>, знайдіть плитку{' '}
        <strong>{tile}</strong> і натисніть <strong>Connect</strong>.
      </li>
      <li>
        Заповніть наведені нижче поля, а потім натисніть <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Цей посібник призначений для вашого адміністратора {system}.</strong> Він описує створення облікових даних API
      в {system}, для чого потрібен адміністративний доступ до {system}, а не до
      Living Security Platform.
    </p>
    <p>
      Якщо ви є <strong>власником програми</strong> Living Security і не адмініструєте {system},
      надішліть цю сторінку тому, хто це робить. Він виконає частину A і передасть вам облікові дані
      (або введе їх безпосередньо, якщо ви запросили його до платформи).
      {recommendDelegated && <>
          {' '}Оскільки під час налаштування створюється конфіденційний ключовий матеріал, ми рекомендуємо скористатися{' '}
          <strong>делегованим налаштуванням</strong>, щоб секрет ніколи не надсилався вам.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## Який внесок робить ця інтеграція

NINJIO може надавати дані про Workforce, Training та результати Phishing simulation. Серед розглянутих прикладів:

* `training.assigned` — має призначене навчання з безпеки
* `training.completed` — проходить навчання з безпеки
* `training.passed` — успішно складає оцінювання після навчання з безпеки
* `phishing.simulation.clicked` — перейшов за посиланням у симуляції, не повідомивши про неї
* `phishing.simulation.reported` — повідомляє про Phishing simulation

Ці приклади демонструють типи нормалізованої активності, які може використовувати Living Security. Див. [як дані інтеграції перетворюються на Signals](/uk/signals/data-sources).

## Що потрібно для Living Security

| Облікові дані | Опис |
| - | - |
| **API key** | Ключ API NINJIO з доступом на читання до точок доступу працівників, навчання та фішингу. Living Security надсилає його з кожним запитом. |

**Області доступу (scopes):** NINJIO визначає області доступу для кожного ключа API окремо для кожної *точки доступу*, з окремими дозволами на читання та запис. Living Security потрібен дозвіл на **читання** для трьох точок: працівники, навчання та фішинг. Доступ на запис не потрібен, і його не слід надавати.

**Необхідна роль:** **Administrator** в обліковому записі NINJIO. Лише адміністратори мають доступ до розділу Integration, де створюються ключі.

<Warning>
  **NINJIO показує новий ключ лише один раз — у момент його створення.** Скопіюйте його одразу до Living Security Platform або до сховища паролів, перш ніж залишити сторінку. Ключ, який ви не скопіювали, відновити неможливо — доведеться створити новий.
</Warning>

### Які дані отримує Living Security

| Дані | Деталі |
| - | - |
| **Learners** | Ваш довідник працівників NINJIO: ім’я, адреса електронної пошти, відділ, посада, керівник, країна, філія та статус активності. |
| **Training** | Кому було призначено кожне навчання і хто його завершив — з датою завершення, оцінкою за іспит та оцінкою залученості. |
| **Phishing** | Хто взаємодіяв зі змодельованим фішинговим листом і хто повідомив про нього, із зазначенням часу події. |

<Note>
  **Номери телефонів Learners не зберігаються.** NINJIO повертає номер телефону в записі працівника. Living Security видаляє його до збереження будь-яких даних, оскільки жодна функція Living Security його не використовує.
</Note>

### Передумови

* Обліковий запис NINJIO з доступом до API.
* Доступ адміністратора до [admin.goninjio.com](https://admin.goninjio.com/).
* Адреси електронної пошти Learners у NINJIO, що збігаються з адресами, які використовують інші підключені до вас системи. Living Security зіставляє Learner з NINJIO з конкретною особою за адресою електронної пошти.

***

## Частина A — у NINJIO

*Ці кроки виконує адміністратор NINJIO.*

<Steps>
  <Step title="Відкрийте розділ Integration">
    1. Увійдіть на [admin.goninjio.com](https://admin.goninjio.com/) як адміністратор.
    2. Виберіть **Integration** у правому верхньому куті екрана.
  </Step>

  <Step title="Створіть ключ API">
    1. Виберіть **New API Key**.
    2. Вкажіть назву ключа, яку ви зможете легко впізнати пізніше, наприклад `Living Security`.
    3. Надайте доступ на **читання** до точок доступу **employee**, **training** та **phishing**.
    4. Не вибирайте доступ на запис. Living Security лише читає дані з NINJIO.
    5. Виберіть **Generate Key**.

    <Warning>
      Скопіюйте ключ зараз. NINJIO показує його лише один раз і не зможе показати повторно.
    </Warning>
  </Step>
</Steps>

***

## Частина B — у Living Security Platform

*Цей крок виконує власник програми або системний адміністратор, якщо використовується делеговане налаштування.*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Поле | Значення |
    | - | - |
    | **API key** | Ключ, який ви створили в частині A |
  </ConnectInPlatform>
</Steps>

Тепер підключення до NINJIO встановлено.

***

## Як часто отримуються дані

| Дані | Розклад |
| - | - |
| Learners | Щодня |
| Результати Training | Кожні 6 годин |
| Результати Phishing simulation | Кожні 6 годин |

Під час першого підключення Living Security отримує дані про завершення навчання за останні 12 місяців, а далі отримує лише нові дані. Кожна Phishing simulation зчитується один раз і повторно перевіряється впродовж двох тижнів після завершення, тож пізні переходи за посиланнями та пізні повідомлення про фішинг також враховуються.

<Note>
  Перше підключення до великого облікового запису NINJIO може потребувати кількох запланованих запусків, щоб зчитати всі дані. Кожен запуск зчитує стільки, скільки може, а наступний продовжує з місця зупинки, тому кількість записів зростатиме протягом першої доби або двох, а не з’явиться одразу.
</Note>

***

## Усунення несправностей

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Ключ API неправильний або неповний. Найпоширеніша причина — ключ скопійовано частково: NINJIO показує його лише один раз, тож легко вставити обрізаний ключ, а виявити це пізніше неможливо. Створіть новий ключ у NINJIO та повторно підключіться з ним.
  </Accordion>

  <Accordion title="403 Forbidden">
    Це **не** проблема з обліковими даними. Автентифікація за ключем пройшла, але для однієї з потрібних точок доступу не надано дозволу на читання.

    Повторне вставлення того самого ключа не допоможе. У NINJIO створіть ключ із доступом на **читання** до всіх трьох точок доступу — employee, training і phishing — та повторно підключіться з ним.
  </Accordion>

  <Accordion title="Підключення успішне, але даних про Training немає">
    Перевірте в NINJIO, що принаймні одна кампанія навчання є **активною** та має прикріплену симуляцію. Кампанія без симуляції залишається неактивною і нічого не передає, тож немає результатів для отримання.

    Якщо кампанії активні, переконайтеся, що в записах Learners у них вказано адреси електронної пошти. Learner без адреси електронної пошти неможливо зіставити з особою, тому його пропускають.
  </Accordion>

  <Accordion title="Training відображається як призначене, але не завершене">
    Так відображається навчання, яке Learner ще не завершив. Living Security фіксує призначення, коли починається симуляція NINJIO, а завершення фіксує окремо, коли NINJIO повідомляє дату завершення.
  </Accordion>

  <Accordion title="Деяких Learners не вистачає">
    Living Security зіставляє Learner з NINJIO з особою за **адресою електронної пошти**. Learner, чия адреса в NINJIO відрізняється від адреси у вашому довіднику — особиста адреса, старий домен або друкарська помилка, — не буде зіставлений.

    Виправте адресу в NINJIO, і під час наступного запланованого отримання даних зіставлення відбудеться.
  </Accordion>

  <Accordion title="Відсутні результати Phishing simulation для старішої симуляції">
    Living Security повторно перевіряє Phishing simulation упродовж двох тижнів після її завершення, після чого припиняє. Результати, які NINJIO фіксує після цього періоду, не враховуються. Зверніться до служби підтримки, якщо потрібно повторно зчитати старішу симуляцію.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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