Skip to main content

​
Який внесок робить ця інтеграція

Netskope може передавати нормалізовані дані про вебактивність, хмарну активність, автентифікацію, захист даних і загрози. Перевірені приклади:
  • web.ai.visited — відвідано вебсайт зі штучним інтелектом
  • data.bulk.uploaded — масове завантаження даних
  • geo.impossible — неможлива подорож між входами в систему
Поточне підключення використовує REST API v2; для наявних клієнтів може відображатися застарілий варіант REST. Див. як дані інтеграцій перетворюються на сигнали.

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

Необхідний доступ до кінцевих точок: Необхідна роль: Tenant Admin або еквівалентна роль із доступом до Settings → Tools
Для цієї інтеграції потрібен токен API v2, а не токен v1. Токени v1 використовують автентифікацію через параметр запиту і не працюватимуть із кінцевою точкою API v2.

​
Попередні вимоги

  • Для керування токенами REST API вам потрібен доступ Tenant Admin у Netskope.

​
Частина A — у Netskope

Ці кроки виконує адміністратор Netskope.
1

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

  1. Увійдіть в адміністративну консоль Netskope за адресою https://<tenant>.goskope.com.
  2. У лівій навігації натисніть Settings.
  3. У розділі Tools виберіть REST API v2.
2

Створіть новий токен

  1. Натисніть New Token.
  2. Введіть описову назву (наприклад, Living Security Platform).
  3. У розділі доступу до кінцевих точок увімкніть доступ до:
Надайте доступ до обох кінцевих точок. Вони живлять два окремі потоки — alerts і events — а токен, обмежений лише однією з них, усе одно підключається успішно. Потік, що залежить від відсутньої кінцевої точки, тоді не повертає даних, і жодна помилка не вкаже на причину.
Це єдині кінцеві точки, які потрібні Living Security. Якщо не надавати нічого понад них, дотримується принцип найменших привілеїв.
  1. Натисніть Save (або Generate Token).
3

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

Негайно скопіюйте токен і надійно збережіть його.
Netskope показує значення токена лише один раз — під час створення. Якщо ви залишите сторінку, не скопіювавши його, вам доведеться видалити токен і створити новий.
4

Налаштуйте список дозволених IP-адрес (за потреби)

Якщо у вашому тенанті Netskope ввімкнено список дозволених IP-адрес, потрібно додати до нього діапазони вихідних IP-адрес Living Security.
  1. В адміністративній консолі Netskope перейдіть до Settings → Administration → IP Allowlist.
  2. Якщо список дозволених IP-адрес увімкнено, додайте кожну вихідну IP-адресу Living Security до списку Custom IP.
Якщо список дозволених IP-адрес увімкнено, діалогове вікно підключення відобразить успіх, але синхронізація даних завершуватиметься помилкою 401 Unauthorized, доки не буде додано правильні IP-адреси.
5

Визначте субдомен вашого тенанта

Субдомен вашого тенанта — це префікс URL-адреси адміністративної консолі Netskope.Якщо URL-адреса вашої консолі — https://acme.goskope.com, то ваш субдомен — acme.Вводьте лише сам субдомен — без https://, без .goskope.com, без кінцевої похилої риски.
Діалогове вікно підключення приймає кілька форм введення (сам субдомен, повне ім’я хоста або повну URL-адресу) та автоматично нормалізує їх. Проте рекомендується вводити саме субдомен.

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

Цей крок виконує власник програми або системний адміністратор, якщо використовується делеговане налаштування.
Тепер підключення до Netskope (v2 API) виконано.

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

Поширені причини:
  1. Токен відкликано або термін його дії минув — згенеруйте новий токен
  2. Використовується токен v1 — токени v1 автентифікуються через параметр запиту і не працюватимуть із кінцевими точками v2. Згенеруйте новий токен v2 у Settings → Tools → REST API v2
  3. Запити блокує список дозволених IP-адрес — якщо у вашому тенанті ввімкнено список дозволених IP-адрес, переконайтеся, що всі чотири вихідні IP-адреси Living Security є в цьому списку
Токен створено без доступу до /api/v2/events/data/alert або /api/v2/events/data/page. Дозволи токена на кінцеві точки неможливо змінити після створення — створіть новий токен із доступом на читання до обох і повторно підключіться.
У токена немає доступу до однієї з двох необхідних кінцевих точок. Токен, обмежений лише /api/v2/events/data/alert або лише /api/v2/events/data/page, усе одно підключається, а потік, що залежить від відсутньої кінцевої точки, залишається порожнім без жодних повідомлень.Дозволи на кінцеві точки неможливо змінити після створення токена — згенеруйте новий токен із доступом на читання до обох, а потім повторно підключіться.
Якщо ввімкнено список дозволених IP-адрес, вихідні IP-адреси Living Security могли змінитися. Перегляньте Configuring Integration Egress IP Addresses і оновіть список Custom IP відповідно.
Токени v1 і v2 використовують різні механізми автентифікації:
  • v1: параметр запиту (token=...)
  • v2: заголовок (Netskope-Api-Token: ...)
Living Security використовує автентифікацію v2. Згенеруйте новий токен у Settings → Tools → REST API v2 (а не на сторінці застарілого токена v1).