> ## 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ón de Zscaler ZIA Cloud NSS

> Envíe los registros web de Zscaler Internet Access a Living Security mediante un feed de Cloud NSS.

Conecte un feed de Cloud Nanolog Streaming Service (NSS) de Zscaler Internet Access (ZIA) para enviar registros web a Living Security. Se trata de una integración de tipo push. Es independiente de la integración basada en extracción (pull) [Zscaler Client Connector](/es/integrations/catalog/zscaler-client-connector-custom).

## Qué aporta esta integración

El feed de registros web puede identificar al usuario y al dispositivo implicados en la actividad web, y puede aportar actividad normalizada, como solicitudes bloqueadas, destinos maliciosos, bloqueos de transferencia de datos y uso de IA generativa. El resultado depende de los campos y filtros configurados en Zscaler.

## Antes de comenzar

Necesita:

* una suscripción a ZIA Cloud NSS y permiso para administrar los feeds de Cloud NSS
* permiso para administrar integraciones y claves de acceso en Living Security
* la región de la organización de Living Security de destino
* un lugar seguro donde almacenar la clave de acceso generada

Zscaler requiere un certificado TLS de confianza pública para un destino HTTPS de Cloud NSS. Los endpoints regionales de Living Security cumplen ese requisito.

## 1. Preparar Living Security

<Steps>
  <Step title="Cree el origen y el flujo">
    Vaya a **Configuración → Integraciones → Catálogo**, agregue **Custom Push Source** y utilice estas claves de enrutamiento exactas:

    | Campo | Valor |
    | - | - |
    | Data Source Name | `zscaler-nss-feed` |
    | Stream Name | `web_logs` |

    El guion bajo en `web_logs` es obligatorio. Un par diferente puede aceptar datos, pero no utilizará el intérprete de Zscaler NSS que se mantiene.
  </Step>

  <Step title="Cree una clave de acceso">
    Vaya a **Configuración → Access Keys**, cree una clave de acceso con el alcance **Push Ingest** y copie su valor de inmediato.
  </Step>

  <Step title="Construya la URL de destino">
    Utilice la URL correspondiente a la región de Living Security:

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

## 2. Crear el feed de Cloud NSS

En el portal de administración de ZIA actual, vaya a **Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service**, abra **Cloud NSS Feeds** y seleccione **Add Cloud NSS Feed**. Las etiquetas de los menús pueden diferir en versiones anteriores del portal de ZIA; las [instrucciones de Zscaler para registros web de Cloud NSS](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs) son la referencia oficial para la navegación del portal.

Configure el feed:

| Campo de Zscaler | Valor |
| - | - |
| Feed Name | Un nombre reconocible, como `Living Security web logs` |
| NSS Type | **NSS for Web** |
| Status | **Disabled** durante la configuración; actívelo después de la verificación |
| SIEM Rate | **Unlimited**, a menos que su propia política requiera una tasa menor |
| SIEM Type | **Other** |
| OAuth 2.0 Authentication | **Disabled** |
| Max Batch Size | **512 KB** |
| API URL | La URL regional de Living Security del paso 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 utilice `x-api-key` ni combine una clave de API y un secreto antiguos con un
  punto. La ingesta push actual de Living Security acepta la clave de acceso con alcance únicamente
  en el encabezado `Authorization: Bearer …`.
</Warning>

Utilice este **Feed Output Format** exacto y plano, en una sola línea:

```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>
  Mantenga todos los campos en el nivel superior. La guía retirada de Unify incluía estos
  campos dentro de un objeto `event` y agregaba `sourcetype`. Esa envoltura puede ser
  aceptada como JSON, pero no coincide con el intérprete actual, por lo que no genera
  personas ni actividad.
</Warning>

Elija la zona horaria que su equipo de operaciones espera al revisar los eventos de Zscaler. Living Security analiza el valor de `datetime` proporcionado por el feed.

## 3. Filtrar y activar el feed

Utilice los filtros **Policy Action** y **Policy Reason** de Zscaler para enviar la actividad web que necesita su programa de riesgo humano. Evite una configuración baja de eventos por segundo que pueda descartar registros durante un pico de tráfico. Si su organización debe limitar el feed, supervise tanto la entrega de Zscaler como el Push History de Living Security mientras lo ajusta.

Guarde el feed, ejecute la prueba de conectividad de Zscaler y, a continuación, establezca **Status** en **Enabled**.

## 4. Verificar la entrega y la interpretación

1. En Living Security, abra **Configuración → Integraciones → conectado → zscaler-nss-feed**.
2. En **Push History**, confirme que una ejecución reciente de `web_logs` muestra el número de registros esperado.
3. Confirme que los usuarios o las IP de dispositivo recientes de Zscaler aparecen asociados a las personas esperadas y que la actividad web está disponible en los procesos posteriores.
4. Si la ejecución se acepta pero no aparece actividad, vuelva a comprobar el origen, el flujo y el formato de salida plano exactos.

## Solución de problemas

| Síntoma | Qué comprobar |
| - | - |
| `401 Unauthorized` | Utilice `Authorization` con el valor `Bearer <access-key>`; rote una clave caducada o revocada |
| `403 Forbidden` | Cree la clave con el alcance **Push Ingest** |
| `404 Not Found` | Registre `zscaler-nss-feed` y `web_logs` y, a continuación, utilice exactamente esa URL |
| `400 Bad Request` | Habilite JSON Array Notation y confirme que la salida es un arreglo de nivel superior de objetos planos |
| `202` pero sin personas ni actividad | Elimine la envoltura heredada `sourcetype` / `event` y verifique las claves de enrutamiento exactas |
| `429` | Espere a que finalice la limitación temporal a nivel de IP y respete `Retry-After` cuando esté presente |
| `503` | Conserve el lote para reintentarlo, espere `Retry-After` y reenvíelo sin cambios |
| Falla la prueba de conectividad | Compruebe el nombre de host regional, el encabezado Bearer, el estado de la clave y la política de inspección TLS pública |

La API acepta como máximo 10,000 registros y 10 MB por solicitud, con 600 solicitudes por cada 60 segundos por organización. Consulte [Custom Push Source API](/es/integrations/custom-push-source) para conocer el contrato completo de respuestas y reintentos.

## Temas relacionados

<CardGroup cols={2}>
  <Card title="Custom Push Source API" icon="arrow-up-from-bracket" href="/es/integrations/custom-push-source">
    Revise la autenticación, los límites de la carga útil, las respuestas, los reintentos y la verificación de ejecuciones.
  </Card>

  <Card title="Zscaler Client Connector" icon="laptop" href="/es/integrations/catalog/zscaler-client-connector-custom">
    Conecte la API independiente de Client Connector para obtener datos de dispositivos y de postura.
  </Card>
</CardGroup>


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