‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Netskope

במדריך הזה מוסבר איך לשלב את Netskope עם Google Security Operations ‏(Google SecOps).

תרחישים לדוגמה

שילוב Netskope עם Google SecOps יכול לעזור לכם לפתור את הבעיות הבאות:

חקירה וחסימה של כתובות URL שמשמשות לפישינג: כשמקבלים התראה על כתובת URL שמשמשת לפישינג, משתמשים ביכולות של Google SecOps כדי לשלוח שאילתה לפלטפורמת האבטחה בענן של Netskope, ולקבל מידע על המוניטין והסיווג של כתובת ה-URL. אם כתובת ה-URL מאומתת כזדונית, Netskope יכולה לחסום אותה באופן אוטומטי ברשת של הארגון.
ניתוח והכלה של תוכנות זדוניות: משתמשים ביכולות של Google SecOps כדי לשלוח דוגמה של תוכנה זדונית ל-Netskope לצורך ניתוח דינמי. על סמך תוצאות הניתוח, Netskope יכולה לאכוף כללי מדיניות כדי להכניס להסגר מכשירים נגועים או לחסום תקשורת נוספת עם שרתי Command and Control זדוניים.
תיקון חשבון שנפרץ: משתמשים ביכולות של Google SecOps כדי לזהות ניסיונות התחברות או פעילויות חשודות, ולאכוף פעולות כמו איפוס סיסמאות, אתגרי אימות רב-שלבי או השעיה של חשבון.
בדיקת נקודות חולשה ותיקון: משתמשים ביכולות של Google SecOps כדי לקבל התראות על נקודות חולשה שזוהו באפליקציות בענן.
אוטומציה של תגובה לאירועים: אתם יכולים להשתמש ביכולות של Google SecOps כדי לאסוף מידע על ההקשר של האירוע, כמו פעילות המשתמש, תנועה ברשת ויומני גישה לנתונים, ולהפוך משימות של תגובה לאירועים לאוטומטיות, כמו בידוד מערכות שהושפעו, חסימת תנועה זדונית והודעה לבעלי העניין הרלוונטיים.
העשרת מודיעין איומי סייבר: שימוש ביכולות של Google SecOps כדי לשלב פידים של מודיעין איומי סייבר מ-Netskope, ולהעשיר את התראות האבטחה בהקשר נוסף.

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

לפני שמגדירים את השילוב של Netskope ב-Google SecOps, צריך לקבל פרטי כניסה ספציפיים מהדייר (tenant) של Netskope. השילוב הזה תומך בשתי שיטות אימות, בהתאם לגרסת ה-API שבה משתמשות הפעולות שלכם.

בפורטל הידע של Netskope מוסבר איך למצוא את ההגדרות האלה בפלטפורמה של Netskope.

‫API בארכיטקטורת REST V1 (גרסה קודמת)

השיטה הזו נדרשת לפעולות שמשתמשות ב-V1 API. כדי להשתמש בשיטה הזו, צריך לקבל אסימון API (שנקרא גם מפתח API). הוראות ליצירת טוקן מופיעות במאמר Netskope API בארכיטקטורת REST v1 Overview.

‫API בארכיטקטורת REST V2 ‏ (OAuth 2.0)

השיטה הזו נדרשת לפעולות שמשתמשות באופן בלעדי ב-V2 API (רשימת התראות, רשימת אירועים, הוספת ישויות לרשימת כתובות URL ופריסת שינויים ברשימת כתובות URL) ולפעולות שבהן נבחר הפרמטר Use V2 API.

כדי לאמת באמצעות V2 API, צריך לקבל את פרטי הכניסה הבאים מהדייר ב-Netskope (מוגדר בקטע Settings > Tools > API בארכיטקטורת REST v2 או באמצעות חשבון שירות בקטע Settings > ניהול > אדמינים ותפקידים לדיירים שמשתמשים ב-RBAC v3):

מזהה לקוח: נוצר כשיוצרים לקוח OAuth 2.0 חדש או חשבון שירות חדש.
סוד לקוח: נוצר עם מזהה הלקוח.

כדי להגדיר לקוח OAuth 2.0 ולהקצות תפקידים, קראו את המאמרים REST API V2 Overview ו-Administrators RBAC V3 של Netskope.

