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

> Zscaler Internet Access web günlüklerini bir Cloud NSS beslemesi aracılığıyla Living Security'ye gönderin.

Web günlüklerini Living Security'ye göndermek için bir Zscaler Internet Access (ZIA) Cloud Nanolog Streaming Service (NSS) beslemesi bağlayın. Bu, push tabanlı bir entegrasyondur. Pull tabanlı [Zscaler Client Connector](/tr/integrations/catalog/zscaler-client-connector-custom) entegrasyonundan ayrıdır.

## Bu entegrasyonun sağladığı katkı

Web günlüğü beslemesi, web etkinliğinde yer alan kullanıcıyı ve cihazı belirleyebilir; engellenen istekler, kötü amaçlı hedefler, veri aktarımı engellemeleri ve üretken yapay zekâ kullanımı gibi normalleştirilmiş etkinliklere katkı sağlayabilir. Sonuç, Zscaler'da yapılandırılan alanlara ve filtrelere bağlıdır.

## Başlamadan önce

Şunlara ihtiyacınız vardır:

* bir ZIA Cloud NSS aboneliği ve Cloud NSS beslemelerini yönetme yetkisi
* Living Security'de entegrasyonları ve erişim anahtarlarını yönetme yetkisi
* hedef Living Security kuruluşunun bölgesi
* oluşturulan erişim anahtarını saklamak için güvenli bir yer

Zscaler, HTTPS Cloud NSS hedefi için herkese açık olarak güvenilen bir TLS sertifikası gerektirir. Living Security bölgesel uç noktaları bu gereksinimi karşılar.

## 1. Living Security'yi hazırlayın

<Steps>
  <Step title="Kaynağı ve akışı oluşturun">
    **Ayarlar → Entegrasyonlar → Kataloğu** bölümüne gidin, **Custom Push Source** öğesini ekleyin ve aşağıdaki yönlendirme anahtarlarını aynen kullanın:

    | Alan | Değer |
    | - | - |
    | Data Source Name | `zscaler-nss-feed` |
    | Stream Name | `web_logs` |

    `web_logs` içindeki alt çizgi zorunludur. Farklı bir çift veri kabul edebilir ancak bakımı yapılan Zscaler NSS yorumlayıcısını kullanmaz.
  </Step>

  <Step title="Erişim anahtarı oluşturun">
    **Ayarlar → Access Keys** bölümüne gidin, **Push Ingest** kapsamına sahip bir erişim anahtarı oluşturun ve değerini hemen kopyalayın.
  </Step>

  <Step title="Hedef URL'yi oluşturun">
    Living Security bölgesine ait URL'yi kullanın:

    * Amerika Birleşik Devletleri: `https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
    * Avrupa Birliği: `https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
  </Step>
</Steps>

## 2. Cloud NSS beslemesini oluşturun

Güncel ZIA Admin Portal'da **Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service** bölümüne gidin, **Cloud NSS Feeds** sekmesini açın ve **Add Cloud NSS Feed** öğesini seçin. Menü etiketleri ZIA portalının eski sürümlerinde farklı olabilir; portal gezinmesi için Zscaler'ın [Cloud NSS web günlüğü yönergeleri](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs) esas alınmalıdır.

Beslemeyi yapılandırın:

| Zscaler alanı | Değer |
| - | - |
| Feed Name | `Living Security web logs` gibi tanınabilir bir ad |
| NSS Type | **NSS for Web** |
| Status | Yapılandırma sırasında **Disabled**; doğrulamadan sonra etkinleştirin |
| SIEM Rate | Kendi politikanız daha düşük bir hız gerektirmedikçe **Unlimited** |
| SIEM Type | **Other** |
| OAuth 2.0 Authentication | **Disabled** |
| Max Batch Size | **512 KB** |
| API URL | 1. adımdaki bölgesel Living Security URL'si |
| 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>
  `x-api-key` kullanmayın ve eski bir API anahtarını ile sırrı nokta ile birleştirmeyin. Güncel Living Security push alımı, kapsamlı erişim anahtarını yalnızca `Authorization: Bearer …` başlığında kabul eder.
</Warning>

Aşağıdaki birebir, düz **Feed Output Format** değerini tek satırda kullanın:

