Skip to main content

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

KnowBe4 може надавати дані про Workforce, Training та результати симуляцій фішингу. Серед розглянутих прикладів:
  • training.completed — проходить навчання з безпеки
  • training.past.due — має прострочене навчання
  • phishing.simulation.clicked — перейшов за посиланням у симуляції, не повідомивши про неї
Ці приклади показують типи нормалізованої активності, які може використовувати Living Security. Див. як дані інтеграцій перетворюються на Signals.

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

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

​
Передумови

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

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

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

Увімкніть Reporting API та згенеруйте токен

  1. Увійдіть до консолі KnowBe4.
  2. Натисніть назву свого облікового запису у верхньому правому куті та виберіть Account Settings.
  3. У лівому меню виберіть API.
  4. Увімкніть Reporting API, якщо його ще не ввімкнено, а потім згенеруйте новий токен API.
Якщо консоль запитує призначення токена, вкажіть змістовний опис (наприклад, Living Security Platform).
KnowBe4 показує значення токена API лише один раз — під час генерації. Скопіюйте його одразу та збережіть у безпечному місці (наприклад, у сховищі паролів або менеджері секретів). Якщо ви залишите сторінку, не скопіювавши токен, доведеться згенерувати новий.
Reporting API доступний лише для читання. Він надає дані про користувачів, записи на навчання та результати тестів безпеки з фішингу — ці дані Living Security отримує для оцінювання та звітності. Доступ на запис не потрібен.
2

Додайте вихідні IP-адреси Living Security до списку Allowed IP Addresses

KnowBe4 дає змогу обмежити доступ до Reporting API певним набором вихідних IP-адрес. Це налаштування розташоване там само, де й токен:
  1. У консолі KnowBe4 перейдіть до Account Settings → API → Allowed IP Addresses.
  2. Додайте до списку дозволених кожну з вихідних IP-адрес Living Security. Ті самі чотири адреси застосовуються в усіх регіонах.
Якщо список Allowed IP Addresses налаштовано, він застосовується на мережевому рівні. Діалог підключення успішно пройде автентифікацію, але синхронізація даних завершуватиметься помилкою (блокування на мережевому рівні, що зазвичай проявляється як 403), доки вихідні IP-адреси Living Security не буде додано до списку дозволених. Якщо ви додаєте до цього списку будь-яку адресу, необхідно також додати діапазони Living Security, інакше наші запити відхилятимуться, навіть якщо ваш токен дійсний.
Вихідні IP-адреси Living Security можуть змінюватися під час оновлення інфраструктури, хоча такі зміни трапляються рідко. Якщо синхронізація даних почала завершуватися помилками після періоду стабільної роботи, перегляньте Налаштування вихідних IP-адрес інтеграцій та переконайтеся, що список Allowed IP Addresses відповідає актуальним адресам.
3

Визначте регіон сервера KnowBe4

KnowBe4 надає Reporting API з хоста, специфічного для регіону. Регіон потрібно вибрати в діалозі підключення, а не вводити ім’я хоста вручну:Якщо ви не впевнені, який регіон використовує ваш обліковий запис, перевірте домен в URL-адресі консолі KnowBe4 або зверніться до адміністратора KnowBe4.
Це п’ять регіонів, до яких має доступ Living Security. Якщо ваш обліковий запис KnowBe4 розміщено на іншому сервері (наприклад, в екземплярі для уряду США), зверніться до служби підтримки Living Security, перш ніж починати підключення.

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

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

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

Токен API недійсний або термін його дії минув. Переконайтеся, що токен правильний і його не було повторно згенеровано в Account Settings → API.
Або токен не має доступу до Reporting API, або IP-адресу запиту не внесено до списку Allowed IP Addresses. Переконайтеся, що Reporting API ввімкнено і що всі чотири вихідні IP-адреси Living Security додано до списку дозволених.
Можливо, Reporting API ще не має даних для повернення, або обліковий запис токена не бачить користувачів і кампаній, які отримує Living Security. Переконайтеся, що токен згенерував Account Admin.