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

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

> Підключіть Adaptive Security до Living Security Platform, щоб імпортувати результати симуляцій фішингу, смишингу та вішингу, а також результати навчання з кібербезпеки для вашого 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="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](/uk/signals/data-sources).

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

## Що потрібно для 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** | Для кожної особи та кожної кампанії: коли її зараховано, кінцевий термін, коли розпочато, коли завершено та чи підтвердила особа ознайомлення з політикою кампанії. |

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

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

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

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

***

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

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

<Steps>
  <Step title="Відкрийте налаштування API">
    1. Увійдіть на [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) як адміністратор.
    2. Перейдіть до **Settings → API**.
  </Step>

  <Step title="Згенеруйте API-токен">
    1. Згенеруйте новий API-токен.
    2. Дайте йому назву, яку ви згодом розпізнаєте, наприклад `Living Security`.
    3. Переконайтеся, що роль токена може читати дані про користувачів, фішингові кампанії та кампанії навчання.
    4. Скопіюйте токен.

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

***

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

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

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Поле | Значення |
    | - | - |
    | **API token** | Токен, який ви згенерували в частині A |
  </ConnectInPlatform>
</Steps>

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

***

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

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

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

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API-токен неправильний, термін його дії минув або його було відкликано. У відповідь на цю помилку Adaptive повертає порожнє тіло відповіді,
    тому додаткових подробиць немає. Згенеруйте новий токен у
    **Settings → API** і повторно підключіться з ним. Частково скопійований токен спричиняє таку саму
    помилку і є найпоширенішою причиною.
  </Accordion>

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

  <Accordion title="429 Too Many Requests">
    Adaptive обмежив частоту запитів підключення. Living Security зупиняє цей запуск і відновлює роботу з того самого
    місця під час наступного запланованого запуску, тож дані не втрачаються — лічильники просто зростають довше. Якщо проблема
    зберігається кілька днів, зверніться до служби підтримки Adaptive Security, щоб дізнатися про
    ліміт частоти запитів, що застосовується до вашого облікового запису.
  </Accordion>

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

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

<PublicIntegrationNextSteps />


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