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

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

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

phishing.simulation.clicked — натискання на симульований електронний лист без повідомлення про нього
phishing.simulation.credential.submitted — введення облікових даних на симульованій сторінці входу
phishing.simulation.attachment.opened — відкриття вкладення в симульованому електронному листі
phishing.simulation.reported — повідомлення про симульований електронний лист
smishing.simulation.replied — відповідь на симульоване текстове повідомлення
vishing.simulation.succeeded — виконання вимог симульованого голосового абонента
training.assigned — призначення навчання з кібербезпеки
training.completed — завершення навчання з кібербезпеки
training.past.due — пропуск кінцевого терміну навчання

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

Adaptive проводить симуляції трьома каналами, а Living Security оцінює кожен із них окремо. Результати для електронної пошти оцінюються як фішинг, для текстових повідомлень — як смишинг, а для голосових дзвінків — як вішинг. Співробітник, який натиснув на симульований лист, і той, хто відповів на симульоване текстове повідомлення, оцінюються не як однакова поведінка, оскільки рішення, яке приймає кожен із них, різне.

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

Облікові дані	Опис
API token	API-токен Adaptive Security. Living Security надсилає його як bearer-токен у кожному запиті.

Потрібна роль: адміністратор у вашому обліковому записі Adaptive Security з доступом до Settings → API. Adaptive керує доступом до API за допомогою дозволів на основі ролей, тому токен має належати ролі, яка може читати дані про користувачів, фішинг і навчання. Доступ: лише читання. Living Security лише читає дані з Adaptive Security і ніколи не створює, не змінює та не видаляє нічого у вашому обліковому записі.

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

Дані	Деталі
Люди	Каталог користувачів Adaptive: ім’я, адреса електронної пошти, відділ, посада, ім’я та адреса електронної пошти керівника, місцезнаходження, підрозділ, статус працевлаштування та дата початку роботи.
Симуляції електронною поштою	Для кожної особи та кожної симуляції: коли повідомлення було доставлено, відкрито, коли на нього натиснули, відповіли, відкрили вкладення, відсканували QR-код, ввели облікові дані або повідомили про нього.
Симуляції текстовими повідомленнями	Для кожної особи та кожної симуляції: доставлено, відкрито, натиснуто, відповідь, введення облікових даних або повідомлення про загрозу.
Голосові симуляції	Для кожної особи та кожної симуляції: доставлена приманка, набраний номер, чи виконала особа вимоги абонента та чи повідомила вона про дзвінок.
Training	Для кожної особи та кожної кампанії: коли її зараховано, кінцевий термін, коли розпочато, коли завершено та чи підтвердила особа ознайомлення з політикою кампанії.

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

Власну оцінку ризику Adaptive записується, але не враховується в розрахунках. Adaptive обчислює current_risk_score для кожної особи. Living Security зберігає його, щоб ви могли порівнювати обидві системи, але Human Risk Index завжди розраховується на основі спостережуваної поведінки за власною опублікованою моделлю Living Security — ніколи за складеною оцінкою іншого постачальника.

Передумови

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

Частина A — в Adaptive Security

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

Відкрийте налаштування API

Увійдіть на admin.adaptivesecurity.com як адміністратор.
Перейдіть до Settings → API.

Згенеруйте API-токен

Згенеруйте новий API-токен.
Дайте йому назву, яку ви згодом розпізнаєте, наприклад Living Security.
Переконайтеся, що роль токена може читати дані про користувачів, фішингові кампанії та кампанії навчання.
Скопіюйте токен.

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

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

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

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

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

Дані	Розклад
Люди	Кожні 6 годин
Результати симуляцій (електронна пошта, текстові повідомлення, голос)	Кожні 6 годин
Результати навчання	Кожні 6 годин

API звітності Adaptive не пропонує фільтра «що змінилося з певного моменту», тому Living Security зчитує кожну кампанію симуляції та навчання, поки вона ще створює результати, і припиняє її зчитувати після того, як кампанія закрита впродовж двох тижнів. Таким чином, пізні натискання та пізні повідомлення все одно фіксуються, а завершені кампанії не зчитуються повторно безкінечно.

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

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

401 Unauthorized

API-токен неправильний, термін його дії минув або його було відкликано. У відповідь на цю помилку Adaptive повертає порожнє тіло відповіді, тому додаткових подробиць немає. Згенеруйте новий токен у Settings → API і повторно підключіться з ним. Частково скопійований токен спричиняє таку саму помилку і є найпоширенішою причиною.

403 Forbidden

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

429 Too Many Requests

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

Люди відображаються, але результатів симуляцій немає

Перевірте, чи справді було запущено очікувані кампанії. Adaptive повідомляє про зарахування лише для симуляцій, які були надіслані, тому кампанія зі статусом Draft або Scheduled не надає нічого, доки її не буде запущено. Living Security свідомо не зчитує такі кампанії, щоб витрачати ліміт запитів на кампанії з реальними результатами.

Відсутні голосові або текстові симуляції

Living Security визначає канал кожного результату за сценарієм, до якого він прив’язаний. Якщо сценарій було видалено в Adaptive після проведення його симуляції, його результати фіксуються як результати каналу електронної пошти, оскільки канал уже неможливо прочитати. Щоб цього уникнути, зберігайте застарілі сценарії в Adaptive, а не видаляйте їх.

Integrations