Skip to main content

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

Netskope יכולה לספק פעילות מנורמלת של אינטרנט, ענן, אימות, הגנה על נתונים ואיומים. דוגמאות שנבדקו כוללות:
  • web.ai.visited — ביקור באתר בינה מלאכותית
  • data.bulk.uploaded — העלאת נתונים בכמות גדולה
  • geo.impossible — נסיעה בלתי אפשרית בין כניסות למערכת
החיבור הנוכחי משתמש ב-REST API v2; ללקוחות קיימים עשוי להופיע גם וריאנט REST מיושן. ראו כיצד נתוני אינטגרציה הופכים לאותות.

​
מה Living Security דורשת

גישה נדרשת לנקודות קצה: תפקיד נדרש: Tenant Admin או תפקיד שווה ערך עם גישה אל הגדרות ← Tools
אינטגרציה זו דורשת אסימון API מסוג v2, ולא אסימון v1. אסימוני v1 משתמשים באימות באמצעות פרמטר שאילתה ולא יעבדו מול נקודת הקצה של ה-API מסוג v2.

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

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

​
חלק א׳ — ב-Netskope

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

מעבר לניהול אסימוני REST API v2

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

יצירת אסימון חדש

  1. לחצו על New Token.
  2. הזינו שם תיאורי (לדוגמה, Living Security Platform).
  3. תחת הגישה לנקודות קצה, אפשרו גישה אל:
יש להעניק גישה לשתי נקודות הקצה. הן מזינות שני זרמים נפרדים — alerts ו- events — ואסימון המוגבל לאחת מהן בלבד עדיין מתחבר בהצלחה. הזרם התלוי בנקודת הקצה החסרה לא יחזיר דבר, ללא שגיאה שתסביר מדוע.
אלה נקודות הקצה היחידות ש-Living Security דורשת. הענקת גישה לאלה בלבד עומדת בעקרון ההרשאה המינימלית.
  1. לחצו על שמור (או Generate Token).
3

העתקה ושמירה של האסימון

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

הגדרת רשימת היתרים של כתובות IP (אם רלוונטי)

אם בטננט Netskope שלכם מופעלת רשימת היתרים של כתובות IP, עליכם להוסיף את טווחי כתובות ה-IP של היציאה של Living Security.
  1. במסוף הניהול של Netskope, עברו אל הגדרות ← ניהול ← IP Allowlist.
  2. אם רשימת ההיתרים של כתובות IP מופעלת, הוסיפו כל כתובת IP של יציאה של Living Security לרשימת Custom IP.
אם רשימת ההיתרים של כתובות IP מופעלת, תיבת הדו-שיח של החיבור תצליח, אך סנכרוני הנתונים ייכשלו עם 401 Unauthorized עד שייווספו כתובות ה-IP הנכונות.
5

זיהוי תת-הדומיין של הטננט

תת-הדומיין של הטננט הוא התחילית של כתובת ה-URL של מסוף הניהול של Netskope.אם כתובת ה-URL של המסוף שלכם היא https://acme.goskope.com, תת-הדומיין שלכם הוא acme.הזינו את תת-הדומיין החשוף בלבד — ללא https://, ללא .goskope.com, וללא לוכסן בסוף.
תיבת הדו-שיח של החיבור מקבלת מספר צורות קלט (תת-דומיין חשוף, שם מארח מלא או כתובת URL מלאה) ומבצעת נרמול אוטומטי. עם זאת, מומלץ להזין את תת-הדומיין החשוף.

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

בעל התוכנית מבצע שלב זה, או מנהל המערכת אם נעשה שימוש בהגדרה מואצלת.
כעת אתם מחוברים ל-Netskope (v2 API).

​
פתרון בעיות

סיבות נפוצות:
  1. האסימון בוטל או שתוקפו פג — צרו אסימון חדש
  2. שימוש באסימון v1 — אסימוני v1 מבצעים אימות באמצעות פרמטר שאילתה ולא יעבדו מול נקודות קצה של v2. צרו אסימון v2 חדש דרך הגדרות ← Tools ← REST API v2
  3. רשימת היתרים של כתובות IP חוסמת בקשות — אם בטננט שלכם מופעלת רשימת היתרים של כתובות IP, ודאו ששכל ארבע כתובות ה-IP של היציאה של Living Security נמצאות ברשימת ההיתרים
האסימון נוצר ללא גישה אל /api/v2/events/data/alert או אל /api/v2/events/data/page. לא ניתן לשנות את הרשאות נקודות הקצה של האסימון לאחר יצירתו — צרו אסימון חדש עם הרשאת קריאה לשתיהן והתחברו מחדש.
באסימון חסרה אחת משתי נקודות הקצה הנדרשות. אסימון המוגבל ל- /api/v2/events/data/alert בלבד או ל-/api/v2/events/data/page בלבד עדיין מתחבר, והזרם התלוי בנקודת הקצה החסרה נשאר ריק ללא כל הודעה.לא ניתן לשנות את הרשאות נקודות הקצה לאחר יצירת האסימון — צרו אסימון חדש עם הרשאת קריאה לשתיהן, ולאחר מכן התחברו מחדש.
אם רשימת ההיתרים של כתובות IP מופעלת, ייתכן שכתובות ה-IP של היציאה של Living Security השתנו. עיינו ב-הגדרת כתובות IP של יציאה לאינטגרציות ועדכנו את רשימת Custom IP בהתאם.
אסימוני v1 ו-v2 משתמשים במנגנוני אימות שונים:
  • v1: פרמטר שאילתה (token=...)
  • v2: כותרת (Netskope-Api-Token: ...)
Living Security משתמשת באימות v2. צרו אסימון חדש דרך הגדרות ← Tools ← REST API v2 (ולא דרך דף האסימון הישן של v1).