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

> שליחת יומני רשת (web logs) של Zscaler Internet Access אל Living Security באמצעות הזנת Cloud NSS.

חברו הזנת Zscaler Internet Access (ZIA) Cloud Nanolog Streaming Service (NSS) כדי לשלוח יומני רשת אל Living Security. זוהי אינטגרציית דחיפה (push). היא נפרדת מאינטגרציית [Zscaler Client Connector](/he/integrations/catalog/zscaler-client-connector-custom) המבוססת על משיכה (pull).

## מה האינטגרציה הזו מספקת

הזנת יומני הרשת יכולה לזהות את המשתמש והמכשיר המעורבים בפעילות ברשת, ויכולה לספק פעילות מנורמלת כגון בקשות שנחסמו, יעדים זדוניים, חסימות של העברת נתונים ושימוש בבינה מלאכותית גנרטיבית. התוצאה תלויה בשדות ובמסננים שהוגדרו ב-Zscaler.

## לפני שמתחילים

נדרשים:

* מנוי ל-ZIA Cloud NSS והרשאה לניהול הזנות Cloud NSS
* הרשאה לניהול אינטגרציות ומפתחות גישה ב-Living Security
* האזור (region) של הארגון היעד ב-Living Security
* מקום מאובטח לאחסון מפתח הגישה שנוצר

Zscaler דורשת אישור TLS מהימן לציבור עבור יעד HTTPS של Cloud NSS. נקודות הקצה האזוריות של Living Security עומדות בדרישה זו.

## 1. הכנת Living Security

<Steps>
  <Step title="יצירת המקור והזרם">
    עברו אל **הגדרות → שילובי → קטלוג**, הוסיפו את **Custom Push Source**, והשתמשו במפתחות הניתוב המדויקים הבאים:

    | שדה | ערך |
    | - | - |
    | Data Source Name | `zscaler-nss-feed` |
    | Stream Name | `web_logs` |

    קו תחתון ב-`web_logs` הוא חובה. זוג אחר עשוי לקבל נתונים, אך לא ישתמש במפרש Zscaler NSS המתוחזק.
  </Step>

  <Step title="יצירת מפתח גישה">
    עברו אל **הגדרות → Access Keys**, צרו מפתח גישה עם ההיקף **Push Ingest**, והעתיקו את ערכו מיד.
  </Step>

  <Step title="בניית כתובת ה-URL של היעד">
    השתמשו בכתובת ה-URL של אזור Living Security:

    * ארצות הברית: `https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
    * האיחוד האירופי: `https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
  </Step>
</Steps>

## 2. יצירת הזנת Cloud NSS

בפורטל הניהול הנוכחי של ZIA, עברו אל **Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service**, פתחו את **Cloud NSS Feeds**, ובחרו **Add Cloud NSS Feed**. ייתכן שתוויות התפריט שונות בגרסאות ישנות יותר של פורטל ZIA; [הוראות Cloud NSS ליומני רשת](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs) של Zscaler הן המקור המחייב לניווט בפורטל.

הגדירו את ההזנה:

| שדה ב-Zscaler | ערך |
| - | - |
| Feed Name | שם ברור לזיהוי, כגון `Living Security web logs` |
| NSS Type | **NSS for Web** |
| Status | **Disabled** בזמן ההגדרה; יש להפעיל לאחר האימות |
| SIEM Rate | **Unlimited**, אלא אם המדיניות שלכם דורשת קצב נמוך יותר |
| SIEM Type | **Other** |
| OAuth 2.0 Authentication | **Disabled** |
| Max Batch Size | **512 KB** |
| API URL | כתובת ה-URL האזורית של Living Security מצעד 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>
  אל תשתמשו ב-`x-api-key` ואל תשלבו מפתח API וסוד ישנים באמצעות
  נקודה. קליטת הדחיפה (push ingest) הנוכחית של Living Security מקבלת את מפתח הגישה בעל ההיקף בלבד
  בכותרת `Authorization: Bearer …`.
</Warning>

השתמשו ב-**Feed Output Format** השטוח והמדויק הבא, בשורה אחת:

