Настройка интеграции с Netskope

Какие данные передает эта интеграция

Netskope может передавать нормализованные данные об активности в веб-среде и облаке, аутентификации, защите данных и угрозах. Проверенные примеры:

web.ai.visited — посещение веб-сайта с ИИ
data.bulk.uploaded — массовая загрузка данных
geo.impossible — невозможное перемещение между входами в систему

Текущее подключение использует REST API v2; для существующих клиентов может отображаться устаревший вариант REST. См. раздел как данные интеграций становятся сигналами.

Что необходимо для Living Security

Учетные данные	Описание
Токен API	Токен REST API v2, созданный в консоли администратора Netskope
Поддомен тенанта	Поддомен вашего тенанта Netskope (например, `acme` из `acme.goskope.com`)

Необходимый доступ к конечным точкам:

Конечная точка	Назначение
`/api/v2/events/data/alert`	Оповещения об угрозах, нарушения политик, события DLP, обнаружения вредоносного ПО
`/api/v2/events/data/page`	Веб-активность — просмотр страниц, разрешенные и заблокированные сайты, доступ к облачным приложениям

Необходимая роль: Tenant Admin или эквивалентная роль с доступом к разделу Settings → Tools

Для этой интеграции требуется токен API v2, а не токен v1. Токены v1 используют аутентификацию через параметр запроса и не будут работать с конечной точкой API v2.

Предварительные требования

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

Часть A — в Netskope

Эти шаги выполняет администратор Netskope.

Перейдите к управлению токенами REST API v2

Войдите в консоль администратора Netskope по адресу https://<tenant>.goskope.com.
В левой панели навигации нажмите Settings.
В разделе Tools выберите REST API v2.

Создайте новый токен

Нажмите New Token.
Введите описательное имя (например, Living Security Platform).
В разделе доступа к конечным точкам включите доступ к следующим:

Конечная точка	Необходимый доступ
`/api/v2/events/data/alert`	Чтение
`/api/v2/events/data/page`	Чтение

Предоставьте доступ к обеим конечным точкам. Они питают два отдельных потока — alerts и events — а токен, ограниченный только одной из них, все равно успешно подключается. Поток, которому соответствует отсутствующая конечная точка, при этом не возвращает данных, и никакой ошибки с объяснением причины не появляется.

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

Нажмите Сохранить (или Generate Token).

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

Сразу скопируйте токен и надежно сохраните его.

Netskope показывает значение токена только один раз — при создании. Если вы покинете страницу, не скопировав его, необходимо будет удалить токен и создать новый.

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

Если для вашего тенанта Netskope включен список разрешенных IP-адресов, необходимо добавить в него диапазоны исходящих IP-адресов Living Security.

В консоли администратора Netskope перейдите в Settings → Administration → IP Allowlist.
Если список разрешенных IP-адресов включен, добавьте каждый исходящий IP-адрес Living Security в список Custom IP.

Если список разрешенных IP-адресов включен, диалог подключения завершится успешно, но синхронизация данных будет завершаться ошибкой 401 Unauthorized, пока не будут добавлены нужные IP-адреса.

Определите поддомен тенанта

Поддомен тенанта — это префикс URL-адреса вашей консоли администратора Netskope.Если URL-адрес вашей консоли — https://acme.goskope.com, ваш поддомен — acme.Вводите только сам поддомен — без https://, без .goskope.com и без завершающей косой черты.

Диалог подключения принимает несколько форматов ввода (только поддомен, полное имя хоста или полный URL-адрес) и автоматически нормализует их. Тем не менее рекомендуется вводить только поддомен.

Часть B — в Living Security Platform

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

Подключение к Netskope (v2 API) выполнено.

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

401 Unauthorized

Распространенные причины:

Токен отозван или срок его действия истек — создайте новый токен
Используется токен v1 — токены v1 аутентифицируются через параметр запроса и не работают с конечными точками v2. Создайте новый токен v2 в разделе Settings → Tools → REST API v2
Запросы блокирует список разрешенных IP-адресов — если для вашего тенанта включен список разрешенных IP-адресов, убедитесь, что все четыре исходящих IP-адреса Living Security добавлены в этот список

403 Forbidden

Токен был создан без доступа к /api/v2/events/data/alert или /api/v2/events/data/page. Разрешения токена для конечных точек нельзя изменить после создания — создайте новый токен с доступом на чтение к обеим конечным точкам и выполните подключение заново.

Оповещения поступают, но данные о веб-активности отсутствуют (или наоборот)

У токена отсутствует доступ к одной из двух необходимых конечных точек. Токен, ограниченный только /api/v2/events/data/alert или только /api/v2/events/data/page, все равно подключается, а поток, которому соответствует отсутствующая конечная точка, остается пустым без каких-либо уведомлений.Разрешения для конечных точек нельзя изменить после создания токена — создайте новый токен с доступом на чтение к обеим конечным точкам, а затем выполните подключение заново.

Синхронизация работала, но теперь завершается ошибкой 401

Если включен список разрешенных IP-адресов, исходящие IP-адреса Living Security могли измениться. Ознакомьтесь со статьей Настройка исходящих IP-адресов интеграций и обновите список Custom IP в соответствии с ней.

Используется токен v1 вместо v2

Токены v1 и v2 используют разные механизмы аутентификации:

v1: параметр запроса (token=...)
v2: заголовок (Netskope-Api-Token: ...)

Living Security использует аутентификацию v2. Создайте новый токен в разделе Settings → Tools → REST API v2 (а не на странице устаревшего токена v1).

Интеграции