שילוב של Wiz עם Google SecOps
במאמר הזה מוסבר איך לשלב את Wiz עם Google Security Operations (Google SecOps).
לפני שמתחילים
כדי להשתמש בשילוב, צריך API Root, מזהה לקוח וסוד לקוח.
למידע נוסף על יצירת פרטי הכניסה האלה, ראו הגדרות של חשבונות שירות.
ההרשאות וההיקפים הנדרשים לחשבון השירות
מוודאים שלחשבון השירות של Wiz יש את היקפי ההרשאות המתאימים ל-API בשביל הפעולות שרוצים להריץ ב-Google SecOps.
פעולות קריאה ושאילתות
| פעולה או מטרה | בשימוש על ידי | ההרשאות או ההיקפים הנדרשים |
|---|---|---|
| בדיקת הקישוריות | פעולת פינג | read:issues |
| קבלת פרטי הבעיה | פעולה לקבלת פרטי הבעיה | read:issuesread:posture_issuesread:threat_issuesread:comments |
| רשימת הממצאים של נקודות חולשה במשאבים | פעולה להצגת רשימה של ממצאים לגבי נקודות חולשה במשאבים | read:vulnerabilities |
| קבלת ניתוח של Blue Agent | Get Blue Agent Analysis Action | read:threat_issues |
פעולות כתיבה ושינוי (מוטציות)
| פעולה או מטרה | בשימוש על ידי | ההרשאות או ההיקפים הנדרשים |
|---|---|---|
| פתיחה מחדש של הבעיה | פעולה לפתיחה מחדש של בעיה | write:issue_statusupdate:posture_issue_statuswrite:threat_issue_status |
| פתרון הבעיה | פעולה לפתרון הבעיה | write:threat_issue_statuswrite:threat_issues |
| התעלמות מהבעיה | פעולה להתעלמות מהבעיה | update:posture_issue_ignorewrite:issue_ignore |
| הוספת תגובה לבעיה | הוספת תגובה לפעולה בנושא | write:issue_commentswrite:threat_issue_commentswrite:comments |
פרמטרים של שילוב
כדי לשלב את Wiz, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה. כתובת ה-URL של נקודת קצה ל-API של GraphQL לדייר ב-Wiz. נקודת הקצה חייבת להיות בפורמט כדי לקבל את כתובת ה-URL המדויקת של נקודת הקצה, עיינו בפרטי הדייר ב-Wiz. אל תשתמשו בכתובות URL אזוריות כלליות ללא מספר. |
Authentication URL |
זה שינוי אופציונלי. כתובת ה-URL לאימות שמשמשת ליצירת טוקני גישה של OAuth. בסביבות מסחריות, משתמשים ב- ערך ברירת המחדל הוא |
Client ID |
חובה. מזהה הלקוח שמשויך לפרטי הכניסה שלכם ל-Wiz API. |
Client Secret |
חובה. סוד הלקוח שמשויך לפרטי הכניסה שלכם ל-Wiz API. |
Verify SSL |
חובה. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של Wiz. מופעלת כברירת מחדל. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
פינג
משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Wiz.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
ערכי פלט של פעולות
הפעולה פינג מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט. | יש גישה |
הודעות פלט
הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 |
חובה. הסיבה לפתרון הבעיה. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Resolution Note |
זה שינוי אופציונלי. הערה שמספקת הקשר נוסף לפתרון הבעיה. |
ערכי פלט של פעולות
הפעולה התעלמות מהבעיה מספקת את הפלט הבא:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור ללוח הפניות | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Ignore Issue:
{
"id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
"note": "",
"status": "REJECTED",
"dueAt": null,
"resolutionReason": "FALSE_POSITIVE"
}
הודעות פלט
הפעולה Ignore Issue יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 |
חובה. הסיבה לפתרון הבעיה. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 |
חובה. שם הסביבה שבה רוצים לסנכרן את בקשות התמיכה. ערך ברירת המחדל הוא |
Wiz API Root |
חובה. נקודת קצה ל-API של Wiz GraphQL לדייר שלכם. נקודת הקצה חייבת להיות בפורמט כדי לקבל את כתובת ה-URL המדויקת של נקודת הקצה, עיינו בפרטי הדייר ב-Wiz. אל תשתמשו בכתובות URL אזוריות כלליות, ללא מספרים. ערך ברירת המחדל של הפלייסהולדר הוא |
Wiz Authentication URL |
זה שינוי אופציונלי. כתובת ה-URL לאימות שמשמשת ליצירת טוקני גישה של OAuth. בסביבות מסחריות, משתמשים ב- ערך ברירת המחדל הוא |
Wiz Client ID |
חובה. מזהה הלקוח של חשבון השירות של Wiz API. |
Wiz Client Secret |
חובה. סוד הלקוח של חשבון השירות של Wiz API. |
Max Hours Backwards |
זה שינוי אופציונלי. מספר השעות לפני האיטרציה הראשונית של המשימה לאחזור פניות מעודכנות (טווח: 1 עד 720, ברירת מחדל: 24). הפרמטר הזה רלוונטי להרצה הראשונה של המשימה, או כגיבוי אם חותמת הזמן של ההרצה האחרונה מאופסת. |
Verify SSL |
חובה. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Wiz. האפשרות הזו מסומנת כברירת מחדל. |
Fields to sync |
חובה. רשימה מופרדת בפסיקים של פריטים שקובעים אילו שדות צריך לסנכרן. רק השדות שמופיעים כאן במפורש יסונכרנו. הערכים האפשריים הם: ערך ברירת המחדל הוא
|
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.