נקודות קצה והיקפי הרשאות נדרשים ב-API בארכיטקטורת REST V2

כשמגדירים את לקוח OAuth 2.0 או את תפקיד חשבון השירות RBAC v3 ב-Netskope, צריך להעניק את ההיקפים (הרשאות) המינימליים הנדרשים לפעולות שמתכננים להריץ:

פעולה	נקודת הקצה הנדרשת של API בארכיטקטורת REST V2	היקף ההרשאות הנדרש (הרשאה)
פינג (כשמשתמשים ב-API בגרסה 2) רשימת התראות	`/api/v2/events/data/alert`	`Read`
אירועי רשימה	`/api/v2/events/data/page` `/api/v2/events/data/application` `/api/v2/events/data/audit` `/api/v2/events/data/infrastructure` אם לא מציינים את הפרמטר `Type` בפעולה הזו, צריך לתת ל-`Read` גישה לכל ארבע נקודות הקצה.	`Read`
הצגת רשימת לקוחות (כאשר `Use V2 API` מופעל)	`/api/v2/events/datasearch/clientstatus`	`Read`
הצגת רשימה של קבצים בהסגר (כשהאפשרות `Use V2 API` מופעלת)	`/api/v2/casbapi/incidents/quarantine`	`Read`
הורדת קובץ (כשהאפשרות `Use V2 API` מופעלת)	`/api/v2/casbapi/incidents/quarantine` `/api/v2/casbapi/apps/{app}/instances/{instance}/files/{file_id}/content`	`Read`
הרשאת קובץ (כשהאפשרות `Use V2 API` מופעלת)	`/api/v2/casbapi/incidents/quarantine/{file_id}/restore`	`Read+Write`
חסימת הקובץ (כשהאפשרות `Use V2 API` מופעלת)	`/api/v2/casbapi/incidents/quarantine/{file_id}/block`	`Read+Write`
הוספת ישויות לרשימת כתובות ה-URL	`/api/v2/policy/urllist` (`Read`) `/api/v2/policy/urllist/{id}/append` (`Read+Write`) `/api/v2/policy/urllist/deploy` (`Read+Write`, נדרש כש-`Deploy URL List Changes` מופעל)	`Read+Write`
פריסת השינויים ברשימת כתובות ה-URL	`/api/v2/policy/urllist/deploy`	`Read+Write`

הגדרות רשת

כדי לקבוע את הגדרות הרשת לשילוב, אפשר להיעזר בטבלה הבאה:

תפקיד	יציאת ברירת המחדל	כיוון	פרוטוקול
API	443	להעברת נתונים	HTTPS

שילוב של Netskope עם Google SecOps

כדי לשלב את Netskope, צריך להגדיר את הפרמטרים הבאים:

פרמטר	תיאור
`Api Root`	חובה. שורש ה-API של המכונה של Netskope.
`Api Key`	זה שינוי אופציונלי. ערך אסימון ה-API שהתקבל ממסוף Netskope, שמשמש לאימות פעולות באמצעות V1 API.
`Client ID`	זה שינוי אופציונלי. מזהה הלקוח שמשמש לאימות של V2 API ‏ (OAuth 2.0). הפרמטר הזה נדרש לפעולות שמשתמשות ב-API בגרסה 2.
`Client Secret`	זה שינוי אופציונלי. סוד הלקוח שמשמש לאימות של V2 API ‏ (OAuth 2.0). הפרמטר הזה נדרש לפעולות שמשתמשות ב-API בגרסה 2.
`Verify SSL`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של Netskope.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

הוספת ישויות לרשימת כתובות ה-URL

משתמשים בפעולה Add Entities To URL List כדי להוסיף כתובות URL, דומיינים או כתובות IP חדשים לרשימת כתובות URL קיימת ב-Netskope.

הפעולה הזו פועלת בישויות הבאות של Google SecOps:

Domain
IP Address
URL

קלט של הפעולה

