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

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

> Підключіть Abnormal Security, щоб імпортувати дані про email-загрози та фішингові кампанії.

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="Abnormal Security" />

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

Abnormal Security може надавати нормалізовані дані про email-загрози, доставку, блокування та активність співробітників щодо повідомлень про загрози. Серед перевірених прикладів:

* `phishing.real.blocked` — реальний фішинг, заблокований до доставки
* `phishing.real.delivered` — реальний фішинг, доставлений до папки «Вхідні»
* `phishing.real.reported` — повідомляє про реальні фішингові листи

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

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

| Облікові дані | Опис |
| - | - |
| **API key** | Bearer-токен REST API, згенерований у порталі Abnormal Portal |
| **Regional API host** | Ім’я хоста для вашого середовища Abnormal Security |

**Області доступу:** Custom Access з дозволом **Read** для `Abuse Campaigns (AI Security Mailbox)` та `Threats`

**Необхідна роль:** **Security Admin** або **Super Admin** в Abnormal Security

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

* Для створення API-токенів і керування ними вам потрібен доступ **Security Admin** або **Super Admin** в Abnormal Security.

***

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

*Ці кроки виконує адміністратор Abnormal Security у вашій організації.*

<Steps>
  <Step title="Перейдіть до керування API-токенами">
    1. Увійдіть до порталу Abnormal Security.
    2. У лівому меню натисніть **Settings**, потім виберіть **Integrations**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Меню Settings в Abnormal Security з пунктом Integrations" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Прокрутіть сторінку Integrations донизу до розділу **API Token Management**.
    4. Натисніть **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="Розділ API Token Management з кнопкою Create New Token" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="Виберіть тип інтеграції">
    Виберіть **REST API** як тип інтеграції, потім натисніть **Next**.
  </Step>

  <Step title="Виберіть область дії токена">
    Виберіть область дії токена, потім натисніть **Next**:

    * **Customer (All Current and Future Tenants)** — використовуйте цей варіант, якщо ваш обліковий запис Abnormal керує кількома тенантами. Такий токен автоматично охоплює всі поточні та майбутні тенанти.
    * **Tenant (Single Tenant)** — використовуйте цей варіант, щоб обмежити токен одним конкретним тенантом.

    Для більшості організацій з єдиним тенантом Abnormal підійде будь-який варіант. Якщо вагаєтеся, виберіть **Customer**.
  </Step>

  <Step title="Надайте необхідний доступ">
    Виберіть **Custom Access** і ввімкніть **Read** для обох груп кінцевих точок:

    | Група кінцевих точок | Необхідний рівень доступу |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Read |
    | **Threats** | Read |

    Потім натисніть **Next**.

    <Note>
      Доступ **Read** повертає нечутливі дані про загрози та кампанії. **Read Sensitive** додатково відкриває персональні дані (PII), вкладення та дані про співробітників. **Write** дозволяє надсилати дії з усунення наслідків. Надавайте лише **Read**, якщо ваш сценарій використання прямо не вимагає більшого.
    </Note>
  </Step>

  <Step title="Налаштуйте параметри токена та безпечний список IP-адрес">
    Заповніть такі поля:

    * **Token Name** — описова назва (наприклад, `Living Security Platform`)
    * **Description** — необов’язковий контекст (наприклад, `Read access for Living Security HRM platform`)
    * **Token Expiry** — виберіть **90**, **180** або **365 days** відповідно до вашої політики ротації. Встановіть нагадування в календарі, щоб замінити токен до завершення його строку дії.
    * **IP Safelist** — введіть діапазони вихідних IP-адрес Living Security, по одному в кожному записі. Натискайте **Add** після кожного.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **Безпечний список IP-адрес є обов’язковим.** Abnormal Security відхиляє всі API-запити з адрес, яких немає в безпечному списку. Діалогове вікно підключення завершиться успішно, але синхронізація даних завершуватиметься помилкою `401 Unauthorized`, доки не буде додано правильні IP-адреси до безпечного списку.
    </Warning>

    Потім натисніть **Next**.
  </Step>

  <Step title="Перевірте та створіть токен">
    Перегляньте зведення конфігурації токена, потім натисніть **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="Екран перевірки конфігурації токена" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="Скопіюйте та збережіть токен">
    **Негайно скопіюйте токен** і збережіть його в безпечному місці (наприклад, у сховищі паролів або менеджері секретів), потім натисніть **Done**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="Діалогове вікно копіювання токена зі згенерованим токеном" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      Abnormal Portal показує значення токена **лише один раз**. Якщо ви залишите сторінку, не скопіювавши його, потрібно буде створити новий токен і відкликати старий.
    </Warning>
  </Step>

  <Step title="Визначте свій регіональний API-хост">
    Визначте правильний API-хост для вашого середовища Abnormal Security:

    | Середовище | Регіональний API-хост |
    | - | - |
    | За замовчуванням (комерційне середовище США) | `api.abnormalplatform.com` |
    | ЄС | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    Вводьте **лише хост** — без префікса `https://` і без завершальної косої риски.

    Якщо ви не впевнені, яке середовище використовує ваша організація, перевірте URL-адресу порталу Abnormal або зверніться до команди вашого облікового запису Abnormal Security.
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | Поле | Значення |
    | - | - |
    | **API key** | Токен, скопійований на кроці 7 частини A |
    | **Regional API host** | Хост із кроку 8 частини A (типове значення для США: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="Діалогове вікно підключення Living Security для Abnormal Security" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

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

***

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

<AccordionGroup>
  <Accordion title="403 Forbidden — You do not have permission to perform this action">
    У токена відсутній один або обидва необхідні дозволи доступу (**Abuse Campaigns** або **Threats**). Тип інтеграції, область дії та рівень доступу не можна змінити після створення токена — потрібно створити новий токен із правильними параметрами та відкликати старий.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Або токен недійсний чи строк його дії минув, або IP-адреси запиту немає в безпечному списку. Перевірте:

    1. Токен не було відкликано, і строк його дії не минув
    2. Усі чотири [вихідні IP-адреси Living Security](/uk/integrations/managing/egress-ip-addresses) є в безпечному списку

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

  <Accordion title="Закінчення строку дії застарілих токенів (30 квітня 2027 року)">
    Якщо у вашій організації є API-токени, створені до появи самообслуговуваного керування токенами, вони відображаються як **Legacy** на Dashboard. Застарілі токени продовжують працювати, але їх не можна замінити ротацією — можна лише оновити їхній безпечний список IP-адрес. Строк дії всіх застарілих токенів автоматично завершується **30 квітня 2027 року**. Заплануйте заміну застарілих токенів на нові до цієї дати.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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