Microsoft 365 Defender

במאמר הזה מוסבר איך לשלב את Microsoft Defender For XDR עם Google Security Operations.

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

שילוב של Microsoft Defender For XDR עם Google SecOps יכול לעזור לכם לפתור את תרחישי השימוש הבאים:

  • תגובה אוטומטית לאירוע: משתמשים ביכולות של Google SecOps כדי לבודד באופן אוטומטי את נקודת הקצה המושפעת ולהתחיל סריקה לאיתור פריצות נוספות.

  • חקירה וטיפול בפישינג: אתם יכולים להשתמש ביכולות של Google SecOps כדי לחלץ באופן אוטומטי מידע רלוונטי, כמו השולח, הנושא והקבצים המצורפים, ולהעשיר אותו בנתונים של מודיעין איומי סייבר.

  • ניהול נקודות חולשה: שימוש ביכולות של Google SecOps כדי להפוך את תהליכי העבודה של סריקת נקודות חולשה ותיקון שלהן לאוטומטיים.

  • דיווח על תאימות וביקורת: אתם יכולים להשתמש ביכולות של Google SecOps כדי לאסוף נתוני אבטחה מ-Microsoft Defender For XDR ולדווח עליהם באופן אוטומטי, וכך לפשט את ביקורות התאימות ולהוכיח עמידה בתקני אבטחה.

  • תעדוף ומיון של התראות: אתם יכולים להשתמש ביכולות של Google SecOps כדי לנתח התראות מ-Microsoft Defender For XDR ולתעדף אותן לפי חומרת הבעיה וההשפעה הפוטנציאלית שלה.

  • ניתוח אוטומטי של תוכנות זדוניות: שימוש ביכולות של Google SecOps כדי לשלוח באופן אוטומטי את הדגימה של תוכנה זדונית שזוהתה על ידי Microsoft 365 Defender לסביבת ארגז חול לצורך ניתוח דינמי.

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

לפני שמגדירים את השילוב בפלטפורמת Google SecOps, צריך לבצע את הפעולות הבאות:

  1. יוצרים את האפליקציה ב-Microsoft Entra.

  2. מגדירים את הרשאות ה-API לאפליקציה.

  3. יוצרים סוד לקוח.

יצירת האפליקציה ב-Microsoft Entra

כדי ליצור את האפליקציה ב-Microsoft Entra:

  1. נכנסים לפורטל Azure כאדמין של משתמשים או כאדמין של סיסמאות.

  2. בוחרים באפשרות Microsoft Entra ID.

  3. עוברים אל App registrations > New registration.

  4. מזינים את שם האפליקציה.

  5. לוחצים על הרשמה.

  6. שומרים את הערכים של Application (client) ID ו-Directory (tenant) ID כדי להשתמש בהם בהמשך, כשמגדירים את הפרמטרים של השילוב.

הגדרת ההרשאות של ה-API

כדי להגדיר את הרשאות ה-API לשילוב:

  1. בפורטל Azure, עוברים אל Manage > API Permissions > Add a permission.

  2. בחלון Request API permissions, בוחרים באפשרות APIs my organization uses.

  3. בוחרים באפשרות Microsoft Graph > Application permissions.

  4. בוחרים את ההרשאות הבאות:

    • SecurityAlert.Read.All
    • SecurityIncident.ReadWrite.All
  5. לוחצים על הוספת הרשאות.

  6. בחלון Request API permissions, בוחרים באפשרות APIs my organization uses.

  7. בוחרים באפשרות Microsoft Threat Protection > Application permissions.

  8. בוחרים את ההרשאה הבאה:

    • ThreatHunting.Read.All
  9. לוחצים על הוספת הרשאות.

  10. לוחצים על Grant admin consent for YOUR_ORGANIZATION_NAME.

    כשמופיעה תיבת הדו-שיח Grant admin consent confirmation, לוחצים על Yes.

יצירת סוד לקוח

כדי ליצור סוד לקוח:

  1. עוברים אל Certificates and secrets > New client secret.

  2. מזינים תיאור של סוד הלקוח ומגדירים את תאריך התפוגה שלו.

  3. לוחצים על הוספה.

  4. שומרים את הערך של סוד הלקוח (לא את מזהה הסוד) כדי להשתמש בו כערך הפרמטר Client Secret כשמגדירים את השילוב.

    הערך של סוד הלקוח מוצג רק פעם אחת.

שילוב של Microsoft Defender For XDR עם Google SecOps

כדי לשלב את Microsoft Defender For XDR, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Login API Root חובה

