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

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

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

כדי להשתמש בשילוב, צריך API Root, מזהה לקוח וסוד לקוח.

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

ההרשאות וההיקפים הנדרשים לחשבון השירות

מוודאים שלחשבון השירות של Wiz יש את היקפי ההרשאות המתאימים ל-API בשביל הפעולות שרוצים להריץ ב-Google SecOps.

פעולות קריאה ושאילתות

פעולה או מטרה בשימוש על ידי ההרשאות או ההיקפים הנדרשים
בדיקת הקישוריות פעולת פינג read:issues
קבלת פרטי הבעיה פעולה לקבלת פרטי הבעיה read:issues
read:posture_issues
read:threat_issues
read:comments
רשימת הממצאים של נקודות חולשה במשאבים פעולה להצגת רשימה של ממצאים לגבי נקודות חולשה במשאבים read:vulnerabilities
קבלת ניתוח של Blue Agent Get Blue Agent Analysis Action read:threat_issues

פעולות כתיבה ושינוי (מוטציות)

פעולה או מטרה בשימוש על ידי ההרשאות או ההיקפים הנדרשים
פתיחה מחדש של הבעיה פעולה לפתיחה מחדש של בעיה write:issue_status
update:posture_issue_status
write:threat_issue_status
פתרון הבעיה פעולה לפתרון הבעיה write:threat_issue_status
write:threat_issues
התעלמות מהבעיה פעולה להתעלמות מהבעיה update:posture_issue_ignore
write:issue_ignore
הוספת תגובה לבעיה הוספת תגובה לפעולה בנושא write:issue_comments
write:threat_issue_comments
write:comments

פרמטרים של שילוב

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

פרמטר תיאור
API Root

חובה.

כתובת ה-URL של נקודת קצה ל-API של GraphQL לדייר ב-Wiz.

נקודת הקצה חייבת להיות בפורמט https://api.<region>.app.wiz.io/graphql (או https://api.<region>.app.wiz.us/graphql ל-Wiz for Gov), כאשר <region> מייצג את האזור של מרכז הנתונים של Wiz שהוקצה לכם (למשל us1,‏ us2,‏ eu1 או eu2).

כדי לקבל את כתובת ה-URL המדויקת של נקודת הקצה, עיינו בפרטי הדייר ב-Wiz. אל תשתמשו בכתובות URL אזוריות כלליות ללא מספר.

Authentication URL

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

כתובת ה-URL לאימות שמשמשת ליצירת טוקני גישה של OAuth. בסביבות מסחריות, משתמשים ב-https://auth.app.wiz.io. בסביבות Wiz for Gov (FedRAMP), משתמשים ב-https://auth.app.wiz.us.

ערך ברירת המחדל הוא https://auth.app.wiz.io.

Client ID

חובה.

מזהה הלקוח שמשויך לפרטי הכניסה שלכם ל-Wiz API.

Client Secret

חובה.

סוד הלקוח שמשויך לפרטי הכניסה שלכם ל-Wiz API.

Verify SSL

חובה.

אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של Wiz.

מופעלת כברירת מחדל.

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

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

פעולות

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

פינג

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

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

קלט של הפעולה

אין.

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

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

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

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

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

Successfully connected to the Wiz server with the provided connection parameters!

הפעולה בוצעה בהצלחה.
Failed to connect to the Wiz server! Error is ERROR_REASON

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

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

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

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

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

קבלת פרטי הבעיה

משתמשים בפעולה Get Issue Details כדי לקבל מידע על בעיה ספציפית ב-Wiz.

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

קלט של הפעולה

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

פרמטר תיאור
Issue ID

חובה.

המזהה הייחודי של הבעיה ב-Wiz שרוצים לאחזר או לבצע פעולה לגביה.

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

הפעולה Get Issue Details מספקת את הפלטים הבאים:

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

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

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}
הודעות פלט

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

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

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

הפעולה בוצעה בהצלחה.
Error executing action "Get Issue Details". Reason: ERROR_REASON

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

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

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

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

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

פתיחה מחדש של הבעיה

כדי לפתוח מחדש בעיה מסוימת ב-Wiz, משתמשים בפעולה Reopen Issue.

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

קלט של הפעולה

כדי לבצע את הפעולה Reopen Issue צריך להזין את הפרמטרים הבאים:

פרמטר תיאור
Issue ID

חובה.

המזהה הייחודי של הבעיה ב-Wiz שרוצים לאחזר או לעדכן.

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

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

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

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

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}
הודעות פלט

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

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

‫Successfully reopened issue with ID ISSUE_ID ב-Wiz.

הפעולה בוצעה בהצלחה.
Error executing action "Reopen Issue". Reason: ERROR_REASON

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

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

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

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

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

התעלמות מהבעיה

כדי להתעלם מבעיה מסוימת ב-Wiz, משתמשים בפעולה Ignore Issue.

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

קלט של הפעולה

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

פרמטר תיאור
Issue ID

חובה.

המזהה הייחודי של הבעיה ב-Wiz.

Resolution Reason

חובה.

הסיבה לפתרון הבעיה.

הערכים האפשריים הם:

  • False Positive
  • Exception
  • Won't Fix~

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

Resolution Note

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

הערה שמספקת הקשר נוסף לפתרון הבעיה.

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

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

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

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

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}
הודעות פלט

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

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

‫Successfully ignored issue with ID ISSUE_ID ב-Wiz.

הפעולה בוצעה בהצלחה.
Error executing action "Ignore Issue". Reason: ERROR_REASON

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

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

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

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

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

פתרון הבעיה

אתם יכולים להשתמש בפעולה Resolve Issue כדי לפתור בעיה ספציפית ב-Wiz.

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

