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

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

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

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

Ці приклади демонструють типи нормалізованої активності, які може використовувати Living Security. Див. як дані інтеграції перетворюються на Signals.

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

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

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

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

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

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

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

Передумови

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

Частина A — у NINJIO

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

Відкрийте розділ Integration

Увійдіть на admin.goninjio.com як адміністратор.
Виберіть Integration у правому верхньому куті екрана.

Створіть ключ API

Виберіть New API Key.
Вкажіть назву ключа, яку ви зможете легко впізнати пізніше, наприклад Living Security.
Надайте доступ на читання до точок доступу employee, training та phishing.
Не вибирайте доступ на запис. Living Security лише читає дані з NINJIO.
Виберіть Generate Key.

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

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

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

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

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

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

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

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

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

401 Unauthorized

Ключ API неправильний або неповний. Найпоширеніша причина — ключ скопійовано частково: NINJIO показує його лише один раз, тож легко вставити обрізаний ключ, а виявити це пізніше неможливо. Створіть новий ключ у NINJIO та повторно підключіться з ним.

403 Forbidden

Це не проблема з обліковими даними. Автентифікація за ключем пройшла, але для однієї з потрібних точок доступу не надано дозволу на читання.Повторне вставлення того самого ключа не допоможе. У NINJIO створіть ключ із доступом на читання до всіх трьох точок доступу — employee, training і phishing — та повторно підключіться з ним.

Підключення успішне, але даних про Training немає

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

Training відображається як призначене, але не завершене

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

Деяких Learners не вистачає

Living Security зіставляє Learner з NINJIO з особою за адресою електронної пошти. Learner, чия адреса в NINJIO відрізняється від адреси у вашому довіднику — особиста адреса, старий домен або друкарська помилка, — не буде зіставлений.Виправте адресу в NINJIO, і під час наступного запланованого отримання даних зіставлення відбудеться.

Відсутні результати Phishing simulation для старішої симуляції

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

Integrations