```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>
  Her alanı üst düzeyde tutun. Kullanımdan kaldırılan Unify kılavuzu bu alanları bir `event` nesnesinin içine sarıyor ve `sourcetype` ekliyordu. Bu zarf JSON olarak kabul edilebilir ancak güncel yorumlayıcıyla uyuşmaz; bu nedenle kişi veya etkinlik üretmez.
</Warning>

Zscaler olaylarını incelerken operasyon ekibinizin beklediği saat dilimini seçin. Living Security, besleme tarafından sağlanan `datetime` değerini ayrıştırır.

## 3. Beslemeyi filtreleyin ve etkinleştirin

İnsan riski programınız için gereken web etkinliğini göndermek üzere Zscaler'ın **Policy Action** ve **Policy Reason** filtrelerini kullanın. Trafik yoğunluğu sırasında günlüklerin atılmasına neden olabilecek düşük bir saniyedeki olay sayısı ayarından kaçının. Kuruluşunuzun beslemeyi sınırlaması gerekiyorsa, ayarı yaparken hem Zscaler teslimatını hem de Living Security Push History kaydını izleyin.

Beslemeyi kaydedin, Zscaler'ın bağlantı testini çalıştırın ve ardından **Status** değerini **Enabled** olarak ayarlayın.

## 4. Teslimatı ve yorumlamayı doğrulayın

1. Living Security'de **Ayarlar → Entegrasyonlar → Bağlandı → zscaler-nss-feed** yolunu açın.
2. **Push History** bölümünde, yakın zamanlı bir `web_logs` çalıştırmasının beklenen kayıt sayısını gösterdiğini doğrulayın.
3. Son Zscaler kullanıcılarının veya cihaz IP'lerinin beklenen kişilerle eşleştiğini ve web etkinliğinin aşağı akışta kullanılabildiğini doğrulayın.
4. Çalıştırma kabul edilmiş ancak hiçbir etkinlik görünmüyorsa, tam kaynağı, akışı ve düz çıktı biçimini yeniden kontrol edin.

## Sorun giderme

| Belirti | Kontrol edilecek nokta |
| - | - |
| `401 Unauthorized` | `Authorization` başlığını `Bearer <access-key>` değeriyle kullanın; süresi dolmuş veya iptal edilmiş anahtarı yenileyin |
| `403 Forbidden` | Anahtarı **Push Ingest** kapsamıyla oluşturun |
| `404 Not Found` | `zscaler-nss-feed` ve `web_logs` değerlerini kaydedin, ardından tam olarak bu URL'yi kullanın |
| `400 Bad Request` | JSON Array Notation özelliğini etkinleştirin ve çıktının düz nesnelerden oluşan üst düzey bir dizi olduğunu doğrulayın |
| `202` ancak kişi veya etkinlik yok | Eski `sourcetype` / `event` sarmalayıcısını kaldırın ve tam yönlendirme anahtarlarını doğrulayın |
| `429` | Geçici IP düzeyindeki kısıtlamanın geçmesini bekleyin ve varsa `Retry-After` değerine uyun |
| `503` | Toplu gönderimi yeniden denemek üzere saklayın, `Retry-After` süresini bekleyin ve değiştirmeden yeniden gönderin |
| Bağlantı testi başarısız oluyor | Bölgesel ana bilgisayar adını, Bearer başlığını, anahtar durumunu ve herkese açık TLS denetimi politikasını kontrol edin |

API, istek başına en fazla 10.000 kayıt ve 10 MB kabul eder; kuruluş başına 60 saniyede 600 isteğe izin verilir. Yanıt ve yeniden deneme sözleşmesinin tamamı için [Custom Push Source API](/tr/integrations/custom-push-source) sayfasına bakın.

## İlgili konular

<CardGroup cols={2}>
  <Card title="Custom Push Source API" icon="arrow-up-from-bracket" href="/tr/integrations/custom-push-source">
    Kimlik doğrulamayı, yük sınırlarını, yanıtları, yeniden denemeleri ve çalıştırma doğrulamasını inceleyin.
  </Card>

  <Card title="Zscaler Client Connector" icon="laptop" href="/tr/integrations/catalog/zscaler-client-connector-custom">
    Cihaz ve duruş verileri için ayrı Client Connector API'sini bağlayın.
  </Card>
</CardGroup>


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