קלט של הפעולה

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

פרמטר תיאור
Issue ID

חובה.

המזהה הייחודי של הבעיה ב-Wiz.

Resolution Reason

חובה.

הסיבה לפתרון הבעיה.

הערכים האפשריים הם:

  • Malicious Threat
  • Not Malicious Threat
  • Security Test Threat
  • Planned Action Threat
  • Inconclusive Threat

ערך ברירת המחדל הוא Not Malicious Threat.

Resolution Note

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

הערה שמספקת הקשר נוסף לגבי הפתרון.

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

הפעולה Resolve Issue מספקת את הפלט הבא:

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

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

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}
הודעות פלט

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

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

‫Successfully resolved issue with ID ISSUE_ID ב-Wiz.

הפעולה בוצעה בהצלחה.
Error executing action "Resolve Issue". Reason: ERROR_REASON

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

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

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

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

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

הוספת תגובה לבעיה

משתמשים בפעולה Add Comment To Issue כדי להוסיף תגובה לבעיה ספציפית ב-Wiz.

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

קלט של הפעולה

הפעולה Add Comment To Issue דורשת את הפרמטרים הבאים:

פרמטר תיאור
Issue ID

חובה.

המזהה הייחודי של הבעיה ב-Wiz.

Comment

חובה.

הטקסט של התגובה שרוצים להוסיף לבעיה.

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

הפעולה Add Comment To Issue מספקת את הפלטים הבאים:

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

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

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
הודעות פלט

הפעולה Add Comment To Issue יכולה להחזיר את הודעות הפלט הבאות:

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

‫Successfully added a comment to the issue with ID ISSUE_ID ב-Wiz.

הפעולה בוצעה בהצלחה.
Error executing action "Add Comment To Issue". Reason: ERROR_REASON

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

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

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

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Add Comment To Issue:

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

קבלת ניתוח נתונים של Blue Agent

משתמשים בפעולה Get Blue Agent Analysis כדי לקבל פרטי ניתוח מהסוכן הכחול של Wiz לגבי איום מסוים.

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

קלט של הפעולה

הפעולה Get Blue Agent Analysis דורשת את הפרמטרים הבאים:

פרמטר תיאור
Threat ID

חובה.

המזהה הייחודי של האיום ב-Wiz.

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

הפעולה Get Blue Agent Analysis מספקת את הפלטים הבאים:

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

בדוגמה הבאה מוצג פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Get Blue Agent Analysis:

{
  "id": "threat-12345",
  "threatType": "MALWARE_DETECTION",
  "status": "COMPLETED",
  "analysis": {
    "summary": "Blue Agent analysis details",
    "riskScore": "HIGH"
  }
}
הודעות פלט

הפעולה Get Blue Agent Analysis יכולה להחזיר את הודעות הפלט הבאות:

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

‫Successfully retrieved blue agent analysis for threat ID THREAT_ID ב-Wiz.

הפעולה בוצעה בהצלחה.
Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON

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

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

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

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה Get Blue Agent Analysis:

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

תעסוקה

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

משימת סנכרון דו-כיוונית של Wiz ו-Google SecOps

כדי לשמור על סנכרון רציף בין האיומים ב-Wiz לבין בקשות התמיכה ב-Google SecOps, משתמשים ב-Wiz and Google SecOps Bi-directional Sync Job.

פרמטרים של משימות

כדי להפעיל את Wiz and Google SecOps Bi-directional Sync Job, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Environment Name

חובה.

שם הסביבה שבה רוצים לסנכרן את בקשות התמיכה.

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

Wiz API Root

חובה.

נקודת קצה ל-API של Wiz GraphQL לדייר שלכם.

נקודת הקצה חייבת להיות בפורמט https://api.<region>.app.wiz.io/graphql (או https://api.<region>.app.wiz.us/graphql ל-Wiz for Gov), כאשר <region> מייצג את האזור של מרכז הנתונים של Wiz שהוקצה לכם (למשל us1,‏ us2,‏ eu1 או eu2).

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

ערך ברירת המחדל של הפלייסהולדר הוא https://api.<region>.app.wiz.io/graphql. מחליפים את <region> באזור של מרכז הנתונים של Wiz שהוקצה לכם.

Wiz Authentication URL

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

כתובת ה-URL לאימות שמשמשת ליצירת טוקני גישה של OAuth. בסביבות מסחריות, משתמשים ב-https://auth.app.wiz.io. בסביבות Wiz for Gov (FedRAMP), משתמשים ב-https://auth.app.wiz.us.

ערך ברירת המחדל הוא https://auth.app.wiz.io.

Wiz Client ID

חובה.

מזהה הלקוח של חשבון השירות של Wiz API.

Wiz Client Secret

חובה.

סוד הלקוח של חשבון השירות של Wiz API.

Max Hours Backwards

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

מספר השעות לפני האיטרציה הראשונית של המשימה לאחזור פניות מעודכנות (טווח: 1 עד 720, ברירת מחדל: 24). הפרמטר הזה רלוונטי להרצה הראשונה של המשימה, או כגיבוי אם חותמת הזמן של ההרצה האחרונה מאופסת.

Verify SSL

חובה.

אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Wiz.

האפשרות הזו מסומנת כברירת מחדל.

Fields to sync

חובה.

רשימה מופרדת בפסיקים של פריטים שקובעים אילו שדות צריך לסנכרן. רק השדות שמופיעים כאן במפורש יסונכרנו. הערכים האפשריים הם: Status,‏ Comments,‏ Product Link,‏ Severity.

ערך ברירת המחדל הוא Status, Comments, Product Link, Severity.

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