```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>
  שמרו כל שדה ברמה העליונה. המדריך הישן של Unify עטף את השדות האלה
  בתוך אובייקט `event` והוסיף `sourcetype`. מעטפת כזו עשויה
  להתקבל כ-JSON אך אינה תואמת למפרש הנוכחי, ולכן אינה מפיקה
  אנשים או פעילות.
</Warning>

בחרו את אזור הזמן שצוות התפעול שלכם מצפה לו בעת סקירת אירועי Zscaler. Living Security מנתחת את הערך `datetime` שההזנה מספקת.

## 3. סינון והפעלה של ההזנה

השתמשו במסנני **Policy Action** ו-**Policy Reason** של Zscaler כדי לשלוח את הפעילות ברשת הנדרשת לתוכנית סיכוני האנוש שלכם. הימנעו מהגדרה נמוכה של אירועים לשנייה, העלולה לגרום לאובדן יומנים בעת שיא בתעבורה. אם הארגון שלכם נדרש להגביל את ההזנה, עקבו הן אחר המסירה ב-Zscaler והן אחר Push History ב-Living Security בזמן כוונון ההגדרה.

שמרו את ההזנה, הריצו את בדיקת הקישוריות של Zscaler, ולאחר מכן הגדירו את **Status** ל-**Enabled**.

## 4. אימות המסירה והפירוש

1. ב-Living Security, פתחו **הגדרות → שילובי → מחובר → zscaler-nss-feed**.
2. ב-**Push History**, ודאו שהרצה אחרונה של `web_logs` מציגה את מספר הרשומות הצפוי.
3. ודאו שמשתמשי Zscaler או כתובות IP של מכשירים אחרונים מופיעים מול האנשים הצפויים, ושהפעילות ברשת זמינה בהמשך התהליך.
4. אם ההרצה התקבלה אך לא מופיעה פעילות, בדקו שוב את המקור, הזרם ופורמט הפלט השטוח המדויקים.

## פתרון בעיות

| תסמין | מה לבדוק |
| - | - |
| `401 Unauthorized` | השתמשו ב-`Authorization` עם הערך `Bearer <access-key>`; החליפו מפתח שפג תוקפו או שבוטל |
| `403 Forbidden` | צרו את המפתח עם ההיקף **Push Ingest** |
| `404 Not Found` | רשמו את `zscaler-nss-feed` ואת `web_logs`, ולאחר מכן השתמשו בכתובת ה-URL המדויקת הזו |
| `400 Bad Request` | הפעילו את JSON Array Notation וודאו שהפלט הוא מערך ברמה העליונה של אובייקטים שטוחים |
| `202` אך ללא אנשים או פעילות | הסירו את המעטפת הישנה `sourcetype` / `event` ואמתו את מפתחות הניתוב המדויקים |
| `429` | המתינו להסרת ההגבלה הזמנית ברמת ה-IP והתחשבו ב-`Retry-After` כאשר הוא קיים |
| `503` | שמרו את האצווה לניסיון חוזר, המתינו ל-`Retry-After` ושלחו אותה מחדש ללא שינוי |
| בדיקת הקישוריות נכשלת | בדקו את שם המארח האזורי, את כותרת ה-Bearer, את מצב המפתח ואת מדיניות בדיקת TLS הציבורית |

ה-API מקבל לכל היותר 10,000 רשומות ו-10 MB לכל בקשה, עם 600 בקשות ב-60 שניות לכל ארגון. לפרטים מלאים על חוזה התגובות והניסיונות החוזרים, ראו [Custom Push Source API](/he/integrations/custom-push-source).

## קישורים קשורים

<CardGroup cols={2}>
  <Card title="Custom Push Source API" icon="arrow-up-from-bracket" href="/he/integrations/custom-push-source">
    סקירה של אימות, מגבלות מטען, תגובות, ניסיונות חוזרים ואימות הרצות.
  </Card>

  <Card title="Zscaler Client Connector" icon="laptop" href="/he/integrations/catalog/zscaler-client-connector-custom">
    חיבור ה-API הנפרד של Client Connector לנתוני מכשירים ומצב אבטחה (posture).
  </Card>
</CardGroup>


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