שורש ה-API להתחברות של המכונה של Microsoft Defender For XDR.

ערך ברירת המחדל הוא https://login.microsoftonline.com.

Graph API Root חובה

שורש ה-API של שירות Microsoft Graph.

ערך ברירת המחדל הוא https://graph.microsoft.com.

API Root חובה

שורש ה-API של המכונה של Microsoft Defender For XDR.

ערך ברירת המחדל הוא https://api.security.microsoft.com.

Tenant ID חובה

ערך ה-Microsoft Entra ID (מזהה הדייר) של חשבון Microsoft Entra ID.

Client ID חובה

ערך מזהה האפליקציה (הלקוח) של חשבון Microsoft Entra ID.

Client Secret חובה

ערך סוד הלקוח של האפליקציה ב-Microsoft Entra ID.

Verify SSL אופציונלי

אם בוחרים באפשרות הזו, השילוב מאמת שאישור ה-SSL לחיבור לשרת Microsoft Defender For XDR תקף.

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

הוראות להגדרת שילוב ב-Google SecOps מפורטות במאמר הגדרת שילובים.

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

פעולות

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

הוספת הערה לאירוע

משתמשים בפעולה Add Comment To Incident כדי להוסיף תגובה לאירוע ב-Microsoft Defender For XDR.

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

קלט של הפעולה

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

פרמטר תיאור
Incident ID חובה

המזהה של האירוע שאליו רוצים להוסיף את ההערה.

Comment חובה

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

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

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

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

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

הודעת פלט תיאור ההודעה
Successfully added comment to incident INCIDENT_ID in Microsoft Defender XDR. הפעולה בוצעה בהצלחה.
Error executing action "Add Comment To Incident". Reason: ERROR_REASON

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

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

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

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

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

הפעלת שאילתה בהתאמה אישית

משתמשים בפעולה Execute Custom Query כדי להריץ שאילתת איתור מותאמת אישית ב-Microsoft Defender For XDR.

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

קלט של הפעולה

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

פרמטר תיאור
Query חובה

השאילתה שצריך להריץ ב-Microsoft Defender For XDR כדי לסנן את התוצאות.

Time Frame אופציונלי

התקופה של תוצאות השאילתה.

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

  • Select One
  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom

אם נבחרה האפשרות Custom, צריך להגדיר את Start Time.

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

Start Time אופציונלי

שעת ההתחלה של תוצאות השאילתה בפורמט ISO 8601.

אם הפרמטר Time Frame מוגדר לערך Custom, חובה לכלול את הפרמטר הזה.

End Time אופציונלי

שעת הסיום של תוצאות השאילתה בפורמט ISO 8601.

אם לא צוין ערך והמדיניות Time Frame מוגדרת ל-Custom, הפעולה משתמשת בשעה הנוכחית.

Max Results To Return אופציונלי

מספר התוצאות המקסימלי שיוחזר מהשאילתה.

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

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

הפעולה Execute Custom Query מספקת את הפלטים הבאים:

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

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

[
  {
    "Timestamp": "2021-04-12T07:25:00Z",
    "AlertId": "fa7a318954-6c4c-eaab-yyy-yyyyyyyyyy",
    "Title": "CC_Sensitive information",
    "Category": "InitialAccess",
    "Severity": "Medium",
    "ServiceSource": "Microsoft Defender for Office 365",
    "DetectionSource": "Microsoft Defender for Office 365",
    "AttackTechniques": ""
  }
]
הודעות פלט

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

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

Successfully executed query "QUERY" in Microsoft 365 Defender.

No data was found for the query "QUERY" in Microsoft 365 Defender.

הפעולה בוצעה בהצלחה.
Error executing action "Execute Custom Query". Reason: ERROR_REASON

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

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

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

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

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

הרצת שאילתת ישות

משתמשים בפעולה Execute Entity Query כדי להריץ שאילתת איתור שמבוססת על ישויות ב-Microsoft Defender For XDR.

הפעולה הזו משתמשת במסנן where שמבוסס על ישויות.

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

  • IP Address
  • Host
  • User
  • Hash
  • URL

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

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

כשמשתמשים בפעולה Execute Query כדי לאחזר את ההתראות שקשורות לנקודת קצה, צריך להגדיר את הפורמט של הסעיף | where באופן הבא:

AlertInfo | where DeviceName == "Host-1" or IPAddress == "192.0.2.1" | top 100
by Timestamp desc

