Skip to main content
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.

​
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

1

Creare l'origine e lo stream

Acceda a Impostazioni → Integrazioni → Catalogo, aggiunga Custom Push Source e utilizzi queste chiavi di routing esatte:Il carattere di sottolineatura in web_logs è obbligatorio. Una coppia diversa può accettare dati, ma non utilizzerà l’interprete Zscaler NSS mantenuto.
2

Creare una chiave di accesso

Acceda a Impostazioni → Access Keys, crei una chiave di accesso con ambito Push Ingest e ne copi subito il valore.
3

Costruire l'URL di destinazione

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 sono il riferimento ufficiale per la navigazione nel portale. Configuri il feed:
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:
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

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.

​
Correlati

Custom Push Source API

Esamini autenticazione, limiti del payload, risposte, nuovi tentativi e verifica delle esecuzioni.

Zscaler Client Connector

Colleghi la API Client Connector separata per i dati su dispositivi e postura.