הפעולה של Netskope דורשת את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`URL List Name`	חובה. השם של רשימת כתובות ה-URL הקיימת של Netskope שרוצים לעדכן (למשל, `Allowed URLs`).
`Entries`	זה שינוי אופציונלי. רשימה מופרדת בפסיקים של כתובות URL, דומיינים או כתובות IP שרוצים להוסיף לרשימה. הפעולה גם מעבדת באופן אוטומטי ישויות מסוג `URL`, `Domain` ו-`IP Address` שמצורפות לבקשה.
`Deploy URL List Changes`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מפעילה פריסה גלובלית של כל השינויים בהמתנה בכל רשימת כתובות ה-URL בדייר (לא רק ברשימה שמתעדכנת).

URL List Name

חובה.

השם של רשימת כתובות ה-URL הקיימת של Netskope שרוצים לעדכן (למשל, Allowed URLs).

Entries

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של כתובות URL, דומיינים או כתובות IP שרוצים להוסיף לרשימה.

הפעולה גם מעבדת באופן אוטומטי ישויות מסוג URL, Domain ו-IP Address שמצורפות לבקשה.

Deploy URL List Changes

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, הפעולה מפעילה פריסה גלובלית של כל השינויים בהמתנה בכל רשימת כתובות ה-URL בדייר (לא רק ברשימה שמתעדכנת).

ערכי פלט של פעולות

הפעולה Netskope מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	יש גישה
הודעות פלט	יש גישה
תוצאת הסקריפט	יש גישה

תוצאת JSON

הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Netskope:

{
  "added_entities": [
    "https://aistudio.google.com/prompts",
    "https://docs.google.com/"
  ],
  "failed_entities": [
    "not_real_url",
    10500
  ],
  "url_list_name": "Allowed URL List",
  "modify_by": "SOAR_API2",
  "modify_time": "2026-02-26T15:28:07.000Z",
  "pending": 1
}

הודעות פלט

הפעולה Netskope יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

הודעת פלט	תיאור ההודעה
`Successfully added the following entities to the URL_LIST_NAME list in Netskope: ADDED_ENTITIES. Changes are pending deployment.` `Action wasn't able to add the following entities to the URL_LIST_NAME list in Netskope: ENTITIES.` `None of the provided entities were added to the URL List URL_LIST_NAME in Netskope.`	הפעולה בוצעה בהצלחה.
`Error executing action. Reason: ERROR_REASON`	הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Successfully added the following entities to the URL_LIST_NAME list in Netskope: ADDED_ENTITIES. Changes are pending deployment.

Action wasn't able to add the following entities to the URL_LIST_NAME list in Netskope: ENTITIES.

None of the provided entities were added to the URL List URL_LIST_NAME in Netskope.

הפעולה בוצעה בהצלחה.

Error executing action. Reason:
     ERROR_REASON

הפעולה נכשלה.

בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה Netskope:

שם תוצאת הסקריפט	ערך
`is_success`	`true` או `false`

אישור הקובץ

כדי לאשר קובץ שהועבר להסגר, משתמשים בפעולה אישור הקובץ.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

הפעולה אישור הקובץ דורשת את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`File ID`	חובה מזהה הקובץ שרוצים לאשר.
`Quarantine Profile ID`	אופציונלי המזהה של פרופיל ההסגר שמשויך לקובץ. הערה: הפרמטר הזה נדרש ב-V1 API.
`Use V2 API`	אופציונלי אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1. לשם כך נדרשים פרטי כניסה תקינים ל-V2 API. הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים `Client ID` ו-`Client Secret` תקינים.

File ID

חובה

מזהה הקובץ שרוצים לאשר.

Quarantine Profile ID

אופציונלי

המזהה של פרופיל ההסגר שמשויך לקובץ.

Use V2 API

אופציונלי

אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1.

לשם כך נדרשים פרטי כניסה תקינים ל-V2 API.

הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים Client ID ו-Client Secret תקינים.

ערכי פלט של פעולות

הפעולה אישור הקובץ מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה אישור הקובץ:

שם תוצאת הסקריפט	ערך
`is_success`	`True` או `False`

חסימת הקובץ

כדי לחסום קובץ שבהסגר, משתמשים בפעולה חסימת הקובץ.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

