Skip to main content

​
Какие данные предоставляет эта интеграция

Abnormal Security может предоставлять нормализованные данные об угрозах электронной почты, доставке, блокировке и активности сотрудников по сообщению об угрозах. Среди рассмотренных примеров:
  • phishing.real.blocked — реальный фишинг, заблокированный до доставки
  • phishing.real.delivered — реальный фишинг, доставленный во входящие
  • phishing.real.reported — сообщает о реальных фишинговых письмах
Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. как данные интеграций становятся сигналами.

​
Что требуется для Living 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.
1

Перейдите в раздел управления токенами API

  1. Войдите в портал Abnormal Security.
  2. В левой панели навигации нажмите Настройки, затем выберите Интеграции.
Меню настроек Abnormal Security с пунктом «Интеграции»
  1. Прокрутите страницу «Интеграции» вниз до раздела API Token Management.
  2. Нажмите + Create New Token.
Раздел API Token Management с кнопкой Create New Token
2

Выберите тип интеграции

Выберите REST API в качестве типа интеграции, затем нажмите Далее.
3

Выберите область действия токена

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

Предоставьте необходимый доступ

Выберите Custom Access и включите Чтение для обеих групп конечных точек:Затем нажмите Далее.
Доступ Чтение возвращает неконфиденциальные данные об угрозах и кампаниях. Доступ Read Sensitive дополнительно открывает персональные данные, вложения и данные о сотрудниках. Доступ Запись позволяет отправлять действия по устранению последствий. Предоставляйте только Чтение, если ваш сценарий использования явно не требует большего.
5

Настройте параметры токена и список разрешенных IP-адресов

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

Проверьте параметры и создайте токен

Проверьте сводку конфигурации токена, затем нажмите Create Token.Экран проверки конфигурации токена
7

Скопируйте и сохраните токен

Сразу скопируйте токен и сохраните его в безопасном месте (например, в хранилище паролей или менеджере секретов), затем нажмите Готово.Диалоговое окно копирования токена с созданным токеном
Портал Abnormal показывает значение токена только один раз. Если вы покинете страницу, не скопировав токен, потребуется создать новый токен и отозвать прежний.
8

Определите региональный хост API

Определите правильный хост API для вашей среды Abnormal Security:Введите только имя хоста — без префикса https:// и без завершающей косой черты.Если вы не уверены, какую среду использует ваша организация, проверьте URL вашего портала Abnormal или обратитесь в команду поддержки аккаунта Abnormal Security.

​
Часть B — в Living Security Platform

Этот шаг выполняет владелец программы или системный администратор, если используется делегированная настройка.
Подключение к Abnormal Security выполнено.

​
Устранение неполадок

У токена отсутствует один или оба необходимых права доступа (Abuse Campaigns или Threats). Тип интеграции, область действия и уровень доступа нельзя изменить после создания токена — необходимо создать новый токен с правильными параметрами и отозвать прежний.
Либо токен недействителен или срок его действия истек, либо IP-адрес запроса отсутствует в списке разрешенных. Проверьте следующее:
  1. Токен не был отозван и срок его действия не истек
  2. Все четыре исходящих IP-адреса Living Security добавлены в список разрешенных
Если ранее синхронизация работала, а теперь завершается ошибкой 401, возможно, исходящие IP-адреса изменились — обратитесь к разделу Настройка исходящих IP-адресов интеграций и убедитесь, что список разрешенных адресов соответствует актуальному.
Если в вашей организации есть токены API, созданные до появления самостоятельного управления токенами, они отображаются в панели управления как Legacy. Устаревшие токены продолжают работать, но их нельзя заменить ротацией — можно обновить только их список разрешенных IP-адресов. Срок действия всех устаревших токенов автоматически истекает 30 апреля 2027 г. Запланируйте замену устаревших токенов на новые до этой даты.