> ## 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 для импорта данных об угрозах электронной почты и фишинговых кампаниях.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Связанные ресурсы</h2>
    <ul>
      <li>
        <a href="/ru/signals/data-sources">Узнайте, как данные Интеграций преобразуются в Сигналы управления человеческими рисками</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="/ru/integrations/managing/egress-ip-addresses">
      Настройка исходящих IP-адресов для интеграций
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Введите учётные данные в Living Security Platform">
    <p>
      Выполняется пользователем, имеющим доступ к Living Security: владельцем программы или
      системным администратором, если он был приглашён (делегированная настройка).
    </p>
    <ol>
      <li>
        Перейдите в раздел <strong>Настройки → Интеграции → Каталог</strong>, найдите плитку{' '}
        <strong>{tile}</strong> и нажмите <strong>Подключиться</strong>.
      </li>
      <li>
        Заполните поля ниже, затем нажмите <strong>Подключиться</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 может предоставлять нормализованные данные об угрозах электронной почты, доставке, блокировке и активности сотрудников по сообщению об угрозах. Среди рассмотренных примеров:

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

Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. [как данные интеграций становятся сигналами](/ru/signals/data-sources).

## Что требуется для Living Security

| Учетные данные | Описание |
| - | - |
| **Ключ API** | Bearer-токен REST API, созданный в портале Abnormal |
| **Региональный хост API** | Имя хоста вашей среды Abnormal Security |

**Области доступа:** Custom Access с правом **Чтение** для `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. В левой панели навигации нажмите **Настройки**, затем выберите **Интеграции**.

    <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="Меню настроек Abnormal Security с пунктом «Интеграции»" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Прокрутите страницу «Интеграции» вниз до раздела **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** в качестве типа интеграции, затем нажмите **Далее**.
  </Step>

  <Step title="Выберите область действия токена">
    Выберите область действия токена, затем нажмите **Далее**:

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

    Для большинства организаций с одним тенантом Abnormal подойдет любой вариант. Если вы сомневаетесь, выберите **Customer**.
  </Step>

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

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

    Затем нажмите **Далее**.

    <Note>
      Доступ **Чтение** возвращает неконфиденциальные данные об угрозах и кампаниях. Доступ **Read Sensitive** дополнительно открывает персональные данные, вложения и данные о сотрудниках. Доступ **Запись** позволяет отправлять действия по устранению последствий. Предоставляйте только **Чтение**, если ваш сценарий использования явно не требует большего.
    </Note>
  </Step>

  <Step title="Настройте параметры токена и список разрешенных IP-адресов">
    Заполните следующие поля:

    * **Token Name** — описательное имя (например, `Living Security Platform`)
    * **Описание** — необязательный контекст (например, `Read access for Living Security HRM platform`)
    * **Token Expiry** — выберите **90**, **180** или **365 дней** в соответствии с вашей политикой ротации. Установите напоминание в календаре, чтобы заменить токен до истечения его срока действия.
    * **IP Safelist** — введите диапазоны исходящих IP-адресов Living Security, по одному в каждой записи. После каждого нажимайте **Добавить**.

    <EgressIpSafelist system="Abnormal Security" />

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

    Затем нажмите **Далее**.
  </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="Скопируйте и сохраните токен">
    **Сразу скопируйте токен** и сохраните его в безопасном месте (например, в хранилище паролей или менеджере секретов), затем нажмите **Готово**.

    <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 показывает значение токена **только один раз**. Если вы покинете страницу, не скопировав токен, потребуется создать новый токен и отозвать прежний.
    </Warning>
  </Step>

  <Step title="Определите региональный хост API">
    Определите правильный хост API для вашей среды Abnormal Security:

    | Среда | Региональный хост API |
    | - | - |
    | По умолчанию (коммерческая среда США) | `api.abnormalplatform.com` |
    | EU | `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** | Токен, скопированный в части A, шаг 7 |
    | **Региональный хост API** | Хост из части A, шаг 8 (по умолчанию для США: `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](/ru/integrations/managing/egress-ip-addresses) добавлены в список разрешенных

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

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

<PublicIntegrationNextSteps />


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