Zscaler ZIA Cloud NSS kurulumu

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

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.

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.

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

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 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	`,\"`

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.

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

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

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.

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

Living Security’de Ayarlar → Entegrasyonlar → Bağlandı → zscaler-nss-feed yolunu açın.
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.
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.
Ç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 sayfasına bakın.

İlgili konular

Custom Push Source API

Kimlik doğrulamayı, yük sınırlarını, yanıtları, yeniden denemeleri ve çalıştırma doğrulamasını inceleyin.

Zscaler Client Connector

Cihaz ve duruş verileri için ayrı Client Connector API’sini bağlayın.

Entegrasyonlar

Entegrasyon kurulumu

Katalog

Giden Kanallar

Bu entegrasyonun sağladığı katkı

Başlamadan önce

1. Living Security’yi hazırlayın

2. Cloud NSS beslemesini oluşturun

3. Beslemeyi filtreleyin ve etkinleştirin

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

Sorun giderme

İlgili konular

Custom Push Source API

Zscaler Client Connector

Entegrasyonlar

Entegrasyon kurulumu

Katalog

Giden Kanallar

​Bu entegrasyonun sağladığı katkı

​Başlamadan önce

​1. Living Security’yi hazırlayın

​2. Cloud NSS beslemesini oluşturun

​3. Beslemeyi filtreleyin ve etkinleştirin

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

​Sorun giderme

​İlgili konular

Custom Push Source API

Zscaler Client Connector

Bu entegrasyonun sağladığı katkı

Başlamadan önce

1. Living Security’yi hazırlayın

2. Cloud NSS beslemesini oluşturun

3. Beslemeyi filtreleyin ve etkinleştirin

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

Sorun giderme

İlgili konular