> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Настройка Zscaler ZIA Cloud NSS > Отправка веб-журналов Zscaler Internet Access в Living Security с помощью канала Cloud NSS. Подключите канал Cloud Nanolog Streaming Service (NSS) в Zscaler Internet Access (ZIA), чтобы отправлять веб-журналы в Living Security. Это интеграция с передачей данных по инициативе источника (push). Она не связана с интеграцией [Zscaler Client Connector](/ru/integrations/catalog/zscaler-client-connector-custom), которая работает по принципу получения данных (pull). ## Что дает эта интеграция Канал веб-журналов позволяет определить пользователя и устройство, связанные с веб-активностью, а также передавать нормализованные данные об активности, такие как заблокированные запросы, вредоносные адреса назначения, блокировки передачи данных и использование генеративного ИИ. Результат зависит от полей и фильтров, настроенных в Zscaler. ## Перед началом работы Вам потребуются: * подписка на ZIA Cloud NSS и разрешение на управление каналами Cloud NSS * разрешение на управление интеграциями и ключами доступа в Living Security * регион целевой организации в Living Security * безопасное место для хранения созданного ключа доступа Для назначения HTTPS в Cloud NSS Zscaler требует TLS-сертификат, которому доверяют публичные центры сертификации. Региональные конечные точки Living Security соответствуют этому требованию. ## 1. Подготовка Living Security Перейдите в раздел **Настройки → Интеграции → Каталог**, добавьте **Custom Push Source** и используйте следующие ключи маршрутизации без изменений: | Поле | Значение | | - | - | | Data Source Name | `zscaler-nss-feed` | | Stream Name | `web_logs` | Символ подчеркивания в `web_logs` обязателен. Другая пара значений может принимать данные, но не будет использовать поддерживаемый интерпретатор Zscaler NSS. Перейдите в раздел **Настройки → Access Keys**, создайте ключ доступа с областью **Push Ingest** и сразу скопируйте его значение. Используйте 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](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs), которая является авторитетным источником. Настройте канал: | Поле Zscaler | Значение | | - | - | | Feed Name | Понятное имя, например `Living Security web logs` | | NSS Type | **NSS for Web** | | Status | **Disabled** на время настройки; включите после проверки | | SIEM Rate | **Unlimited**, если ваша политика не требует меньшего значения | | SIEM Type | **Other** | | OAuth 2.0 Authentication | **Disabled** | | Max Batch Size | **512 KB** | | API URL | Региональный URL Living Security из шага 1 | | HTTP Header 1 | `Authorization` = `Bearer ` | | HTTP Header 2 | `Content-Type` = `application/json` | | Log Type | **Web Log** | | Feed Output Type | **JSON** | | JSON Array Notation | **Enabled** | | Feed Escape Character | `,\"` | Не используйте `x-api-key` и не объединяйте старый ключ API и секрет через точку. Текущий механизм push-приема данных Living Security принимает ключ доступа с заданной областью только в заголовке `Authorization: Bearer …`. Используйте следующий плоский **Feed Output Format** в одной строке без изменений: ```text theme={null} {"datetime":"%d{yy}-%02d{mth}-%02d{dd} %02d{hh}:%02d{mm}:%02d{ss}","reason":"%s{reason}","event_id":"%d{recordid}","protocol":"%s{proto}","action":"%s{action}","transactionsize":"%d{totalsize}","responsesize":"%d{respsize}","requestsize":"%d{reqsize}","urlcategory":"%s{urlcat}","serverip":"%s{sip}","requestmethod":"%s{reqmethod}","refererURL":"%s{ereferer}","useragent":"%s{eua}","product":"NSS","location":"%s{elocation}","ClientIP":"%s{cip}","status":"%s{respcode}","user":"%s{elogin}","url":"%s{eurl}","vendor":"Zscaler","hostname":"%s{ehost}","clientpublicIP":"%s{cintip}","threatcategory":"%s{malwarecat}","threatname":"%s{threatname}","filetype":"%s{filetype}","appname":"%s{appname}","riskscore":"%d{riskscore}","department":"%s{edepartment}","urlsupercategory":"%s{urlsupercat}","appclass":"%s{appclass}","dlpengine":"%s{dlpeng}","urlclass":"%s{urlclass}","threatclass":"%s{malwareclass}","dlpdictionaries":"%s{dlpdict}","fileclass":"%s{fileclass}","bwthrottle":"%s{bwthrottle}","contenttype":"%s{contenttype}","unscannabletype":"%s{unscannabletype}","deviceowner":"%s{deviceowner}","devicehostname":"%s{devicehostname}","keyprotectiontype":"%s{keyprotectiontype}"} ``` Располагайте все поля на верхнем уровне. В устаревшем руководстве по 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. Если запуск принят, но активность не отображается, повторно проверьте точные значения источника, потока и плоский формат вывода. ## Устранение неполадок | Симптом | Что проверить | | - | - | | `401 Unauthorized` | Используйте `Authorization` со значением `Bearer `; замените просроченный или отозванный ключ | | `403 Forbidden` | Создайте ключ с областью **Push Ingest** | | `404 Not Found` | Зарегистрируйте `zscaler-nss-feed` и `web_logs`, затем используйте именно этот URL | | `400 Bad Request` | Включите JSON Array Notation и убедитесь, что вывод представляет собой массив плоских объектов верхнего уровня | | `202`, но нет людей или активности | Удалите устаревшую оболочку `sourcetype` / `event` и проверьте точные ключи маршрутизации | | `429` | Выдержите паузу из-за временного ограничения на уровне IP-адреса и учитывайте `Retry-After`, если он присутствует | | `503` | Сохраните пакет для повторной отправки, дождитесь `Retry-After` и отправьте его повторно без изменений | | Не проходит проверка подключения | Проверьте региональное имя хоста, заголовок Bearer, статус ключа и политику инспекции TLS для публичных сертификатов | API принимает не более 10 000 записей и 10 MB в одном запросе, при этом допускается 600 запросов за 60 секунд на организацию. Полное описание ответов и правил повторных попыток см. в разделе [Custom Push Source API](/ru/integrations/custom-push-source). ## См. также Аутентификация, ограничения полезной нагрузки, ответы, повторные попытки и проверка запусков. Подключение отдельного API Client Connector для получения данных об устройствах и их состоянии. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.