Skip to main content

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

Abnormal Security може надавати нормалізовані дані про email-загрози, доставку, блокування та активність співробітників щодо повідомлень про загрози. Серед перевірених прикладів:
  • phishing.real.blocked — реальний фішинг, заблокований до доставки
  • phishing.real.delivered — реальний фішинг, доставлений до папки «Вхідні»
  • phishing.real.reported — повідомляє про реальні фішингові листи
Ці приклади показують типи нормалізованої активності, які може використовувати Living Security. Див. як дані інтеграцій перетворюються на Signals.

​
Що потрібно для Living 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 у вашій організації.
1

Перейдіть до керування API-токенами

  1. Увійдіть до порталу Abnormal Security.
  2. У лівому меню натисніть Settings, потім виберіть Integrations.
Меню Settings в Abnormal Security з пунктом Integrations
  1. Прокрутіть сторінку Integrations донизу до розділу API Token Management.
  2. Натисніть + Create New Token.
Розділ API Token Management з кнопкою Create New Token
2

Виберіть тип інтеграції

Виберіть REST API як тип інтеграції, потім натисніть Next.
3

Виберіть область дії токена

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

Надайте необхідний доступ

Виберіть Custom Access і ввімкніть Read для обох груп кінцевих точок:Потім натисніть Next.
Доступ Read повертає нечутливі дані про загрози та кампанії. Read Sensitive додатково відкриває персональні дані (PII), вкладення та дані про співробітників. Write дозволяє надсилати дії з усунення наслідків. Надавайте лише Read, якщо ваш сценарій використання прямо не вимагає більшого.
5

Налаштуйте параметри токена та безпечний список 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 після кожного.
Безпечний список IP-адрес є обов’язковим. Abnormal Security відхиляє всі API-запити з адрес, яких немає в безпечному списку. Діалогове вікно підключення завершиться успішно, але синхронізація даних завершуватиметься помилкою 401 Unauthorized, доки не буде додано правильні IP-адреси до безпечного списку.
Потім натисніть Next.
6

Перевірте та створіть токен

Перегляньте зведення конфігурації токена, потім натисніть Create Token.Екран перевірки конфігурації токена
7

Скопіюйте та збережіть токен

Негайно скопіюйте токен і збережіть його в безпечному місці (наприклад, у сховищі паролів або менеджері секретів), потім натисніть Done.Діалогове вікно копіювання токена зі згенерованим токеном
Abnormal Portal показує значення токена лише один раз. Якщо ви залишите сторінку, не скопіювавши його, потрібно буде створити новий токен і відкликати старий.
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 на Dashboard. Застарілі токени продовжують працювати, але їх не можна замінити ротацією — можна лише оновити їхній безпечний список IP-адрес. Строк дії всіх застарілих токенів автоматично завершується 30 квітня 2027 року. Заплануйте заміну застарілих токенів на нові до цієї дати.