הפעולה חסימת קובץ דורשת את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`File ID`	חובה המזהה של הקובץ שרוצים לחסום ב-Netskope.
`Quarantine Profile ID`	אופציונלי המזהה של פרופיל ההסגר שמשויך לקובץ. הערה: הפרמטר הזה נדרש ב-V1 API.
`Use V2 API`	אופציונלי אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1. לשם כך נדרשים פרטי כניסה תקינים ל-V2 API. הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים `Client ID` ו-`Client Secret` תקינים.

File ID

חובה

המזהה של הקובץ שרוצים לחסום ב-Netskope.

Quarantine Profile ID

אופציונלי

המזהה של פרופיל ההסגר שמשויך לקובץ.

Use V2 API

אופציונלי

אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1.

לשם כך נדרשים פרטי כניסה תקינים ל-V2 API.

הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים Client ID ו-Client Secret תקינים.

ערכי פלט של פעולות

הפעולה חסימת קובץ מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה חסימת קובץ:

שם תוצאת הסקריפט	ערך
`is_success`	`True` או `False`

פריסת שינויים ברשימת כתובות ה-URL

כדי להעביר הגדרות בהמתנה למנוע המדיניות הפעיל, משתמשים בפעולה Deploy URL List Changes. כך מוודאים שכל העדכונים בשלבי ההכנה מוחלים ונאכפים ברשימות של כתובות ה-URL.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

אין.

ערכי פלט של פעולות

הפעולה Deploy URL List Changes (פריסת שינויים ברשימת כתובות ה-URL) מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
הודעות פלט	יש גישה
תוצאת הסקריפט	יש גישה

הודעות פלט

הפעולה Deploy URL List Changes יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

הודעת פלט	תיאור ההודעה
`Successfully deployed pending Netskope policy changes.`	הפעולה בוצעה בהצלחה.
`Error executing action. Reason: ERROR_REASON`	הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Successfully deployed pending Netskope policy changes.

הפעולה בוצעה בהצלחה.

Error executing action. Reason:
     ERROR_REASON

הפעולה נכשלה.

בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Deploy URL List Changes:

שם תוצאת הסקריפט	ערך
`is_success`	`true` או `false`

הורדת הקובץ

כדי להוריד קובץ שבהסגר, משתמשים בפעולה הורדת הקובץ.

הפעולה הזו פועלת בישות IP Address של Google SecOps.

קלט של הפעולה

הפעולה הורדת קובץ דורשת את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`File ID`	חובה המזהה של הקובץ שרוצים להוריד מההסגר.
`Quarantine Profile ID`	אופציונלי המזהה של פרופיל ההסגר שמשויך לקובץ. הערה: הפרמטר הזה נדרש ב-V1 API.
`Use V2 API`	אופציונלי אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1. לשם כך נדרשים פרטי כניסה תקינים ל-V2 API. כשמפעילים את הפרמטר הזה, חלות הדרישות והשינויים הבאים: אימות: נדרשת תמיכה ב-OAuth 2.0. צריך לוודא שבהגדרות השילוב מוגדרים `Client ID` ו-`Client Secret` תקינים. לוגיקת אחסון: הפעלת הפרמטר הזה מעבירה את המקור מאחסון קלאסי לאחסון בדור הבא.

File ID

חובה

המזהה של הקובץ שרוצים להוריד מההסגר.

Quarantine Profile ID

אופציונלי

המזהה של פרופיל ההסגר שמשויך לקובץ.

Use V2 API

אופציונלי

אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1.

לשם כך נדרשים פרטי כניסה תקינים ל-V2 API.

כשמפעילים את הפרמטר הזה, חלות הדרישות והשינויים הבאים:

אימות: נדרשת תמיכה ב-OAuth 2.0. צריך לוודא שבהגדרות השילוב מוגדרים Client ID ו-Client Secret תקינים.
לוגיקת אחסון: הפעלת הפרמטר הזה מעבירה את המקור מאחסון קלאסי לאחסון בדור הבא.

ערכי פלט של פעולות

הפעולה הורדת קובץ מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הורדת קובץ:

שם תוצאת הסקריפט	ערך
`is_success`	`True` או `False`

רשימת התראות

משתמשים בפעולה הצגת רשימת התראות כדי להציג את רשימת ההתראות.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