כדי לאחזר את ההתראות שקשורות לנקודת קצה, בפעולה Execute Entity Query צריך להגדיר את הפרמטרים Table,‏ IP Entity Key,‏ Hostname Entity Key ו-Cross Entity Operator באופן הבא:

פרמטר ערך של AlertInfo
IP Entity Key IPAddress
Hostname Entity Key DeviceName
Cross Entity Operator OR

כדי לבדוק על כמה נקודות קצה משפיעים ערכי ה-hash שסופקו, בפעולה Execute Entity Query צריך להזין את הערך SHA1 בפרמטר File Hash Entity Key.

הפרמטר Cross Entity Operator משפיע על השאילתה רק כשמגדירים כמה ערכים לפרמטר Entity Keys.

קלט של הפעולה

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

פרמטר תיאור
Table Names חובה

רשימה מופרדת בפסיקים של טבלאות לשאילתה ב-Microsoft Defender For XDR.

Time Frame אופציונלי

התקופה של תוצאות השאילתה.

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

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

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom
Start Time אופציונלי

שעת ההתחלה של תוצאות השאילתה.

אם מגדירים את הפרמטר Time Frame לערך Custom, חובה להשתמש בפרמטר הזה.

End Time אופציונלי

שעת הסיום של תוצאות השאילתה.

אם לא מגדירים ערך ומגדירים את הפרמטר Time Frame כ-Custom, הפעולה מגדירה את הפרמטר הזה לערך הזמן הנוכחי כברירת מחדל.

Fields To Return אופציונלי

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

Sort Field אופציונלי

השדה שלפיו התוצאות ימוינו.

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

Sort Order אופציונלי

הסדר שבו התוצאות ימוינו (בסדר עולה או יורד).

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

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

  • ASC
  • DESC
Max Results To Return אופציונלי

המספר המקסימלי של תוצאות שיוחזרו.

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

IP Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות IP Address.

Hostname Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות Hostname.

File Hash Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות File Hash.

User Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות User.

URL Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות URL.

Email Address Entity Key אופציונלי

המפתח שמשמש לסינון לפי הישות Email Address. הפעולה מקבלת את הישות User שתואמת לביטוי הרגולרי של כתובת האימייל.

Stop If Not Enough Entities אופציונלי

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

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

Cross Entity Operator חובה

האופרטור הלוגי שבו משתמשים בין סוגי ישויות שונים בשאילתה.

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

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

  • OR
  • AND

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

הפעולה Execute Entity Query מספקת את הפלטים הבאים:

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

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

 {
        "Timestamp": "2021-04-12T07:25:00Z",
        "AlertId": "fa7a318954-6c4c-eaab-3200-08d8fd82af35",
        "Title": "CC_Sensitive information",
        "Category": "InitialAccess",
        "Severity": "Medium",
        "ServiceSource": "Microsoft Defender for Office 365",
        "DetectionSource": "Microsoft Defender for Office 365",
        "AttackTechniques": ""
  }
הודעות פלט

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

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

Successfully executed query "QUERY" in Microsoft 365 Defender.

Action wasn't able to build the query, because not enough entity types were supplied for the specified "ENTITY_KEYS". Please disable the "Stop If Not Enough Entities" parameter or provide at least one entity for each specified ENTITY_KEY.

No data was found for the query "QUERY" in Microsoft 365 Defender."

הפעולה בוצעה בהצלחה.
Error executing action "Execute Entity Query". Reason: ERROR_REASON

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

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

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

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

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

הרצת השאילתה

משתמשים בפעולה Execute Query כדי להריץ שאילתות ציד ב-Microsoft 365 Defender.

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

קלט של הפעולה

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

פרמטר תיאור
Table Names חובה

רשימה מופרדת בפסיקים של שמות הטבלאות שרוצים לשלוח אליהן שאילתות ב-Microsoft 365 Defender.

Query אופציונלי

שאילתה להרצה.

משתמשים בפרמטר הזה כדי לספק את הסעיף | where. מסנן הזמן, ההגבלה והמיון הם אופציונליים.

Time Frame אופציונלי

התקופה של תוצאות השאילתה.

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

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

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom
Start Time אופציונלי

שעת ההתחלה של תוצאות השאילתה בפורמט ISO 8601.

אם מגדירים את הפרמטר Time Frame לערך Custom, חובה להשתמש בפרמטר הזה.

End Time אופציונלי

שעת הסיום של תוצאות השאילתה בפורמט ISO 8601.

