> ## 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.

# Configuració de Zscaler ZIA Cloud NSS

> Envieu els registres web de Zscaler Internet Access a Living Security mitjançant un feed de Cloud NSS.

Connecteu un feed de Cloud Nanolog Streaming Service (NSS) de Zscaler Internet Access (ZIA) per enviar registres web a Living Security. Es tracta d'una integració de tipus push. És independent de la integració basada en pull [Zscaler Client Connector](/ca/integrations/catalog/zscaler-client-connector-custom).

## Què aporta aquesta integració

El feed de registres web pot identificar l'usuari i el dispositiu implicats en l'activitat web i pot aportar activitat normalitzada, com ara sol·licituds bloquejades, destinacions malicioses, bloquejos de transferència de dades i ús d'IA generativa. El resultat depèn dels camps i els filtres configurats a Zscaler.

## Abans de començar

Necessiteu:

* una subscripció a ZIA Cloud NSS i permís per gestionar feeds de Cloud NSS
* permís per gestionar integracions i claus d'accés a Living Security
* la regió de l'organització de Living Security de destinació
* un lloc segur on desar la clau d'accés generada

Zscaler requereix un certificat TLS de confiança pública per a una destinació HTTPS de Cloud NSS. Els punts d'accés regionals de Living Security compleixen aquest requisit.

## 1. Prepareu Living Security

<Steps>
  <Step title="Creeu l'origen i el flux">
    Aneu a **Settings → Integrations → Catalog**, afegiu **Custom Push Source** i feu servir exactament aquestes claus d'encaminament:

    | Field | Value |
    | - | - |
    | Data Source Name | `zscaler-nss-feed` |
    | Stream Name | `web_logs` |

    El guionet baix de `web_logs` és obligatori. Un altre parell pot acceptar dades, però no farà servir l'intèrpret de Zscaler NSS mantingut.
  </Step>

  <Step title="Creeu una clau d'accés">
    Aneu a **Settings → Access Keys**, creeu una clau d'accés amb l'àmbit **Push Ingest** i copieu-ne el valor immediatament.
  </Step>

  <Step title="Construïu l'URL de destinació">
    Feu servir l'URL corresponent a la regió de Living Security:

    * Estats Units: `https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
    * Unió Europea: `https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
  </Step>
</Steps>

## 2. Creeu el feed de Cloud NSS

Al ZIA Admin Portal actual, aneu a **Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service**, obriu **Cloud NSS Feeds** i seleccioneu **Add Cloud NSS Feed**. Les etiquetes dels menús poden diferir en versions anteriors del portal de ZIA; les [instruccions de Zscaler per als registres web de Cloud NSS](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs) són la referència per a la navegació pel portal.

Configureu el feed:

| Camp de Zscaler | Valor |
| - | - |
| Feed Name | Un nom reconeixible, com ara `Living Security web logs` |
| NSS Type | **NSS for Web** |
| Status | **Disabled** durant la configuració; activeu-lo després de la verificació |
| SIEM Rate | **Unlimited**, tret que la vostra pròpia política requereixi una taxa inferior |
| SIEM Type | **Other** |
| OAuth 2.0 Authentication | **Disabled** |
| Max Batch Size | **512 KB** |
| API URL | L'URL regional de Living Security del pas 1 |
| HTTP Header 1 | `Authorization` = `Bearer <access-key>` |
| HTTP Header 2 | `Content-Type` = `application/json` |
| Log Type | **Web Log** |
| Feed Output Type | **JSON** |
| JSON Array Notation | **Enabled** |
| Feed Escape Character | `,\"` |

<Warning>
  No feu servir `x-api-key` ni combineu una clau d'API i un secret antics amb un
  punt. L'ingest push actual de Living Security només accepta la clau d'accés
  d'àmbit limitat a la capçalera `Authorization: Bearer …`.
</Warning>

Feu servir aquest **Feed Output Format** pla i exacte en una sola línia:

```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}"}
```

<Warning>
  Mantingueu tots els camps al nivell superior. La guia retirada d'Unify
  incloïa aquests camps dins d'un objecte `event` i afegia `sourcetype`. Aquesta
  envoltura es pot acceptar com a JSON, però no coincideix amb l'intèrpret
  actual, de manera que no genera cap persona ni activitat.
</Warning>

Trieu la zona horària que el vostre equip d'operacions espera en revisar els esdeveniments de Zscaler. Living Security analitza el valor de `datetime` que proporciona el feed.

## 3. Filtreu i activeu el feed

Feu servir els filtres **Policy Action** i **Policy Reason** de Zscaler per enviar l'activitat web que necessita el vostre programa de risc humà. Eviteu una configuració baixa d'esdeveniments per segon que podria descartar registres durant un pic de trànsit. Si la vostra organització ha de limitar el feed, supervisi tant el lliurament de Zscaler com el Push History de Living Security mentre l'ajusteu.

Deseu el feed, executeu la prova de connectivitat de Zscaler i, a continuació, establiu **Status** a **Enabled**.

## 4. Verifiqueu el lliurament i la interpretació

1. A Living Security, obriu **Settings → Integrations → Connected → zscaler-nss-feed**.
2. A **Push History**, confirmeu que una execució recent de `web_logs` mostra el nombre de registres esperat.
3. Confirmeu que els usuaris o les IP de dispositiu recents de Zscaler apareixen associats a les persones esperades i que l'activitat web està disponible per als processos posteriors.
4. Si l'execució s'accepta però no apareix cap activitat, torneu a comprovar l'origen, el flux i el format de sortida pla exactes.

## Resolució de problemes

| Símptoma | Comprovació |
| - | - |
| `401 Unauthorized` | Feu servir `Authorization` amb el valor `Bearer <access-key>`; canvieu una clau caducada o revocada |
| `403 Forbidden` | Creeu la clau amb l'àmbit **Push Ingest** |
| `404 Not Found` | Registreu `zscaler-nss-feed` i `web_logs`, i feu servir exactament aquest URL |
| `400 Bad Request` | Activeu JSON Array Notation i confirmeu que la sortida és una matriu de nivell superior d'objectes plans |
| `202` però cap persona ni activitat | Elimineu l'envoltura heretada `sourcetype` / `event` i verifiqueu les claus d'encaminament exactes |
| `429` | Espereu que s'aixequi la limitació temporal a nivell d'IP i respecteu `Retry-After` quan hi sigui |
| `503` | Conserveu el lot per reintentar-lo, espereu `Retry-After` i torneu-lo a enviar sense modificar |
| La prova de connectivitat falla | Comproveu el nom d'amfitrió regional, la capçalera Bearer, l'estat de la clau i la política d'inspecció TLS pública |

L'API accepta com a màxim 10.000 registres i 10 MB per sol·licitud, amb 600 sol·licituds cada 60 segons per organització. Consulteu [Custom Push Source API](/ca/integrations/custom-push-source) per conèixer el contracte complet de respostes i reintents.

## Vegeu també

<CardGroup cols={2}>
  <Card title="Custom Push Source API" icon="arrow-up-from-bracket" href="/ca/integrations/custom-push-source">
    Reviseu l'autenticació, els límits de la càrrega, les respostes, els reintents i la verificació de les execucions.
  </Card>

  <Card title="Zscaler Client Connector" icon="laptop" href="/ca/integrations/catalog/zscaler-client-connector-custom">
    Connecteu l'API independent de Client Connector per obtenir dades de dispositius i de postura.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.