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

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

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

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Додайте всі чотири вихідні IP-адреси синхронізації Living Security</strong> до списку дозволених у{' '}
    {system}. Вводьте кожну адресу як окремий вузол із суфіксом <code>/32</code>, якщо {system} очікує нотацію CIDR:
    <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 />
    Трафік може надходити з будь-якої з цих чотирьох адрес, тому додавання до списку дозволених лише частини з них спричиняє періодичні збої синхронізації. Ці чотири адреси однакові в усіх регіонах Living Security. Повний перелік, політику змін і усунення несправностей див. у статті{' '}
    <a href="/uk/integrations/managing/egress-ip-addresses">
      Configuring Integration Egress IP Addresses
    </a>.
  </Note>;

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

## Що надає ця інтеграція

KnowBe4 може надавати дані про Workforce, Training та результати симуляцій фішингу. Серед розглянутих прикладів:

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

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

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

| Облікові дані | Опис |
| - | - |
| **API key** | Bearer-токен Reporting API, згенерований у розділі **Account Settings → API**. Надсилається з кожним запитом у заголовку `Authorization: Bearer`. |
| **Reporting API server region** | Регіон, у якому розгорнуто ваш обліковий запис KnowBe4; вибирається зі списку (US, EU, Canada, UK, Germany). |

**Області доступу (scopes):** Налаштовувати нічого не потрібно — токени Reporting API у KnowBe4 за задумом доступні лише для читання й не мають областей доступу. Токен надає доступ на читання до користувачів, записів на навчання та результатів тестів безпеки з фішингу, саме це й зчитує синхронізація.

**Потрібна роль:** **Account Admin** у KnowBe4 (лише адміністратори облікового запису мають доступ до **Account Settings → API**)

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

* Ви маєте бути авторизовані в консолі KnowBe4 з роллю **Account Admin**. Лише адміністратори облікового запису мають доступ до **Account Settings → API**, де можна ввімкнути Reporting API та згенерувати токени.

***

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

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

<Steps>
  <Step title="Увімкніть Reporting API та згенеруйте токен">
    1. Увійдіть до консолі KnowBe4.
    2. Натисніть назву свого облікового запису у верхньому правому куті та виберіть **Account Settings**.
    3. У лівому меню виберіть **API**.
    4. Увімкніть **Reporting API**, якщо його ще не ввімкнено, а потім згенеруйте новий токен API.

    Якщо консоль запитує призначення токена, вкажіть змістовний опис (наприклад, `Living Security Platform`).

    <Warning>
      KnowBe4 показує значення токена API **лише один раз** — під час генерації. Скопіюйте його одразу та збережіть у безпечному місці (наприклад, у сховищі паролів або менеджері секретів). Якщо ви залишите сторінку, не скопіювавши токен, доведеться згенерувати новий.
    </Warning>

    <Note>
      Reporting API доступний лише для читання. Він надає дані про користувачів, записи на навчання та результати тестів безпеки з фішингу — ці дані Living Security отримує для оцінювання та звітності. Доступ на запис не потрібен.
    </Note>
  </Step>

  <Step title="Додайте вихідні IP-адреси Living Security до списку Allowed IP Addresses">
    KnowBe4 дає змогу обмежити доступ до Reporting API певним набором вихідних IP-адрес. Це налаштування розташоване там само, де й токен:

    1. У консолі KnowBe4 перейдіть до **Account Settings → API → Allowed IP Addresses**.
    2. Додайте до списку дозволених кожну з [вихідних IP-адрес Living Security](/uk/integrations/managing/egress-ip-addresses). Ті самі чотири адреси застосовуються в усіх регіонах.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Якщо список Allowed IP Addresses налаштовано, він застосовується на мережевому рівні.** Діалог підключення успішно пройде автентифікацію, але синхронізація даних завершуватиметься помилкою (блокування на мережевому рівні, що зазвичай проявляється як `403`), доки вихідні IP-адреси Living Security не буде додано до списку дозволених. Якщо ви додаєте до цього списку будь-яку адресу, необхідно також додати діапазони Living Security, інакше наші запити відхилятимуться, навіть якщо ваш токен дійсний.
    </Warning>

    <Note>
      Вихідні IP-адреси Living Security можуть змінюватися під час оновлення інфраструктури, хоча такі зміни трапляються рідко. Якщо синхронізація даних почала завершуватися помилками після періоду стабільної роботи, перегляньте [Налаштування вихідних IP-адрес інтеграцій](/uk/integrations/managing/egress-ip-addresses) та переконайтеся, що список Allowed IP Addresses відповідає актуальним адресам.
    </Note>
  </Step>

  <Step title="Визначте регіон сервера KnowBe4">
    KnowBe4 надає Reporting API з хоста, специфічного для регіону. Регіон потрібно вибрати в діалозі підключення, а не вводити ім’я хоста вручну:

    | Регіон | Хост Reporting API |
    | - | - |
    | Сполучені Штати | `us.api.knowbe4.com` |
    | Європа | `eu.api.knowbe4.com` |
    | Канада | `ca.api.knowbe4.com` |
    | Велика Британія | `uk.api.knowbe4.com` |
    | Німеччина | `de.api.knowbe4.com` |

    Якщо ви не впевнені, який регіон використовує ваш обліковий запис, перевірте домен в URL-адресі консолі KnowBe4 або зверніться до адміністратора KnowBe4.

    <Note>
      Це п’ять регіонів, до яких має доступ Living Security. Якщо ваш обліковий запис KnowBe4 розміщено на іншому сервері (наприклад, в екземплярі для уряду США), зверніться до служби підтримки Living Security, перш ніж починати підключення.
    </Note>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Поле | Значення |
    | - | - |
    | **API key** | Токен Reporting API з частини A, крок 1 |
    | **Reporting API server region** | Регіон з частини A, крок 3 (наприклад, United States) |
  </ConnectInPlatform>
</Steps>

Тепер підключення до KnowBe4 виконано.

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Токен API недійсний або термін його дії минув. Переконайтеся, що токен правильний і його не було повторно згенеровано в **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Або токен не має доступу до Reporting API, або IP-адресу запиту не внесено до списку Allowed IP Addresses. Переконайтеся, що Reporting API ввімкнено і що всі чотири [вихідні IP-адреси Living Security](/uk/integrations/managing/egress-ip-addresses) додано до списку дозволених.
  </Accordion>

  <Accordion title="Порожні результати (200 OK, але без даних)">
    Можливо, Reporting API ще не має даних для повернення, або обліковий запис токена не бачить користувачів і кампаній, які отримує Living Security. Переконайтеся, що токен згенерував Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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