אם לא מגדירים ערך ומגדירים את הפרמטר Time Frame כ-Custom, הפעולה מגדירה את הפרמטר הזה לערך הזמן הנוכחי כברירת מחדל.

Fields To Return אופציונלי

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

Sort Field אופציונלי

השדה שלפיו התוצאות ימוינו.

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

Sort Order אופציונלי

הסדר שבו התוצאות ימוינו (בסדר עולה או יורד).

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

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

  • ASC
  • DESC
Max Results To Return אופציונלי

המספר המקסימלי של תוצאות שיוחזרו.

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

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

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

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

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

{"Results": [
    {
        "Timestamp": "2021-04-12T07:25:00Z",
        "AlertId": "fa7a318954-6c4c-eaab-3200-08d8fd82af35",
        "Title": "CC_Sensitive information",
        "Category": "InitialAccess",
        "Severity": "Medium",
        "ServiceSource": "Microsoft Defender for Office 365",
        "DetectionSource": "Microsoft Defender for Office 365",
        "AttackTechniques": ""
    }
]}
הודעות פלט

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

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

Successfully executed query "QUERY" in Microsoft 365 Defender.

No data was found for the query "QUERY" in Microsoft 365 Defender."

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

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

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

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

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

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

פינג

משתמשים בפעולה פינג כדי לבדוק את הקישוריות ל-Microsoft Defender For XDR.

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

קלט של הפעולה

אין.

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

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

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

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

הודעות פלט

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

הודעת פלט תיאור ההודעה
Successfully connected to the Microsoft 365 Defender server with the provided connection parameters! הפעולה בוצעה בהצלחה.
Failed to connect to the Microsoft 365 Defender server! Error is ERROR_REASON

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

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

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

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

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

עריכת האירוע

משתמשים בפעולה עדכון אירוע כדי לעדכן אירועים ב-Microsoft Defender For XDR.

בהתאם למגבלות ה-API, הפעולה הזו לא נכשלת גם אם מגדירים ערך לא חוקי של שם משתמש בפרמטר Assign To.

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

קלט של הפעולה

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

פרמטר תיאור
Incident ID חובה

המזהה של האירוע שצריך לעדכן ב-Microsoft Defender For XDR.

Status אופציונלי

הסטטוס שיוגדר לאירוע ב-Microsoft Defender For XDR.

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

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

  • Select One
  • Active
  • Resolved
Classification אופציונלי

הסיווג שיוגדר לאירוע ב-Microsoft Defender For XDR.

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

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

  • Select One
  • False Positive
  • True Positive
Determination אופציונלי

ההחלטה שצריך להגדיר לאירוע ב-Microsoft Defender For XDR.

הפרמטר הזה רלוונטי רק אם הערך של הפרמטר Classification הוא True Positive.

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

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

  • Select One
  • Not Available
  • Apt
  • Malware
  • Security Personnel
  • Security Testing
  • Unwanted Software
  • Other
Assign To אופציונלי

המשתמש שאליו יוקצה האירוע ב-Microsoft Defender For XDR.

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

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

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

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

הודעת פלט תיאור ההודעה
Successfully updated incident INCIDENT_ID in Microsoft 365 Defender. הפעולה בוצעה בהצלחה.
Error executing action "Update Incident". Reason: ERROR_REASON

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

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

מחברים

הוראות מפורטות להגדרת מחבר ב-Google SecOps מופיעות במאמר הטמעת הנתונים (מחברים).

‫Microsoft 365 Defender – מחבר אירועים

משתמשים ב-Microsoft 365 Defender – Incidents Connector כדי לשלוף מידע על אירועים וההתראות שקשורות אליהם מ-Microsoft Defender XDR.

הרשימה הדינמית פועלת עם שם אירוע.

מגבלות לגבי מחברים

Microsoft 365 Defender – Incidents Connector משתמש בבקשות API עם מגבלות API מחמירות. כדי לייצב את המחבר, מגדירים את הפרמטר Max Incidents To Fetch לערך 10 ואת הפרמטר Run Every לערך 1 minute. עדיין יכול להיות שתגיעו למגבלת הקצב של יצירת בקשות, כי נקודת קצה ל-API של Microsoft Graph שמשמשת לאחזור התראות מאפשרת רק 20 בקשות בכל דקה.

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

כניסות קלט של מחברים

כדי להשתמש ב-Microsoft 365 Defender – Incidents Connector, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Product Field Name חובה

שם השדה שבו מאוחסן שם המוצר.

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

Event Field Name חובה

שם השדה שמשמש לקביעת שם האירוע (סוג המשנה).

