Skip to main content
Подключите канал Cloud Nanolog Streaming Service (NSS) в Zscaler Internet Access (ZIA), чтобы отправлять веб-журналы в Living Security. Это интеграция с передачей данных по инициативе источника (push). Она не связана с интеграцией Zscaler Client Connector, которая работает по принципу получения данных (pull).

Что дает эта интеграция

Канал веб-журналов позволяет определить пользователя и устройство, связанные с веб-активностью, а также передавать нормализованные данные об активности, такие как заблокированные запросы, вредоносные адреса назначения, блокировки передачи данных и использование генеративного ИИ. Результат зависит от полей и фильтров, настроенных в Zscaler.

Перед началом работы

Вам потребуются:
  • подписка на ZIA Cloud NSS и разрешение на управление каналами Cloud NSS
  • разрешение на управление интеграциями и ключами доступа в Living Security
  • регион целевой организации в Living Security
  • безопасное место для хранения созданного ключа доступа
Для назначения HTTPS в Cloud NSS Zscaler требует TLS-сертификат, которому доверяют публичные центры сертификации. Региональные конечные точки Living Security соответствуют этому требованию.

1. Подготовка Living Security

1

Создайте источник и поток

Перейдите в раздел Настройки → Интеграции → Каталог, добавьте Custom Push Source и используйте следующие ключи маршрутизации без изменений:Символ подчеркивания в web_logs обязателен. Другая пара значений может принимать данные, но не будет использовать поддерживаемый интерпретатор Zscaler NSS.
2

Создайте ключ доступа

Перейдите в раздел Настройки → Access Keys, создайте ключ доступа с областью Push Ingest и сразу скопируйте его значение.
3

Сформируйте URL назначения

Используйте URL для региона Living Security:
  • США: https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs
  • Европейский союз: https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs

2. Создание канала Cloud NSS

В текущей версии ZIA Admin Portal перейдите в раздел Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service, откройте Cloud NSS Feeds и выберите Add Cloud NSS Feed. В более старых версиях портала ZIA названия пунктов меню могут отличаться; за навигацией по порталу обращайтесь к инструкции Zscaler по веб-журналам Cloud NSS, которая является авторитетным источником. Настройте канал:
Не используйте x-api-key и не объединяйте старый ключ API и секрет через точку. Текущий механизм push-приема данных Living Security принимает ключ доступа с заданной областью только в заголовке Authorization: Bearer ….
Используйте следующий плоский Feed Output Format в одной строке без изменений:
Располагайте все поля на верхнем уровне. В устаревшем руководстве по Unify эти поля были вложены в объект event и добавлялось sourcetype. Такая оболочка может быть принята как корректный JSON, но не соответствует текущему интерпретатору, поэтому данные о пользователях и активности не формируются.
Выберите часовой пояс, который ожидает ваша операционная команда при просмотре событий Zscaler. Living Security обрабатывает значение datetime, передаваемое каналом.

3. Фильтрация и включение канала

С помощью фильтров Zscaler Policy Action и Policy Reason настройте отправку той веб-активности, которая необходима вашей программе управления рисками, связанными с человеческим фактором. Избегайте низкого значения количества событий в секунду, при котором журналы могут отбрасываться во время пиков трафика. Если вашей организации необходимо ограничить канал, во время настройки отслеживайте как доставку в Zscaler, так и Push History в Living Security. Сохраните канал, выполните проверку подключения в Zscaler, а затем установите для параметра Status значение Enabled.

4. Проверка доставки и интерпретации

  1. В Living Security откройте Настройки → Интеграции → Подключено → zscaler-nss-feed.
  2. В разделе Push History убедитесь, что недавний запуск web_logs показывает ожидаемое количество записей.
  3. Убедитесь, что недавние пользователи Zscaler или IP-адреса устройств отображаются у ожидаемых людей и что данные о веб-активности доступны для дальнейшей обработки.
  4. Если запуск принят, но активность не отображается, повторно проверьте точные значения источника, потока и плоский формат вывода.

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

API принимает не более 10 000 записей и 10 MB в одном запросе, при этом допускается 600 запросов за 60 секунд на организацию. Полное описание ответов и правил повторных попыток см. в разделе Custom Push Source API.

См. также

Custom Push Source API

Аутентификация, ограничения полезной нагрузки, ответы, повторные попытки и проверка запусков.

Zscaler Client Connector

Подключение отдельного API Client Connector для получения данных об устройствах и их состоянии.