הפעולה List Alerts דורשת את הפרמטרים הבאים:

פרמטר	תיאור
`Query`	אופציונלי שאילתה לסינון האירועים של האפליקציה בענן במסד הנתונים של ההתראות.
`Type`	אופציונלי סוג ההתראות שלפיו רוצים לסנן. הערכים האפשריים הם: `Anomaly` `Compromised Credential` `Policy` `Legal Hold` `Malsite` `Malware` `DLP` `Watchlist` `Quarantine` `Remediation`
`Time Period`	אופציונלי תקופת הזמן באלפיות השנייה לפני הזמן הנוכחי שבה מחפשים התראות. הערכים האפשריים הם `3600`,‏ `86400`,‏ `604800` ו-`2592000`.
`Start Time`	אופציונלי שעת התחלה לסינון התראות עם חותמות זמן שמאוחרות יותר מראשית זמן יוניקס (Unix epoch) שצוינה. צריך להשתמש בפרמטר הזה רק אם לא הגדרתם את הפרמטר `Time Period`.
`End Time`	אופציונלי שעת סיום לסינון התראות עם חותמות זמן שמוקדמות יותר מראשית זמן יוניקס (Unix epoch) שצוינה. צריך להשתמש בפרמטר הזה רק אם לא הגדרתם את הפרמטר `Time Period`.
`Is Acknowledged`	אופציונלי אם בוחרים באפשרות הזו, השילוב מסנן התראות שסומנו כ"טופלו". האפשרות הזו לא מסומנת כברירת מחדל.
`Limit`	אופציונלי מספר התוצאות שיוחזרו. ערך ברירת המחדל הוא `100`.

ערכי פלט של פעולות

הפעולה List Alerts מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	יש גישה
הודעות פלט	יש גישה
תוצאת הסקריפט	יש גישה

תוצאת JSON

הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Alerts:

[
    {
        "dstip": "192.0.2.1",
        "app": "Amazon Web Services",
        "profile_id": "ID",
        "device": "iPad",
        "shared_credential_user": "example@example.com",
        "app_session_id": 2961859388,
        "dst_location": "Ashburn",
        "dst_region": "Virginia",
        "policy": "Copy prohibited",
        "page_id": 380765822,
        "object_type": "File",
        "dst_latitude": 39.0481,
        "timestamp": 1548603047,
        "src_region": "California",
        "from_user": "user@example.com",
        "src_location": "San Luis Obispo",
        "traffic_type": "CloudApp",
        "appcategory": "IaaS/PaaS",
        "src_latitude": 35.2635,
        "count": 2,
        "type": "anomaly",
        "risk_level_id": 2,
        "activity": "Upload",
        "userip": "203.0.113.1",
        "src_longitude": -120.6509,
        "browser": "Safari",
        "alert_type": "anomaly",
        "event_type": "user_shared_credentials",
        "_insertion_epoch_timestamp": 1548601562,
        "site": "Amazon Web Services",
        "id": 3561,
        "category": "IaaS/PaaS",
        "orig_ty": "nspolicy",
        "dst_country": "US",
        "src_zipcode": "93401",
        "cci": 94,
        "ur_normalized": "user@example.com",
        "object": "quarterly_report.pdf",
        "organization_unit": "",
        "acked": "false",
        "dst_longitude": -77.4728,
        "alert": "yes",
        "user": "user@example.com",
        "userkey": "user@example.com",
        "srcip": "7198.51.100.1",
        "org": "example.com",
        "src_country": "US",
        "bin_timestamp": 1548633600,
        "dst_zipcode": "20149",
        "url": "http://aws.amazon.com/",
        "sv": "unknown",
        "ccl": "excellent",
        "alert_name": "user_shared_credentials",
        "risk_level": "high",
        "_mladc": ["ur"],
        "threshold_time": 86400,
        "_id": "cadee4a8488b3e139b084134",
        "os": "iOS 6"
    }
]

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה הצגת רשימת התראות:

שם תוצאת הסקריפט	ערך
`alerts`	`ALERT_LIST`

רשימת לקוחות

משתמשים בפעולה List Clients כדי להציג רשימה של לקוחות.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