ערך ברירת המחדל הוא @odata.type.

Login API Root חובה

שורש ה-API להתחברות של המכונה של Microsoft Defender For XDR. צריך לעדכן את הפרמטר הזה אם משתמשים בדייר GCC High.

ערך ברירת המחדל הוא https://login.microsoftonline.com.

Graph API Root חובה

שורש ה-API של שירות Microsoft Graph. צריך לעדכן את הפרמטר הזה אם משתמשים בדייר GCC High.

ערך ברירת המחדל הוא https://graph.microsoft.com.

API Root חובה

שורש ה-API של המכונה של Microsoft Defender XDR. צריך לעדכן את הפרמטר הזה אם משתמשים בדייר GCC High.

ערך ברירת המחדל הוא https://api.security.microsoft.com.

Tenant ID חובה

ערך ה-Microsoft Entra ID (מזהה הדייר) של חשבון Microsoft Entra ID.

Client ID חובה

ערך מזהה האפליקציה (הלקוח) של חשבון Microsoft Entra ID.

Client Secret חובה

ערך סוד הלקוח של האפליקציה ב-Microsoft Entra ID.

Verify SSL אופציונלי

אם בוחרים באפשרות הזו, השילוב מאמת שאישור ה-SSL לחיבור לשרת Microsoft Defender For XDR תקף.

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

Lowest Severity To Fetch אופציונלי

רמת החומרה הנמוכה ביותר של אירועים שצריך לאחזר.

Max Hours Backwards אופציונלי

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

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

Max Incidents To Fetch אופציונלי

מספר האירועים המקסימלי שאפשר לאחזר בכל איטרציה של המחבר.

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

Incident Status Filter אופציונלי

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

ערך ברירת המחדל הוא active, inProgress.

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

  • active
  • inProgress
  • resolved
  • redirected

ברוב המקרים, אפשר להשאיר את השדה "אירועים שהופנו מחדש" ריק.

Assigned To אופציונלי

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

Tags אופציונלי

רשימה מופרדת בפסיקים של תגים שמשמשים לסינון אירועים שנשלפו מ-Microsoft 365 Defender.

Use whitelist as a blacklist אופציונלי

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

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

Lowest Alert Severity To Fetch אופציונלי

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

Disable Alert Tracking אופציונלי

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

מושבתת כברירת מחדל.

Environment Field Name אופציונלי

שם השדה שמכיל את שם הסביבה.

Environment Regex Pattern אופציונלי

תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה Environment Field Name. הפרמטר הזה מאפשר לשנות את שדה הסביבה באמצעות הלוגיקה של הביטוי הרגולרי.

משתמשים בערך ברירת המחדל .* כדי לאחזר את הערך הגולמי הנדרש של Environment Field Name.

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

PythonProcessTimeout חובה

מגבלת הזמן הקצוב לתפוגה בשניות לתהליך Python שמריץ את הסקריפט הנוכחי.

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

Dynamic List Field אופציונלי

הערך שבו הרשימה הדינמית משתמשת לסינון.

הערכים האפשריים הם Incident Name ו-Alert Name.

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

Alert Detection Source Filter אופציונלי

רשימה מופרדת בפסיקים של מקורות לזיהוי התראות שרוצים להטמיע, למשל antivirus, microsoftDefenderForEndpoint.

Alert Service Source Filter אופציונלי

רשימה מופרדת בפסיקים של מקורות של שירותי התראות להטמעה, כמו antivirus, microsoftDefenderForEndpoint.

Disable Overflow אופציונלי

אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון ההצפה של Google SecOps במהלך יצירת ההתראה.

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

Proxy Server Address אופציונלי

כתובת שרת ה-Proxy שבו רוצים להשתמש.

Proxy Username אופציונלי

שם המשתמש של שרת ה-proxy לאימות.

Proxy Password אופציונלי

הסיסמה לאימות מול שרת ה-proxy.

כללי מחברים

  • המחבר תומך בשרתי proxy.
  • המחבר תומך ברשימות דינמיות וברשימות חסימה.
  • המחבר תומך בדיירים ב-GCC High.

תעסוקה

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

‫Microsoft 365 Defender – סנכרון התראות

משתמשים במשימה Microsoft 365 Defender - Sync Alerts כדי לסנכרן התראות, הערות וסטטוסים בשני הכיוונים בין Google SecOps לבין Microsoft Defender XDR.

דרישות התפקיד

