> ## 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. # Configurazione di Zscaler ZIA Cloud NSS > Invii i log web di Zscaler Internet Access a Living Security tramite un feed Cloud NSS. Colleghi un feed Zscaler Internet Access (ZIA) Cloud Nanolog Streaming Service (NSS) per inviare i log web a Living Security. Si tratta di un'integrazione di tipo push, distinta dall'integrazione basata su pull [Zscaler Client Connector](/it/integrations/catalog/zscaler-client-connector-custom). ## Cosa apporta questa integrazione Il feed dei log web può identificare l'utente e il dispositivo coinvolti nell'attività web e può fornire attività normalizzate, come richieste bloccate, destinazioni dannose, blocchi del trasferimento di dati e utilizzo di IA generativa. Il risultato dipende dai campi e dai filtri configurati in Zscaler. ## Prima di iniziare Sono necessari: * una sottoscrizione a ZIA Cloud NSS e l'autorizzazione a gestire i feed Cloud NSS * l'autorizzazione a gestire le integrazioni e le chiavi di accesso in Living Security * la regione dell'organizzazione Living Security di destinazione * un luogo sicuro in cui conservare la chiave di accesso generata Zscaler richiede un certificato TLS attendibile pubblicamente per una destinazione Cloud NSS HTTPS. Gli endpoint regionali di Living Security soddisfano tale requisito. ## 1. Preparare Living Security Acceda a **Impostazioni → Integrazioni → Catalogo**, aggiunga **Custom Push Source** e utilizzi queste chiavi di routing esatte: | Campo | Valore | | - | - | | Data Source Name | `zscaler-nss-feed` | | Stream Name | `web_logs` | Il carattere di sottolineatura in `web_logs` è obbligatorio. Una coppia diversa può accettare dati, ma non utilizzerà l'interprete Zscaler NSS mantenuto. Acceda a **Impostazioni → Access Keys**, crei una chiave di accesso con ambito **Push Ingest** e ne copi subito il valore. Utilizzi l'URL corrispondente alla regione di Living Security: * Stati Uniti: `https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs` * Unione Europea: `https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs` ## 2. Creare il feed Cloud NSS Nell'attuale ZIA Admin Portal, acceda a **Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service**, apra **Cloud NSS Feeds** e selezioni **Add Cloud NSS Feed**. Le etichette dei menu possono differire nelle versioni meno recenti del portale ZIA; le [istruzioni di Zscaler per i log web Cloud NSS](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs) sono il riferimento ufficiale per la navigazione nel portale. Configuri il feed: | Campo Zscaler | Valore | | - | - | | Feed Name | Un nome riconoscibile, ad esempio `Living Security web logs` | | NSS Type | **NSS for Web** | | Status | **Disabled** durante la configurazione; attivare dopo la verifica | | SIEM Rate | **Unlimited**, a meno che la Sua policy non richieda una frequenza inferiore | | SIEM Type | **Other** | | OAuth 2.0 Authentication | **Disabled** | | Max Batch Size | **512 KB** | | API URL | L'URL regionale di Living Security indicato al passaggio 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 | `,\"` | Non utilizzi `x-api-key` e non combini una vecchia chiave API e un secret con un punto. L'attuale push ingest di Living Security accetta la chiave di accesso con ambito solo nell'intestazione `Authorization: Bearer …`. Utilizzi questo **Feed Output Format** esatto e piatto, su una sola riga: ```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}"} ``` Mantenga ogni campo al livello principale. La guida di Unify ormai ritirata racchiudeva questi campi all'interno di un oggetto `event` e aggiungeva `sourcetype`. Tale envelope può essere accettato come JSON, ma non corrisponde all'interprete attuale, pertanto non produce né persone né attività. Scelga il fuso orario che il Suo team operativo si aspetta durante la revisione degli eventi Zscaler. Living Security analizza il valore `datetime` fornito dal feed. ## 3. Filtrare e attivare il feed Utilizzi i filtri **Policy Action** e **Policy Reason** di Zscaler per inviare l'attività web necessaria al Suo programma per la gestione del rischio umano. Eviti un'impostazione bassa di eventi al secondo che potrebbe scartare log durante un picco di traffico. Se la Sua organizzazione deve limitare il feed, monitori sia la consegna in Zscaler sia la Push History di Living Security durante la messa a punto. Salvi il feed, esegua il test di connettività di Zscaler e poi imposti **Status** su **Enabled**. ## 4. Verificare la consegna e l'interpretazione 1. In Living Security, apra **Impostazioni → Integrazioni → Connesso → zscaler-nss-feed**. 2. In **Push History**, verifichi che un'esecuzione `web_logs` recente mostri il numero di record previsto. 3. Verifichi che gli utenti o gli indirizzi IP dei dispositivi Zscaler recenti compaiano in corrispondenza delle persone previste e che l'attività web sia disponibile a valle. 4. Se l'esecuzione è accettata ma non compare alcuna attività, ricontrolli l'origine, lo stream e il formato di output piatto esatti. ## Risoluzione dei problemi | Sintomo | Verifica | | - | - | | `401 Unauthorized` | Utilizzi `Authorization` con valore `Bearer `; ruoti una chiave scaduta o revocata | | `403 Forbidden` | Crei la chiave con ambito **Push Ingest** | | `404 Not Found` | Registri `zscaler-nss-feed` e `web_logs`, quindi utilizzi esattamente tale URL | | `400 Bad Request` | Attivi JSON Array Notation e verifichi che l'output sia un array di primo livello di oggetti piatti | | `202` ma nessuna persona o attività | Rimuova il wrapper legacy `sourcetype` / `event` e verifichi le chiavi di routing esatte | | `429` | Attenda la fine della limitazione temporanea a livello di IP e rispetti `Retry-After` quando presente | | `503` | Conservi il batch per un nuovo tentativo, attenda `Retry-After` e lo reinvii senza modifiche | | Il test di connettività non riesce | Verifichi il nome host regionale, l'intestazione Bearer, lo stato della chiave e la policy di ispezione TLS pubblica | L'API accetta al massimo 10.000 record e 10 MB per richiesta, con 600 richieste ogni 60 secondi per organizzazione. Per il contratto completo di risposta e di nuovo tentativo, consulti [Custom Push Source API](/it/integrations/custom-push-source). ## Correlati Esamini autenticazione, limiti del payload, risposte, nuovi tentativi e verifica delle esecuzioni. Colleghi la API Client Connector separata per i dati su dispositivi e postura. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.