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

# הגדרת אינטגרציית Netskope

> חברו את Netskope ל-Living Security עבור פעילות אינטרנט, ענן, אימות, הגנה על נתונים ואיומים.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>משאבים קשורים</h2>
    <ul>
      <li>
        <a href="/he/signals/data-sources">כך הופכים נתוני אינטגרציה לאותות של ניהול סיכוני גורם אנוש</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">גלו את האינטגרציות של Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">פתחו את Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">בקשו הדגמה של Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>יש להוסיף את ארבע כתובות ה-IP של יציאת הסנכרון של Living Security</strong> לרשימת ההיתרים ב-{' '}
    {system}. יש להזין כל כתובת כמארח יחיד עם <code>/32</code> אם {system} מצפה לסימון CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    התעבורה עשויה לצאת מכל אחת מהארבע, ולכן הוספה לרשימת ההיתרים של חלקן בלבד גורמת לכשלי סנכרון לסירוגין. ארבע הכתובות האלה זהות בכל אזור של Living Security. לרשימה המלאה, למדיניות השינויים ולפתרון בעיות, ראו{' '}
    <a href="/he/integrations/managing/egress-ip-addresses">
      הגדרת כתובות IP של יציאה עבור אינטגרציות
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="הזינו את פרטי הגישה ב-Living Security Platform">
    <p>
      השלב מבוצע על ידי מי שיש לו גישה ל-Living Security — בעל התוכנית, או מנהל המערכת
      אם הוזמן (הגדרה מואצלת).
    </p>
    <ol>
      <li>
        עברו אל <strong>הגדרות → שילובי → קטלוג</strong>, אתרו את האריח{' '}
        <strong>{tile}</strong> ולחצו על <strong>חבר</strong>.
      </li>
      <li>
        מלאו את השדות שלהלן, ולאחר מכן לחצו על <strong>חבר</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>מדריך זה מיועד למנהל/ת {system} שלכם.</strong> הוא עוסק ביצירת אישורי API
      בתוך {system}, פעולה הדורשת הרשאות ניהול ב-{system} — ולא ב-Living Security Platform.
    </p>
    <p>
      אם אתם <strong>בעלי התוכנית</strong> של Living Security ואינכם מנהלים את {system},
      העבירו דף זה לאיש או אשת הקשר המנהלים אותה. הם ישלימו את חלק A ויעבירו אליכם את האישורים
      (או שיזינו אותם ישירות אם הוזמנו לפלטפורמה).
      {recommendDelegated && <>
          {' '}מאחר שהתקנה זו מפיקה חומרי מפתח רגישים, אנו ממליצים על מסלול{' '}
          <strong>ההתקנה המואצלת</strong>, כך שהסוד לעולם לא יישלח אליכם.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Netskope" />

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

Netskope יכולה לספק פעילות מנורמלת של אינטרנט, ענן, אימות, הגנה על נתונים ואיומים. דוגמאות שנבדקו כוללות:

* `web.ai.visited` — ביקור באתר בינה מלאכותית
* `data.bulk.uploaded` — העלאת נתונים בכמות גדולה
* `geo.impossible` — נסיעה בלתי אפשרית בין כניסות למערכת

החיבור הנוכחי משתמש ב-REST API v2; ללקוחות קיימים עשוי להופיע גם וריאנט REST מיושן. ראו [כיצד נתוני אינטגרציה הופכים לאותות](/he/signals/data-sources).

## מה Living Security דורשת

| אישור גישה | תיאור |
| - | - |
| **אסימון API** | אסימון REST API v2 שנוצר מתוך מסוף הניהול של Netskope |
| **תת-דומיין של הטננט** | תת-הדומיין של הטננט שלכם ב-Netskope (לדוגמה, `acme` מתוך `acme.goskope.com`) |

**גישה נדרשת לנקודות קצה:**

| נקודת קצה | מטרה |
| - | - |
| `/api/v2/events/data/alert` | התראות איומים, הפרות מדיניות, אירועי DLP, זיהויי תוכנות זדוניות |
| `/api/v2/events/data/page` | פעילות אינטרנט — גלישה, אתרים מותרים וחסומים, גישה ליישומי ענן |

**תפקיד נדרש:** **Tenant Admin** או תפקיד שווה ערך עם גישה אל **הגדרות ← Tools**

<Note>
  אינטגרציה זו דורשת **אסימון API מסוג v2**, ולא אסימון v1. אסימוני v1 משתמשים באימות באמצעות פרמטר שאילתה ולא יעבדו מול נקודת הקצה של ה-API מסוג v2.
</Note>

### דרישות מקדימות

* נדרשת לכם גישת **Tenant Admin** ב-Netskope לצורך ניהול אסימוני REST API.

***

## חלק א׳ — ב-Netskope

*השלבים הבאים מבוצעים על ידי מנהל Netskope שלכם.*

<Steps>
  <Step title="מעבר לניהול אסימוני REST API v2">
    1. היכנסו למסוף הניהול של Netskope בכתובת `https://<tenant>.goskope.com`.
    2. בניווט השמאלי, לחצו על **הגדרות**.
    3. תחת **Tools**, בחרו **REST API v2**.
  </Step>

  <Step title="יצירת אסימון חדש">
    1. לחצו על **New Token**.
    2. הזינו שם תיאורי (לדוגמה, `Living Security Platform`).
    3. תחת הגישה לנקודות קצה, אפשרו גישה אל:

    | נקודת קצה | גישה נדרשת |
    | - | - |
    | `/api/v2/events/data/alert` | קריאה |
    | `/api/v2/events/data/page` | קריאה |

    <Warning>
      יש להעניק גישה **לשתי** נקודות הקצה. הן מזינות שני זרמים נפרדים — `alerts` ו-
      `events` — ואסימון המוגבל לאחת מהן בלבד עדיין מתחבר בהצלחה.
      הזרם התלוי בנקודת הקצה החסרה לא יחזיר דבר, ללא שגיאה
      שתסביר מדוע.
    </Warning>

    <Note>
      אלה נקודות הקצה היחידות ש-Living Security דורשת. הענקת גישה לאלה בלבד
      עומדת בעקרון ההרשאה המינימלית.
    </Note>

    4. לחצו על **שמור** (או **Generate Token**).
  </Step>

  <Step title="העתקה ושמירה של האסימון">
    **העתיקו את האסימון מיד** ואחסנו אותו באופן מאובטח.

    <Warning>
      Netskope מציגה את ערך האסימון **פעם אחת בלבד** בעת היצירה. אם תעברו למסך אחר מבלי להעתיק אותו, תצטרכו למחוק את האסימון וליצור אסימון חדש.
    </Warning>
  </Step>

  <Step title="הגדרת רשימת היתרים של כתובות IP (אם רלוונטי)">
    אם בטננט Netskope שלכם מופעלת רשימת היתרים של כתובות IP, עליכם להוסיף את טווחי כתובות ה-IP של היציאה של Living Security.

    1. במסוף הניהול של Netskope, עברו אל **הגדרות ← ניהול ← IP Allowlist**.
    2. אם רשימת ההיתרים של כתובות IP מופעלת, הוסיפו כל [כתובת IP של יציאה של Living Security](/he/integrations/managing/egress-ip-addresses) לרשימת **Custom IP**.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      אם רשימת ההיתרים של כתובות IP מופעלת, תיבת הדו-שיח של החיבור תצליח, אך סנכרוני הנתונים ייכשלו עם `401 Unauthorized` עד שייווספו כתובות ה-IP הנכונות.
    </Warning>
  </Step>

  <Step title="זיהוי תת-הדומיין של הטננט">
    תת-הדומיין של הטננט הוא התחילית של כתובת ה-URL של מסוף הניהול של Netskope.

    אם כתובת ה-URL של המסוף שלכם היא `https://acme.goskope.com`, תת-הדומיין שלכם הוא `acme`.

    הזינו את תת-הדומיין החשוף בלבד — ללא `https://`, ללא `.goskope.com`, וללא לוכסן בסוף.

    <Note>
      תיבת הדו-שיח של החיבור מקבלת מספר צורות קלט (תת-דומיין חשוף, שם מארח מלא או כתובת URL מלאה) ומבצעת נרמול אוטומטי. עם זאת, מומלץ להזין את תת-הדומיין החשוף.
    </Note>
  </Step>
</Steps>

***

## חלק ב׳ — ב-Living Security Platform

*בעל התוכנית מבצע שלב זה, או מנהל המערכת אם נעשה שימוש בהגדרה מואצלת.*

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | שדה | ערך |
    | - | - |
    | **מפתח API** | האסימון מחלק א׳, שלב 3 |
    | **תת-דומיין של הטננט** | תת-הדומיין מחלק א׳, שלב 5 (לדוגמה, `acme`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="תיבת הדו-שיח של החיבור ב-Living Security עבור Netskope v2 API" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

כעת אתם מחוברים ל-Netskope (v2 API).

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    סיבות נפוצות:

    1. **האסימון בוטל או שתוקפו פג** — צרו אסימון חדש
    2. **שימוש באסימון v1** — אסימוני v1 מבצעים אימות באמצעות פרמטר שאילתה ולא יעבדו מול נקודות קצה של v2. צרו אסימון v2 חדש דרך **הגדרות ← Tools ← REST API v2**
    3. **רשימת היתרים של כתובות IP חוסמת בקשות** — אם בטננט שלכם מופעלת רשימת היתרים של כתובות IP, ודאו ששכל ארבע [כתובות ה-IP של היציאה של Living Security](/he/integrations/managing/egress-ip-addresses) נמצאות ברשימת ההיתרים
  </Accordion>

  <Accordion title="403 Forbidden">
    האסימון נוצר ללא גישה אל `/api/v2/events/data/alert` או אל `/api/v2/events/data/page`. לא ניתן לשנות את הרשאות נקודות הקצה של האסימון לאחר יצירתו — צרו אסימון חדש עם הרשאת קריאה לשתיהן והתחברו מחדש.
  </Accordion>

  <Accordion title="התראות מגיעות אך פעילות האינטרנט חסרה (או להפך)">
    באסימון חסרה אחת משתי נקודות הקצה הנדרשות. אסימון המוגבל ל-
    `/api/v2/events/data/alert` בלבד או ל-`/api/v2/events/data/page` בלבד עדיין מתחבר,
    והזרם התלוי בנקודת הקצה החסרה נשאר ריק ללא כל הודעה.

    לא ניתן לשנות את הרשאות נקודות הקצה לאחר יצירת האסימון — צרו אסימון
    חדש עם הרשאת קריאה לשתיהן, ולאחר מכן התחברו מחדש.
  </Accordion>

  <Accordion title="הסנכרונים עבדו אך כעת נכשלים עם 401">
    אם רשימת ההיתרים של כתובות IP מופעלת, ייתכן שכתובות ה-IP של היציאה של Living Security השתנו. עיינו ב-[הגדרת כתובות IP של יציאה לאינטגרציות](/he/integrations/managing/egress-ip-addresses) ועדכנו את רשימת **Custom IP** בהתאם.
  </Accordion>

  <Accordion title="שימוש באסימון v1 במקום v2">
    אסימוני v1 ו-v2 משתמשים במנגנוני אימות שונים:

    * **v1**: פרמטר שאילתה (`token=...`)
    * **v2**: כותרת (`Netskope-Api-Token: ...`)

    Living Security משתמשת באימות v2. צרו אסימון חדש דרך **הגדרות ← Tools ← REST API v2** (ולא דרך דף האסימון הישן של v1).
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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