כדי לוודא שהמשימה מזהה ומסנכרנת את הנתונים הנכונים, צריך לעמוד בתנאים הבאים:

  • הפנייה ב-Google SecOps חייבת להכיל את התג Microsoft Defender XDR Alert.

  • אם ההתראה לא הגיעה מ-Microsoft 365 Defender – Incidents Connector, צריך להוסיף להתראה ערך הקשר של Alert_ID.

  • סנכרון מקבלי ההקצאה מתבצע רק מ-Microsoft Defender XDR ל-Google SecOps.

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

למשימה Microsoft 365 Defender - Sync Alerts נדרשים הפרמטרים הבאים:

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

חובה.

שם הסביבה שממנה מסנכרנים את ההתראות.

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

Login API Root

חובה.

השורש של Login API של המכונה של Microsoft Defender XDR.

ערך ברירת המחדל הוא https://login.microsoftonline.com.

Graph API Root

חובה.

שורש ה-API של שירות Microsoft Graph.

ערך ברירת המחדל הוא https://graph.microsoft.com.

API Root

חובה.

שורש ה-API של המכונה של Microsoft Defender XDR.

ערך ברירת המחדל הוא https://api.security.microsoft.com.

Tenant ID

חובה.

מזהה הדייר (tenant) של החשבון ב-Microsoft Defender XDR.

Client ID

חובה.

מזהה הלקוח של החשבון ב-Microsoft Defender XDR.

Client Secret

חובה.

סוד הלקוח של החשבון ב-Microsoft Defender XDR.

Max Hours Backwards

חובה.

מספר השעות לסנכרון ההתראות לפני השעה הנוכחית במהלך האיטרציה הראשונה של המשימה.

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

Sync Assignee

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

אם בוחרים באפשרות הזו, הפעולה מסנכרנת את מקבל ההקצאה מ-Microsoft Defender XDR ל-Google SecOps.

Verify SSL

חובה.

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

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

Sync Direction

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

מיפוי ה-JSON שמשמש לשליטה בכיוון הסנכרון של כל תכונה.

המפתחות הנתמכים הם Status ו-Comments.

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

  • Bidirectional
  • toXDR
  • toSecOps
  • None

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

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

מפתחות שלא צוינו מוגדרים כברירת מחדל ל-Bidirectional. לדוגמה:

  • ‫{"Status": "toXDR"}: הסטטוס מסונכרן מ-Google SecOps ל-Microsoft Defender XDR, והתגובות ממשיכות להסתנכרן בשני הכיוונים.
  • ‫{"Comments": "toSecOps"}: התגובות מסונכרנות מ-Microsoft Defender XDR ל-Google SecOps, והסטטוס ממשיך להסתנכרן בשני הכיוונים.

ערך ברירת המחדל הוא {"Status": "Bidirectional", "Comments": "Bidirectional"}.

Closed Reason Mapping

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

מיפוי ה-JSON של צמדי Closure Reason|RootCause ב-Google SecOps לסיווג ולהחלטה ב-Microsoft Defender XDR. הפרמטר הזה רלוונטי רק לסנכרון של סיבות סגירה בהתאמה אישית מ-Google SecOps ל-Microsoft Defender XDR.

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

  • Malicious ← truePositive, maliciousUserActivity
  • Not Malicious ← falsePositive, notMalicious
  • Maintenance או Inconclusive ← unknownFutureValue, other (תואם ל-Unclassified ב-Microsoft Defender)

חיפוש הזמנה: כשסוגרים התראה ב-Google SecOps, המשימה בודקת את פרטי הסגירה בסדר הבא:

  1. התאמה מדויקת של זוג ("{Reason} | {Root Cause}"): בדיקה של התאמה מדויקת של זוג (כמו "{Malicious} | {Misconfigured system}").
  2. התאמה של סיבה אחת ("Reason"): אם אין התאמה מדויקת של צמד, המערכת בודקת אם יש התאמה של מפתח סיבה אחד (כמו "Malicious").
  3. חלופה: אם אין התאמה לאף אחד מהם, או אם הערך שצוין ב-classification או ב-determination לא מתקבל על ידי ה-API של Microsoft Defender, המשימה משתמשת ברשומה Fallback.

ערך ברירת המחדל הוא {"{reason} | {root cause}": {"classification": "unknownFutureValue", "determination": "other"}, "Malicious": {"classification": "truePositive", "determination": "maliciousUserActivity"}, "NotMalicious": {"classification": "falsePositive", "determination": "notMalicious"}, "Fallback": {"classification": "unknownFutureValue", "determination": "other"}}.

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