> ## 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. Підключіть потік Zscaler Internet Access (ZIA) Cloud Nanolog Streaming Service (NSS), щоб надсилати вебжурнали до Living Security. Це інтеграція з надсиланням даних (push). Вона відокремлена від інтеграції [Zscaler Client Connector](/uk/integrations/catalog/zscaler-client-connector-custom), що працює за принципом отримання даних (pull). ## Що надає ця інтеграція Потік вебжурналів може ідентифікувати користувача та пристрій, залучені до вебактивності, а також передавати нормалізовану активність, зокрема заблоковані запити, шкідливі адреси призначення, блокування передавання даних і використання генеративного ШІ. Результат залежить від полів і фільтрів, налаштованих у Zscaler. ## Перш ніж почати Вам потрібні: * підписка на ZIA Cloud NSS і дозвіл на керування потоками Cloud NSS * дозвіл на керування інтеграціями та ключами доступу в Living Security * регіон цільової організації в Living Security * безпечне місце для зберігання згенерованого ключа доступу Zscaler вимагає публічно довіреного TLS-сертифіката для HTTPS-призначення Cloud NSS. Регіональні кінцеві точки Living Security відповідають цій вимозі. ## 1. Підготуйте Living Security Перейдіть до **Settings → Integrations → Catalog**, додайте **Custom Push Source** і використайте такі точні ключі маршрутизації: | Field | Value | | - | - | | Data Source Name | `zscaler-nss-feed` | | Stream Name | `web_logs` | Символ підкреслення в `web_logs` є обов’язковим. Інша пара значень може приймати дані, але не використовуватиме підтримуваний інтерпретатор Zscaler NSS. Перейдіть до **Settings → 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. Налаштуйте фільтри та увімкніть потік Використовуйте фільтри **Policy Action** і **Policy Reason** у Zscaler, щоб надсилати вебактивність, потрібну для вашої програми управління людським ризиком. Уникайте низького значення кількості подій за секунду, яке може призвести до втрати журналів під час сплеску трафіку. Якщо вашій організації необхідно обмежити потік, стежте і за доставкою в Zscaler, і за Push History у Living Security під час налаштування. Збережіть потік, виконайте перевірку підключення Zscaler, а потім установіть для **Status** значення **Enabled**. ## 4. Перевірте доставку та інтерпретацію 1. У Living Security відкрийте **Settings → Integrations → Connected → 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](/uk/integrations/custom-push-source). ## Пов’язані матеріали Ознайомтеся з автентифікацією, обмеженнями корисного навантаження, відповідями, повторними спробами та перевіркою запусків. Підключіть окремий API Client Connector для отримання даних про пристрої та їхній стан безпеки. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.