הפעולה List Clients דורשת את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`Query`	אופציונלי מסנן את הלקוחות שאוחזרו ממסד הנתונים.
`Limit`	אופציונלי מגבילה את מספר הלקוחות שהפעולה מחזירה. ערך ברירת המחדל הוא `25`.
`Use V2 API`	אופציונלי אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1. לשם כך נדרשים פרטי כניסה תקינים ל-V2 API. הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים `Client ID` ו-`Client Secret` תקינים.

Query

אופציונלי

מסנן את הלקוחות שאוחזרו ממסד הנתונים.

Limit

אופציונלי

מגבילה את מספר הלקוחות שהפעולה מחזירה.

ערך ברירת המחדל הוא 25.

Use V2 API

אופציונלי

אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1.

לשם כך נדרשים פרטי כניסה תקינים ל-V2 API.

הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים Client ID ו-Client Secret תקינים.

ערכי פלט של פעולות

הפעולה List Clients מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	יש גישה
תוצאת הסקריפט	יש גישה

תוצאת JSON

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה List Clients:

[
       {
         "client_install_time": 1532040251,
         "users":
        [
            {
                "heartbeat_status_since": 1532040385,
                "user_added_time": 1532040167,
                "last_event":
                {
                    "status": "Enabled",
                    "timestamp": 1548578307,
                    "event": "Tunnel Up",
                    "actor": "System"
                },
                "device_classification_status": "Not Configured",
                "username": "user@example.com",
                "user_source": "Manual",
                "userkey": "K00fuSXl8yMIqgdg",
                "_id": "ID",
                "heartbeat_status": "Active"
            }],
        "last_event":
        {
            "status": "Enabled",
            "timestamp": 1548578307,
            "event": "Tunnel Up",
            "actor": "System"
        },
        "host_info":
        {
            "device_model": "VMware Virtual Platform",
            "os": "Windows",
            "hostname": "HOSTNAME",
            "device_make": "VMware, Inc.",
            "os_version": "10.0"
        },
        "client_version": "1.1.1.1",
        "_id": "ID",
        "device_id": "DEVICE_ID"
    }
]

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט התוצאות של הסקריפט כשמשתמשים בפעולה List Clients:

שם תוצאת הסקריפט	ערך
`clients`	`CLIENT_LIST`

הצגת רשימת אירועים

משתמשים בפעולה הצגת רשימת אירועים כדי להציג את רשימת האירועים.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

הפעולה הצגת רשימת אירועים דורשת את הפרמטרים הבאים:

פרמטר	תיאור
`Query`	אופציונלי שאילתה לסינון האירועים של האפליקציה בענן במסד הנתונים של האירועים.
`Type`	אופציונלי סוג ההתראות שלפיו רוצים לסנן. הערכים האפשריים הם: `page` `application` `audit` `infrastructure`
`Time Period`	אופציונלי תקופת הזמן באלפיות השנייה לפני הזמן הנוכחי שבה מחפשים אירועים. הערכים האפשריים הם: `3600`,‏ `86400`,‏ `604800` ו-`2592000`.
`Start Time`	אופציונלי שעת התחלה לסינון אירועים עם חותמות זמן שמאוחרות יותר מראשית זמן יוניקס (Unix epoch) שצוינה. צריך להשתמש בפרמטר הזה רק אם לא הגדרתם את הפרמטר `Time Period`.
`End Time`	אופציונלי שעת סיום לסינון אירועים עם חותמות זמן שמוקדמות יותר מראשית זמן יוניקס (Unix epoch) שצוינה. צריך להשתמש בפרמטר הזה רק אם לא הגדרתם את הפרמטר `Time Period`.
`Limit`	אופציונלי מספר התוצאות שיוחזרו. ערך ברירת המחדל הוא `100`.

ערכי פלט של פעולות

הפעולה List Events (הצגת רשימת אירועים) מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת JSON

הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה List Events:


    {
        "dstip": "192.0.2.64",
        "browser_session_id": 1066949788113471080,
        "srcip": "198.51.100.36",
        "app_session_id": 4502249472406092569,
        "os_version": "WindowsServer2016",
        "dst_region": "Virginia",
        "numbytes": 37480,
        "req_cnt": 18,
        "server_bytes": 8994,
        "page_id": 0,
        "page_duration": 867,
        "page_endtime": 1548577530,
        "dst_latitude": 39.0481,
        "timestamp": 1548576663,
        "src_region": "Oregon",
        "src_location": "Boardman",
        "ur_normalized": "user@example.com",
        "appcategory": "",
        "src_latitude": 45.8491,
        "count": 1,
        "bypass_traffic": "no",
        "type": "page",
        "userip": "203.0.113.253",
        "src_longitude": -119.7143,
        "page": "WebBackground",
        "browser": "",
        "domain": "WebBackground",
        "dst_location": "Ashburn",
        "_insertion_epoch_timestamp": 1548577621,
        "site": "WebBackground",
        "access_method": "Client",
        "browser_version": "",
        "category": "",
        "client_bytes": 28486,
        "user_generated": "no",
        "hostname": "IP-C0A84AC",
        "dst_country": "US",
        "resp_cnt": 18,
        "src_zipcode": "97818",
        "traffic_type": "Web",
        "http_transaction_count": 18,
        "organization_unit": "example.com/Users",
        "page_starttime": 1548576663,
        "dst_longitude": -77.4728,
        "user": "user@example.com",
        "userkey": "user@example.com",
        "device": "WindowsDevice",
        "src_country": "US",
        "dst_zipcode": "20149",
        "url": "WebBackground",
        "sv": "",
        "ccl": "unknown",
        "useragent": "RestSharp/192.0.2.0",
        "_id": "ID",
        "os": "WindowsServer2016"
    }
]

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הצגת רשימת אירועים:

שם תוצאת הסקריפט	ערך
`events`	`EVENT_LIST`

הצגת רשימה של קבצים בהסגר

כדי להציג רשימה של קבצים בהסגר, משתמשים בפעולה הצגת רשימה של קבצים בהסגר.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

כדי להשתמש בפעולה הצגת רשימה של קבצים בהסגר, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור

פרמטר	תיאור
`Start Time`	אופציונלי שעת התחלה להגבלת אירועים עם חותמות זמן שגדולות מהערך של הפרמטר הזה בפורמט Unix.
`End Time`	אופציונלי שעת סיום להגבלת אירועים עם חותמות זמן קטנות מהערך של הפרמטר הזה בפורמט Unix.
`Use V2 API`	אופציונלי אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1. לשם כך נדרשים פרטי כניסה תקינים ל-V2 API. הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים `Client ID` ו-`Client Secret` תקינים.

Start Time

אופציונלי

שעת התחלה להגבלת אירועים עם חותמות זמן שגדולות מהערך של הפרמטר הזה בפורמט Unix.

End Time

אופציונלי

שעת סיום להגבלת אירועים עם חותמות זמן קטנות מהערך של הפרמטר הזה בפורמט Unix.

Use V2 API

אופציונלי

אם בוחרים באפשרות הזו, הפעולה משתמשת בנקודת הקצה ל-API של Netskope בגרסה 2 במקום בגרסה 1.

לשם כך נדרשים פרטי כניסה תקינים ל-V2 API.

הפרמטר הזה דורש תמיכה ב-OAuth 2.0. מוודאים שבהגדרות השילוב מוגדרים Client ID ו-Client Secret תקינים.

ערכי פלט של פעולות

הפעולה הצגת רשימה של קבצים בהסגר מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה הצגת רשימה של קבצים בהסגר:

שם תוצאת הסקריפט	ערך
`files`	`FILE_LIST`

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Netskope.

הפעולה הזו פועלת בכל הישויות של Google SecOps.

קלט של הפעולה

אין.

ערכי פלט של פעולות

הפעולה פינג מספקת את הפלטים הבאים:

סוג הפלט של הפעולה	זמינות
חיבור לקיר של המארז	לא זמין
קישור ללוח הפניות	לא זמין
שולחן קונסולה צמוד לקיר	לא זמין
טבלת העשרה	לא זמין
תוצאת JSON	לא זמין
תוצאת הסקריפט	יש גישה

תוצאת הסקריפט

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

שם תוצאת הסקריפט	ערך
`is_success`	`True` או `False`

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.