Microsoft Defender For Endpoint

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

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

  1. להשתמש בנתונים שנאספו ב-Microsoft Defender for Endpoint כדי להעשיר את המידע בזמן חקירה של מקרה מסוים.

    מנתחי נתונים יכולים להשתמש בנתונים שנאספים ונשמרים ב-Microsoft Defender for Endpoint בחקירות – לדוגמה, כדי לקבל מידע על התראות שזוהו ב-Microsoft Defender for Endpoint או להציג רשימה של מכונות שרשומות ב-Microsoft Defender for Endpoint.

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

  3. עוקבים אחרי ההתראות של Microsoft Defender for Endpoint ובודקים אותן בתור התראות של Google Security Operations, שנשלפות על ידי המחבר המתאים.

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

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

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

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

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

כשניגשים ל-Microsoft Defender for Endpoint API, מומלץ להשתמש בהקשר של האפליקציה במקום בהקשר של המשתמש.

יצירת אפליקציית Microsoft Entra

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

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

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

  4. כותבים את שם האפליקציה.

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

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

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

  1. עוברים אל API Permissions > Add a permission > APIs my organization uses. תיבת הדו-שיח בקשת הרשאות API נפתחת.

  2. בשדה Search, מזינים WindowsDefenderATP.

  3. בוחרים באפשרות WindowsDefenderATP > הרשאות לאפליקציה.

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

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

  6. בדף API Permissions, לוחצים על Add a permission.

  7. בוחרים באפשרות Microsoft Graph > Delegated permissions.

  8. בקטע Select Permissions, בוחרים את ההרשאה הנדרשת הבאה:

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

  10. בדף API Permissions, לוחצים על Add a permission.

  11. בוחרים באפשרות WindowsDefenderATP > הרשאות לאפליקציה.

  12. בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:

    • AdvancedQuery.Read.All
    • Alert.Read.All
    • Alert.ReadWrite.All
    • Event.Write
    • File.Read.All
    • Ip.Read.All
    • Machine.Isolate
    • Machine.Read.All
    • Machine.ReadWrite.All
    • Machine.Scan
    • Machine.StopAndQuarantine
    • Ti.ReadWrite
    • Url.Read.All
    • User.Read.All
  13. לוחצים על Grant admin consent for ORGANIZATION_NAME.

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

הדוגמה הבאה מראה בקשת API לקבלת התראות Defender ATP (שימו לב לפרמטר $expand שמשמש לאחזור נתונים על כתובות IP, דומיינים וקבצים):

GET /api/alerts?$expand=files,ips,domains HTTP/1.1
Host: api.securitycenter.windows.com
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJ...
User-Agent: PostmanRuntime/7.19.0
Accept: */ *
Cache-Control: no-cache
Postman-Token: 2dc0f885-068a-45d4-81a6-2da0d23a58ad,d3dd0e6e-83ab-4d27-94d2-0f3889dff324
Host: api.securitycenter.windows.com
Accept-Encoding: gzip, deflate
Connection: keep-alive
cache-control: no-cache

מידע נוסף על הפרמטרים והאפשרויות של הבקשות, כמו סינון או הרחבה, זמין במאמר ממשקי API נתמכים של Microsoft Defender for Endpoint במסמכי התיעוד של Microsoft.

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

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

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

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

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

הפעלת השילוב של SIEM – הוצא משימוש

  1. בחלונית הניווט, לוחצים על הגדרות > SIEM.

  2. בוחרים באפשרות הפעלת שילוב SIEM.

הפעולה הזו מפעילה את הקטע של פרטי הגישה למחבר SIEM עם ערכים שמולאו מראש, ונוצרת אפליקציה בדייר של Azure AD.

  • בוחרים את סוג ה-SIEM בתור Generic API.
  • מעתיקים את הערכים הנפרדים או בוחרים באפשרות "שמירת הפרטים בקובץ" כדי להוריד קובץ שמכיל את כל הערכים.
  • כדי ליצור אסימון לגישה לנתוני הזיהוי, תצטרכו את הערכים שמוצגים בדף הזה: מזהה הלקוח, סוד הלקוח והמשאב.

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

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

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

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

פרמטרים
Client ID חובה

מזהה הלקוח (האפליקציה) של אפליקציית Microsoft Entra שמשמשת לשילוב.

Client Secret חובה

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

Azure Active Directory ID חובה

ערך Microsoft Entra ID (מזהה הדייר).

Verify SSL אופציונלי

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

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

API Root חובה

כתובת ה-URL הבסיסית של ה-API שמשמשת לשילוב. כדי לשפר את הביצועים, אפשר להשתמש בשרת שהכי קרוב למיקום שלכם:

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com

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

פעולות

מחיקת אינדיקטורים של ישויות

למחוק אינדיקטורים של ישויות ב-Microsoft Defender for Endpoint.

פרמטרים

לא רלוונטי

הפעלה ב-

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

  • כתובת IP
  • כתובת URL
  • Filehash

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר של נרתיק הטעינה
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

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

אם מדווח קוד הסטטוס 204 (is_success=true): "הישויות הבאות נמחקו בהצלחה כאינדיקטורים ב-Microsoft Defender for Endpoint:‏ {entity.identifier}.

אם האירוע לא נמצא (is_success=true): "The following entities don't exist as indicators in Microsoft Defender for Endpoint: {entity.identifier}.

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

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "Delete Entity Indicators".‎ הסיבה: {0}''.format(error.Stacktrace)

כללי

העשרת ישויות

העשרת ישויות של מארח, כתובת IP או גיבוב קובץ ב-Google SecOps על סמך המידע מ-Microsoft Defender for Endpoint.

פרמטרים

לא רלוונטי

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

אפשר להשתמש בפעולה הזו בפלייבוקים שחוקרים פעילות במכשירים. אם במכשיר מותקן הסוכן של Microsoft Defender for Endpoint, הפעולה שולפת מידע מ-Defender ATP במכשיר כדי להעשיר את הישויות של Google SecOps. אפשר גם להשתמש בפעולה כדי להעשיר את ערכי ה-hash של קובץ ההתראה במידע מ-Defender ATP.

הפעלה ב-

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

  • מארח
  • כתובת IP
  • Filehash

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON

אם ההעשרה פועלת על כתובת IP או מארח:

[
    {
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines/$entity",
            "id": "example_id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-24T18:31:50.581058Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.138",
            "lastExternalIpAddress": "203.0.113.28",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    }
]

אם העשרת הנתונים פועלת ב-Filehash:

[
    {
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Files/$entity",
            "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
            "sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
            "md5": "9512e1cc66a1d36feb0a290cab09087b",
            "globalPrevalence": 5205000,
            "globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
            "globalLastObserved": "2019-11-21T00:24:01.921338Z",
            "size": 245760,
            "fileType": "APP",
            "isPeFile": true,
            "filePublisher": "Microsoft Corporation",
            "fileProductName": "Microsoft Windows Operating System",
            "signer": "Microsoft Windows",
            "issuer": "Microsoft Windows Production PCA 2011",
            "signerHash": "419e77aed546a1a6cf4dc23c1f977542fe289cf7",
            "isValidCertificate": true
            },
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
            "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
            "orgPrevalence": "1",
            "orgFirstSeen": "2019-11-19T03:54:15Z",
            "orgLastSeen": "2019-11-19T04:21:18Z",
            "globalPrevalence": "5205000",
            "globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
            "globalLastObserved": "2019-11-21T00:24:01.921338Z",
            "topFileNames": ["notepad.exe"]
        }
    }
]
העשרת ישויות

כתובת IP ומארח

שם שדה ההעשרה לוגיקה – מתי להחיל
Defender_ATP.sha1 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.sha256 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.md5 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalPrevalence הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalFirstObserved הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalLastObserved הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.size הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.fileType הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.isPeFile הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.filePublisher הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.fileProductName הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.signer הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.issuer הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.signerHash הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.isValidCertificate הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgPrevalence הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgFirstSeen הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgLastSeen הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.topFileNames הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON

גיבוב (hash) של קובץ

שם שדה ההעשרה לוגיקה – מתי להחיל
Defender_ATP.sha1 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.sha256 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.md5 הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalPrevalence הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalFirstObserved הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.globalLastObserved הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.size הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.fileType הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.isPeFile הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.filePublisher הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.fileProductName הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.signer הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.issuer הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.signerHash הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.isValidCertificate הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgPrevalence הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgFirstSeen הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.orgLastSeen הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
Defender_ATP.topFileNames הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON

הרצת פקודת Live Response

משתמשים בפעולה Execute Live Response Command כדי להריץ פקודת תגובה בזמן אמת ב-Microsoft Defender for Endpoint.

קלט של הפעולה

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

פרמטר תיאור
Command

חובה.

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

מידע נוסף על מבני הפקודות הנתמכים זמין במאמרי העזרה של Microsoft Defender for Endpoint API.

פורמט לדוגמה:

{
    "type": "Command",
    "params": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}
Comment

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

הערה או תיאור של הפקודה שבוצעה.

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

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

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

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

{
   "Entity": "",
   "EntityResult": {
       "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
       "id": "00000000-0000-0000-0000-000000000000",
       "type": "LiveResponse",
       "title": null,
       "requestor": "SEC_OPS_USER",
       "requestorComment": "Execution of live response command",
       "status": "Pending",
       "machineId": "MACHINE_ID_HASH",
       "computerDnsName": "hostname.domain.local",
       "creationDateTimeUtc": "2026-01-04T10:57:33.032Z",
       "lastUpdateDateTimeUtc": "2026-01-04T10:57:33.032Z",
       "cancellationRequestor": null,
       "cancellationComment": null,
       "cancellationDateTimeUtc": null,
       "errorHResult": 0,
       "scope": null,
       "externalId": null,
       "requestSource": "PublicApi",
       "relatedFileInfo": null,
       "commands": [],
       "troubleshootInfo": null,
       "results": {
           "filepath": "",
           "script_name": "remediation_script.ps1",
           "exit_code": 0,
           "script_output": "Script completed successfully",
           "script_errors": ""
       }
   }
}
הודעות פלט

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

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

Successfully executed command on the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

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

The command didn't complete for the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

The scan didn't complete for all of the provided endpoints in Microsoft Defender for Endpoint.

Error executing action "Execute Live Response Command". Reason: ERROR_REASON

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

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

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

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

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

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

לבדוק מה הסטטוס הנוכחי של המשימה.

פרמטרים

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

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[
    {
        "status": "Succeeded",
        "creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
        "cancellation_requestor": null,
        "cancellation_date_time_utc": null,
        "id": "2e39d22e-60a7-4267-899c-a1471e800000",
        "last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
        "related_file_info": null,
        "cancellation_comment": null,
        "requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
        "error_h_result": 0,
        "scope": "Selective",
        "machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
        "type": "Isolate",
        "requestor_comment": "test"
    }
]

קבלת התראות שקשורות לקובץ מ-Microsoft Defender for Endpoint על סמך גיבוב הקובץ.

פרמטרים

ערך הפרמטר שמוצג סוג ערך ברירת המחדל Is Mandatory תיאור
סטטוס String Unknown, New, InProgress, Resolved לא

מציינים את הסטטוסים של ההתראות שרוצים לחפש.

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

חוּמרה String לא צוין, מידע, נמוכה, בינונית, גבוהה לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

קטגוריה String לא רלוונטי לא

מציינים את קטגוריית ההתראה שרוצים לחפש.

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

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

ערכים אפשריים: 'Collection',‏ 'CommandAndControl',‏ 'CredentialAccess',‏ 'DefenseEvasion',‏ 'Discovery',‏ 'Execution',‏ 'Exfiltration',‏ 'Exploit',‏ 'InitialAccess',‏ 'LateralMovement',‏ 'Malware',‏ 'Persistence',‏ 'PrivilegeEscalation',‏ 'Ransomware',‏ 'SuspiciousActivity',‏ 'UnwantedSoftware'.

מזהה אירוע מספר שלם לא רלוונטי לא ציינו את מזהה האירוע ב-Microsoft Defender שאתם רוצים למצוא התראות שקשורות אליו.

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

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

ריצה

הפעולה הזו פועלת על הישות Filehash.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example_id",
            "incidentId": 2,
            "investigationId": 1,
            "assignedTo": null,
            "severity": "Medium",
            "status": "New",
            "classification": null,
            "determination": null,
            "investigationState": "TerminatedBySystem",
            "detectionSource": "WindowsDefenderAtp",
            "category": "DefenseEvasion",
            "threatFamilyName": null,
            "title": "Suspicious process injection observed",
            "description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
            "alertCreationTime": "2019-11-19T03:56:37.7335862Z",
            "firstEventTime": "2019-11-19T03:54:15.7698362Z",
            "lastEventTime": "2019-11-19T03:54:15.7698362Z",
            "lastUpdateTime": "2019-11-20T10:13:31.7266667Z",
            "resolvedTime": null,
            "machineId": "machine-id",
            "alertUser": {
                "accountName": "example.user",
                "domainName": "EXAMPLELAB"
            },
            "comments": [],
            "alertFiles": [
                {
                    "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
                    "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
                    "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
                    "fileName": "powershell.exe"
                },{
                    "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
                    "sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
                    "filePath": "C:\\Windows\\System32\\notepad.exe",
                    "fileName": "notepad.exe"
                }
            ],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
        }
    ]
}

אחזור מכונות שקשורות לקובץ מ-Microsoft Defender for Endpoint על סמך גיבוב הקובץ.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
שם המחשב String לא רלוונטי לא מציינים את השם המלא של המכונה שרוצים לחפש.
כתובת ה-IP של המכונה String לא רלוונטי לא מציינים את כתובת ה-IP של המכונה שרוצים לחפש.
ציון הסיכון של המכונה String לא רלוונטי לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

סטטוס תקינות המכונה String Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

פלטפורמת מערכת ההפעלה של המכונה String לא רלוונטי לא מציינים את הפלטפורמה של מערכת ההפעלה של המכונה שרוצים לחפש.
מזהה קבוצת RBAC String לא רלוונטי לא מציינים את מזהה קבוצת ה-RBAC שרוצים לחפש.

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

בזמן חקירת התראה שהגיעה מהמחבר של Defender ATP, אפשר להשתמש בפעולה הזו כדי לאסוף מידע על המכונות שבהן הקובץ הזה נרשם ב-Defender ATP.

הפעלה ב-

הפעולה הזו פועלת על הישות Filehash.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
    "value": [
        {
            "id": "example_id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-20T19:35:36.4619266Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.1",
            "lastExternalIpAddress": "203.0.113.121",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    ]
}

קבלת יומן המכונה של המשתמשים

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

פרמטרים

לא רלוונטי

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

אפשר להשתמש בפעולה למטרות חקירה כדי לקבל פרטים ספציפיים על המשתמשים שמחוברים למחשב המדובר משרת Defender ATP.

הפעלה ב-

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

  • מארח
  • כתובת IP

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Users",
    "value": [
        {
            "id": "example\\example.user",
            "accountName": "example.user",
            "accountDomain": "example",
            "accountSid": null,
            "firstSeen": "2019-11-19T03:50:36Z",
            "lastSeen": "2019-11-19T03:50:36Z",
            "mostPrevalentMachineId": null,
            "leastPrevalentMachineId": null,
            "logonTypes": "Interactive",
            "logOnMachinesCount": 1,
            "isDomainAdmin": false,
            "isOnlyNetworkUser": null
        }
    ]
}

קבלת המלצות למכונות

משתמשים בפעולה Get Machine Recommendations כדי לאחזר רשימה של המלצות אבטחה למכונות ספציפיות ב-Microsoft Defender for Endpoint.

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

  • Hostname

  • IP Address

קלט של הפעולה

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

פרמטר תיאור
Max Recommendations To Return

חובה.

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

הערך המקסימלי הוא 100.

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

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

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

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

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

{
   "Entity": "",
   "EntityResult": [
         {
            "id": "va-_-7-zip-_-7-zip",
            "productName": "7-zip",
            "recommendationName": "Update 7-zip to version 25.01.0.0",
            "weaknesses": 12,
            "vendor": "7-zip",
            "recommendedVersion": "25.01.0.0",
            "recommendedVendor": "",
            "recommendedProgram": "",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0.0,
            "publicExploit": true,
            "activeAlert": false,
            "associatedThreats": [],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0.0,
            "exposureImpact": 0.0,
            "totalMachineCount": 0,
            "exposedMachinesCount": 1,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "7-zip",
            "hasUnpatchableCve": false,
            "tags": [],
            "exposedCriticalDevices": 0
        }
   ]
}
הודעות פלט

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

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

Successfully returned recommendations for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the provided endpoints in Microsoft Defender for Endpoint.

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

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

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

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

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Get Machine Recommendations:

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

קבלת התראות שקשורות למכונה ספציפית שרשומה ב-Defender ATP.

פרמטרים

פרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
סטטוס String Unknown, New, InProgress, Resolved לא

מציינים את הסטטוסים של ההתראות שרוצים לחפש.

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

חוּמרה String לא צוין, מידע, נמוכה, בינונית, גבוהה לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

קטגוריה String לא רלוונטי לא

מציינים את קטגוריית ההתראה שרוצים לחפש.

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

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

ערכים אפשריים: 'Collection',‏ 'CommandAndControl',‏ 'CredentialAccess',‏ 'DefenseEvasion',‏ 'Discovery',‏ 'Execution',‏ 'Exfiltration',‏ 'Exploit',‏ 'InitialAccess',‏ 'LateralMovement',‏ 'Malware',‏ 'Persistence',‏ 'PrivilegeEscalation',‏ 'Ransomware',‏ 'SuspiciousActivity',‏ 'UnwantedSoftware'.

מזהה אירוע מספר שלם לא רלוונטי לא ציינו את מזהה האירוע ב-Microsoft Defender שאתם רוצים למצוא התראות שקשורות אליו.

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

אפשר להשתמש בפעולה למטרות חקירה כדי לקבל התראות שקשורות למכונה ספציפית משרת Defender ATP.

הפעלה ב-

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

  • מארח
  • כתובת IP

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example-id",
            "incidentId": 1,
            "investigationId": null,
            "assignedTo": "testuser@example.com",
            "severity": "Informational",
            "status": "Resolved",
            "classification": "FalsePositive",
            "determination": "SecurityTesting",
            "investigationState": "UnsupportedAlertType",
            "detectionSource": "WindowsDefenderAtp",
            "category": "Execution",
            "threatFamilyName": null,
            "title": "[Test Alert] Suspicious Powershell commandline",
            "description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
            "alertCreationTime": "2019-11-18T11:17:48.287421Z",
            "firstEventTime": "2019-11-18T11:15:06.5226815Z",
            "lastEventTime": "2019-11-18T11:15:06.5226815Z",
            "lastUpdateTime": "2019-11-20T04:12:03.91Z",
            "resolvedTime": "2019-11-20T04:12:03.4976288Z",
            "machineId": "machine-id",
            "alertUser": {
                "accountName": "Administrator",
                "domainName": "US-LT-V13007"
            },
            "comments": [],
            "alertFiles": [
                {
                    "sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
                    "sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
                    "filePath": "C:\\Windows\\System32\\cmd.exe",
                    "fileName": "cmd.exe"
                },
                {
                    "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
                    "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
                    "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
                    "fileName": "powershell.exe"
                }
            ],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
        }
    ]
}

קבלת נקודות החולשה של המכונה

משתמשים בפעולה Get Machine Vulnerabilities כדי להציג רשימה של נקודות חולשה שמשויכות למכונות ספציפיות ב-Microsoft Defender for Endpoint.

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

  • Hostname

  • IP Address

קלט של הפעולה

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

פרמטר תיאור
Severity Filter

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

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

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

  • Critical
  • High
  • Medium
  • Low

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

Threat Filter

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

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

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

  • Associated Active Alert
  • Exploit is available
  • Exploit is verified
  • This exploit is part of an exploit kit
Sort By

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

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

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

  • First Detection Time
  • Severity
  • Update Time

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

Sort Order

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

הסדר שבו מוצגות התוצאות הממוינות.

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

  • ASC
  • DESC

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

Max Vulnerabilities To Return

חובה.

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

הערך המקסימלי הוא 100.

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

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

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

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

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

{
   "Entity": "",
   "EntityResult": [
       {
           "@odata.type": "#microsoft.windowsDefenderATP.api.PublicVulnerabilityDto",
           "id": "CVE-2025-21266",
           "name": "CVE-2025-21266",
           "description": "Summary: The Windows Telephony Service in Microsoft Windows is vulnerable to remote code execution. An attacker can exploit this vulnerability by tricking a user into visiting a malicious website, which would allow them to execute arbitrary code on the system. Impact: If successfully exploited, this vulnerability could allow an attacker to execute arbitrary code on the affected system. This could lead to a complete compromise of the system, enabling the attacker to gain unauthorized access, steal sensitive information, or perform other malicious activities. Remediation: Apply the latest patches and updates provided by the respective vendors. Generated by AI",
           "severity": "High",
           "cvssV3": 8.8,
           "cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:U/RL:O/RC:C",
           "exposedMachines": 1,
           "publishedOn": "2025-01-14T08:00:00Z",
           "updatedOn": "2025-09-09T23:45:43.5Z",
           "firstDetected": "2025-01-14T18:31:29Z",
           "patchFirstAvailable": null,
           "publicExploit": false,
           "exploitVerified": false,
           "exploitInKit": false,
           "exploitTypes": [],
           "exploitUris": [],
           "cveSupportability": "Supported",
           "tags": [],
           "epss": 0.01391,
           "status": "RemediationRequired"
       }
   ]
}
הודעות פלט

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

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

Successfully returned vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the provided endpoints in Microsoft Defender for Endpoint.

No vulnerabilities were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No vulnerabilities were found for the provided endpoints in Microsoft Defender for Endpoint.

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

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

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

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

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

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

משתמשים בפעולה Get User Related Alerts כדי להציג רשימה של התראות שמשויכות למשתמשים ספציפיים ב-Microsoft Defender for Endpoint.

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

קלט של הפעולה

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

פרמטר תיאור
Max Alerts To Return

חובה.

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

הערך המקסימלי הוא 100.

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

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

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

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

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

[
    {
        "Entity": "User@domain.local",
        "EntityResult": [
            {
                "id": "da06788650-4d45-4dcf-ae23-d1071ad426ec_1",
                "incident_id": 864492,
                "investigation_id": 1778,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active '' malware ",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-02-27T06:58:08.1366667Z",
                "first_event_time": "2026-02-27T06:55:51.021546Z",
                "last_event_time": "2026-02-27T06:55:51.021546Z",
                "last_update_time": "2026-02-27T07:13:46.2333333Z",
                "resolved_time": "2026-02-27T07:13:44.3513463Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0b1f334d-b5e5-4618-8a2a-d3675e62a93b_1",
                "incident_id": 864492,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "New",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2026-02-27T06:58:38.5533333Z",
                "first_event_time": "2026-02-27T06:55:32.6699867Z",
                "last_event_time": "2026-03-05T07:24:52.7415066Z",
                "last_update_time": "2026-03-05T07:28:04.67Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious behavior by cmd.exe was observed",
                "description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
                "alert_creation_time": "2025-10-13T10:26:21.3333333Z",
                "first_event_time": "2025-10-13T10:23:58.1472359Z",
                "last_event_time": "2025-10-13T10:25:22.714708Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 13 Oct 25 | 10:26 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-13T10:40:32.4733451Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0e3de096-1789-43ff-bb2e-6cc22e5037ad_1",
                "incident_id": 864492,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "New",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "DefenseEvasion",
                "threat_family_name": null,
                "title": "Suspicious registry modification",
                "description": "A suspicious process modified the registry on this device. Registry entries can be added, modified, or removed to change various settings of the system or behavior of a program. Attackers leverage this technique to gain persistence, escalate privileges, launch malicious codes, or to tamper with security products.",
                "alert_creation_time": "2026-02-27T06:58:38.7266667Z",
                "first_event_time": "2026-02-27T06:56:11.3416006Z",
                "last_event_time": "2026-03-05T07:25:30.6007486Z",
                "last_update_time": "2026-03-05T07:28:07.39Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da13c4af0a-bd35-4cb2-a556-fa972f3b80da_1",
                "incident_id": 864492,
                "investigation_id": 1779,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active '' malware ",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-03-02T07:26:21.22Z",
                "first_event_time": "2026-03-02T07:25:05.4166175Z",
                "last_event_time": "2026-03-02T07:25:05.4166175Z",
                "last_update_time": "2026-03-02T07:37:19.2666667Z",
                "resolved_time": "2026-03-02T07:37:19.1231428Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2052972f-7cc3-42c8-8abf-8ac490d63c35_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious behavior by cmd.exe was observed",
                "description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
                "alert_creation_time": "2025-10-07T10:25:41.1666667Z",
                "first_event_time": "2025-10-07T10:23:44.5677721Z",
                "last_event_time": "2025-10-07T10:25:10.6581007Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\ud83e\udde8 Generic Threat - APTSimulator_schedu... - Not Mitigated - Escalated\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Isolation, Stop and Quarantine File, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis)\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-07T10:27:41.3867936Z"
                    },
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage (\ud83d\udca1Triage updated \u2192 Risk Deescalated)\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-07T10:32:21.417826Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2068d331-0335-4479-9f96-e8f33db81aa9_1",
                "incident_id": 864492,
                "investigation_id": 1780,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active 'Ceprolad' malware in a command line was prevented from executing",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-03-05T07:26:09.89Z",
                "first_event_time": "2026-03-05T07:25:08.6889036Z",
                "last_event_time": "2026-03-05T07:25:08.6889036Z",
                "last_update_time": "2026-03-05T07:37:44.9066667Z",
                "resolved_time": "2026-03-05T07:37:44.65021Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da29243e25-be1e-47b7-9d40-e626df36345c_1",
                "incident_id": 688299,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Persistence",
                "threat_family_name": null,
                "title": "New group added suspiciously",
                "description": "A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.",
                "alert_creation_time": "2025-09-18T14:59:47.52Z",
                "first_event_time": "2025-09-18T14:53:30.7348596Z",
                "last_event_time": "2025-09-21T14:53:43.8093531Z",
                "last_update_time": "2025-09-21T14:56:44.5166667Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - APTSimulator_schedu... - Not Mitigated - Follow Up Required\n===================================\n\n- Title: New group added suspiciously\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Discovery: Local Groups [T1069.001]\n  * Persistence: Account Manipulation [T1098]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da29243e25-be1e-47b7-9d40-e626df36345c_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-09-18T15:03:43.2796289Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2be6df1c-2401-4545-8111-5f75d0fd0223_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Low",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2025-10-01T10:26:20.6566667Z",
                "first_event_time": "2025-10-01T10:24:19.1071611Z",
                "last_event_time": "2025-10-07T10:24:27.1065475Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - en-US.js - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 01 Oct 25 | 10:26 UTC\n- External severity: Low\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: Indicator Removal on Host [T1070]\n  * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2be6df1c-2401-4545-8111-5f75d0fd0223_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-01T10:30:36.462226Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da37252b75-0446-4a7b-99b4-e64886557bd3_1",
                "incident_id": 688299,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2025-09-18T14:59:46.57Z",
                "first_event_time": "2025-09-18T14:54:11.4061419Z",
                "last_event_time": "2025-09-21T14:54:00.575478Z",
                "last_update_time": "2025-09-21T14:56:36.6533333Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - wscript.exe - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Low\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: Indicator Removal on Host [T1070]\n  * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da37252b75-0446-4a7b-99b4-e64886557bd3_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-09-18T15:06:13.2743521Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            }
        ]
    }
]
הודעות פלט

הפעולה Get User Related Alerts יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully returned alerts related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the provided users in Microsoft Defender for Endpoint.

הפעולה בוצעה בהצלחה.
Error executing action "Get User Related Alerts". Reason: ERROR_REASON

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

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

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

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

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

בידוד המכונה

מבודדים מכונה באמצעות Microsoft Defender for Endpoint. אפשר להגדיר את המכונה לבידוד מלא או לבידוד סלקטיבי. האפליקציות Outlook, ‏Skype for Business ו-Teams ממשיכות לפעול במחשב מבודד.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
סוג הבידוד DDL

מלא

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

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

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

בידוד מכונה שנחשבת לנגועה. לדוגמה, התראה ממחבר Defender ATP נשלחה לשרת Google SecOps, ובמהלך ניתוח ההתראה התגלה שהמכונה שקשורה להתראה (ישות של אירוע) עלולה להיות נגועה וצריך לבודד אותה.

הפעלה ב-

הפעולה הזו פועלת על הפעולות הבאות:

  • מארח
  • כתובת IP

תוצאות הפעולה

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

הערך True אם נקודת הקצה ל-API החזירה את סטטוס 201 לכל ישות שסופקה והיא הופעלה בה, בתגובת JSON "status": "Pending", שמציינת שבקשת ה-API בוצעה בהצלחה. אם הפעולה נכשלת לפחות באחת מהישויות, התוצאה הסופית צריכה להיות כישלון (False).

שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "Isolate",
    "requestor": "requestor-id",
    "requestorComment": "Machine Isolation due to alert ...",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
    "lastUpdateDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}
תובנות
  • לוגיקת התובנה: אם המכונה בודדה באמצעות סוכן Defender ATP, צריך ליצור תובנה שמציינת זאת.
  • סוג: ישות.
  • כותרת (מחרוזת): ישות.
  • IdentifierMessage: "Host was isolated using Microsoft Defender for Endpoint."

רשימת התראות

הצגת רשימה של התראות מ-Microsoft Defender for Endpoint על סמך קריטריונים לחיפוש. הפעולה מחזירה מידע על ההתראות שנמצאו בטבלה ובפורמט JSON כפלט של הפעולה, יחד עם נתוני התראות גולמיים שמאוחסנים בקובץ ה-JSON של פלט הפעולה ומצורפים אליו.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
מסגרת זמן מספר שלם 3 לא מציינים את מסגרת הזמן בשעות שבהן רוצים לאחזר התראות.
סטטוס String Unknown, New, InProgress, Resolved לא

מציינים את הסטטוסים של ההתראות שרוצים לחפש.

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

חוּמרה String לא רלוונטי לא

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

אם לא מציינים רמת חומרה, הפעולה מחפשת את כל רמות החומרה.

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

ערכים אפשריים: UnSpecified,‏ Informational,‏ Low,‏ Medium ו-High

קטגוריה String לא רלוונטי לא

מציינים את קטגוריית ההתראה שרוצים לחפש.

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

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

ערכים אפשריים: 'Collection', 'CommandAndControl', 'CredentialAccess', 'DefenseEvasion', 'Discovery', 'Execution', 'Exfiltration', 'Exploit', 'InitialAccess', 'LateralMovement', 'Malware', 'Persistence', 'PrivilegeEscalation', 'Ransomware', 'SuspiciousActivity', 'UnwantedSoftware'.

מזהה אירוע מספר שלם לא רלוונטי לא ציינו את מזהה האירוע ב-Microsoft Defender שאתם רוצים למצוא התראות שקשורות אליו.

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

אפשר להשתמש בפעולה כדי לבדוק אזהרות של Defender ATP בשרת Google SecOps של משתמש קצה. לדוגמה, כשמטפלים באזהרה שהגיעה מהמחבר של Defender ATP, המשתמש מגדיר את הפעולה "רשימת אזהרות" כך שתקבל את מזהה האירוע של ההתראה שעובדה כפרמטר הקלט כדי לשלוף פרטים משרת Defender ATP – יש אזהרות אחרות שהן חלק מאירוע Defender ATP יחיד.

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example_id",
            "incidentId": 2,
            "investigationId": null,
            "assignedTo": null,
            "severity": "Medium",
            "status": "New",
            "classification": null,
            "determination": null,
            "investigationState": "UnsupportedAlertType",
            "detectionSource": "WindowsDefenderAtp",
            "category": "Execution",
            "threatFamilyName": null,
            "title": "Unexpected behavior observed by a process run with no command line arguments",
            "description": "The legitimate process by this name does not normally exhibit this behavior when run with no command line arguments. \nSuch unexpected behavior may be a result of extraneous code injected into a legitimate process, or a malicious executable masquerading as the legitimate one by name.",
            "alertCreationTime": "2019-11-19T03:56:35.3007009Z",
            "firstEventTime": "2019-11-19T03:54:16.0441057Z",
            "lastEventTime": "2019-11-19T03:54:16.0441057Z",
            "lastUpdateTime": "2019-11-19T03:56:38.45Z",
            "resolvedTime": null,
            "machineId": "machine-id",
            "alertUser": null,
            "comments": [],
            "alertFiles": [],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
            }
    ]
}

אינדיקטורים של רשימות

רשימת אינדיקטורים ב-Microsoft Defender for Endpoint.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
אינדיקטורים CSV לא רלוונטי לא ציינו רשימה מופרדת בפסיקים של האינדיקטורים שאתם רוצים לאחזר.
סוגי אינדיקטורים CSV FileSha1,FileSha256,FileMd5,CertificateThumbprint,IpAddress,DomainName, Url לא

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

ערכים אפשריים: FileSha1, ‏ FileSha256, ‏ FileMd5,‏ CertificateThumbprint, ‏ IpAddress,‏ DomainName, ‏ Url.

פעולות CSV Warn,Block,Audit,Alert,AlertAndBlock,BlockAndRemediate,Allowed לא

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

ערכים אפשריים: Warn,‏ Block,‏ Audit,‏ Alert,‏ AlertAndBlock,‏ BlockAndRemediate,‏ Allowed

חוּמרה CSV מידע,נמוכה,בינונית,גבוהה לא

מציינים רשימה מופרדת בפסיקים של רמות החומרה שרוצים להשתמש בהן לסינון.

ערכים אפשריים: Informational,‏ Low,‏ Medium,‏ High

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

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "18",
    "indicatorValue": "110e7d15b011d7fac48f2bd61114db1022197f7a",
    "indicatorType": "FileSha1",
    "action": "Audit",
    "createdBy": "45e9773c-100e-4a9f-ad37-d8e182e9ed26",
    "severity": "Informational",
    "category": 1,
    "application": "demo-test",
    "educateUrl": null,
    "bypassDurationHours": null,
    "title": "test",
    "description": "test",
    "recommendedActions": "nothing",
    "creationTimeDateTimeUtc": "2022-02-08T14:20:34.9071582Z",
    "expirationTime": null,
    "lastUpdateTime": "2022-02-08T14:20:34.9151307Z",
    "lastUpdatedBy": null,
    "rbacGroupNames": [],
    "rbacGroupIds": [],
    "notificationId": null,
    "notificationBody": null,
    "version": null,
    "mitreTechniques": [],
    "historicalDetection": false,
    "lookBackPeriod": null,
    "generateAlert": true,
    "additionalInfo": null,
    "createdByDisplayName": "Example Defender ATP",
    "externalId": null,
    "createdBySource": "PublicApi",
    "certificateInfo": null
}
קיר של נרתיק הטעינה
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

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

אם יש נתונים (is_success=true): "Successfully found indicators for the provided criteria in Microsoft Defender for Endpoint."‎ (נמצאו אינדיקטורים לקריטריונים שצוינו ב-Microsoft Defender for Endpoint).

אם הנתונים לא זמינים (is_success=false): "לא נמצאו אינדיקטורים לקריטריונים שצוינו ב-Microsoft Defender for Endpoint".

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

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "List Indicators".‎ הסיבה: {0}''.format(error.Stacktrace)

אם הפרמטר "Indicator types" לא תקין: "Error executing action "List Indicators".‎ הסיבה: ערך לא חוקי בפרמטר "סוגי אינדיקטורים". ערכים אפשריים: FileSha1, ‏ FileSha256, ‏ FileMd5, ‏ CertificateThumbprint,‏ IpAddress, ‏ DomainName, ‏ Url.

אם צוין פרמטר "Actions" לא תקין: "Error executing action "List Indicators". הסיבה: ערך לא תקין בפרמטר Actions. ערכים אפשריים: Warn, ‏ Block, ‏ Audit, ‏ Alert,‏ AlertAndBlock, ‏ BlockAndRemediate, ‏ Allowed.

אם הפרמטר "Severity" שצוין לא תקין: "Error executing action "List Indicators".‎ הסיבה: ערך לא חוקי בפרמטר Actions. ערכים אפשריים: לצורך מידע, נמוכה, בינונית, גבוהה.

כללי
שולחן קיר עם ארונית

אינדיקטורים שנמצאו

סוג: indicatorType

פעולה: פעולה

Severity: severity Description: description Title: title Recommendation: recommendedActions

ישות

מכונות לרשימות

קבלת מידע על מכונות שרשומות בשרת Microsoft Defender for Endpoint, על סמך הפרמטרים שצוינו בחיפוש.

פרמטרים

פרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
מסגרת הזמן של הנראות האחרונה מספר שלם לא רלוונטי לא צריך לציין את מסגרת הזמן של הפעילות האחרונה בשעות.
שם המחשב String לא רלוונטי לא מציינים את השם המלא של המכונה שרוצים לחפש.
כתובת ה-IP של המכונה String לא רלוונטי לא מציינים את כתובת ה-IP של המכונה שרוצים לחפש.
ציון הסיכון של המכונה String ללא, נמוכה, בינונית, גבוהה לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

סטטוס תקינות המכונה String Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication לא

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

הפרמטר מקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

פלטפורמת מערכת ההפעלה של המכונה String לא רלוונטי לא מציינים את הפלטפורמה של מערכת ההפעלה של המכונה שרוצים לחפש.
מזהה קבוצת RBAC String לא רלוונטי לא מציינים את מזהה קבוצת ה-RBAC שרוצים לחפש.

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

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

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
    "value": [
        {
            "id": "example-id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-20T09:59:28.0646303Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.138",
            "lastExternalIpAddress": "203.0.113.35",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        },{
            "id": "example-id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-20T08:36:16.2721384Z",
            "lastSeen": "2019-11-20T08:36:52.7182837Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.141",
            "lastExternalIpAddress": "203.0.113.35",
            "agentVersion": "10.4850.17134.191",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "None",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    ]
}

פינג

בודקים את הקישוריות למכונה של Microsoft Defender for Endpoint באמצעות הפרמטרים שצוינו בדף ההגדרות של השילוב.

פרמטרים

לא רלוונטי

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

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

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False

הרצת שאילתת ציד מתקדמת

הפעלת שאילתת ציד מתקדמת של Microsoft Defender for Endpoint. שימו לב שצריך להוסיף תו בריחה (escape) למירכאות, לשורות חדשות או לסמלים מיוחדים אחרים. לדוגמה, משתמשים בלוכסן הפוך כתו בריחה למירכאות.

פרמטרים

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

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

למשתמש יכולות להיות שאילתות ציד שהוא רוצה להשתמש בהן כדי לשלוח שאילתות לנתונים שנאספו ב-Defender ATP במהלך העיבוד של התראת Defender ספציפית. באמצעות הפעולה הזו המשתמש יכול להריץ את שאילתות הציד המתקדמות האלה.

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "Stats": {
        "ExecutionTime": 0.0156652,
        "resource_usage": {
            "cache": {
                "memory": {
                    "hits": 13,
                    "misses": 0,
                    "total": 13
                },
                "disk": {
                    "hits": 0,
                    "misses": 0,
                    "total": 0
                }
            },
            "cpu": {
                "user": "00:00:00.0156250",
                "kernel": "00:00:00",
                "total cpu": "00:00:00.0156250"
            },
            "memory": {
                "peak_per_node": 33554624
            }
        },
        "dataset_statistics": [
            {
                "table_row_count": 2,
                "table_size": 60
            }
        ]
    },
    "Schema": [
        {
            "Name": "EventTime",
            "Type": "DateTime"
        },
        {
            "Name": "FileName",
            "Type": "String"
        },
        {
            "Name": "InitiatingProcessFileName",
            "Type": "String"
        }
    ],
    "Results": [
        {
            "EventTime": "2019-11-18T11:13:07.043128Z",
            "FileName": "csc.exe",
            "InitiatingProcessFileName": "powershell.exe"
        },
        {
            "EventTime": "2019-11-19T03:54:14.4256361Z",
            "FileName": "csc.exe",
            "InitiatingProcessFileName": "powershell.exe"
        }
    ]
}

הפעלת סריקת אנטי-וירוס

התחלת סריקת אנטי-וירוס במארח באמצעות Microsoft Defender for Endpoint. יש שני סוגים של סריקות Defender ATP: מלאה או מהירה.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
סוג סריקת האנטי-וירוס DDL

מלא

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

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

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

התקבלה התראה מהמחבר של Defender ATP. במהלך עיבוד ההתראה, נמצאו במכונה אינדיקטורים לפריצות של תוכנות זדוניות שקשורות לישות של המקרה ב-Google SecOps. לכן המשתמש החליט להריץ סריקת אנטי-וירוס במכונה כדי לנסות למצוא תוכנות זדוניות במארח.

הפעלה ב-

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

  • מארח
  • כתובת IP

תוצאות הפעולה

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

הערך True אם נקודת הקצה ל-API החזירה את סטטוס 201 לכל ישות שסופקה והיא הופעלה בה, בתגובת JSON "status": "Pending", שמציינת שבקשת ה-API בוצעה בהצלחה. אם הפעולה נכשלת לפחות באחת מהישויות, התוצאה הסופית צריכה להיות כישלון (False).

שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "RunAntiVirusScan",
    "requestor": "requestor_id",
    "requestorComment": "Run antivirus scan on suspect",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T11:07:06.611628Z",
    "lastUpdateDateTimeUtc": "2019-11-21T11:07:06.611628Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}

עצירה והעברה להסגר של קובץ במכונה ספציפית

הפסקת ההפעלה של קובץ במכונה ספציפית והעברה שלו להסגר באמצעות סוכן Microsoft Defender For Endpoint. הפעולה פועלת עם ישויות של מארח או של כתובת IP ב-Google SecOps.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
גיבוב קובץ SHA1 להעברה להסגר String לא רלוונטי כן

צריך לציין את גיבוב SHA-1 של הקובץ שרוצים לעצור ולהעביר להסגר.

הערה: כדי שהפעולה תמצא קובץ תואם, ערך ה-SHA-1 צריך להיות באותיות קטנות.

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

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

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

הפעלה ב-

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

  • מארח
  • כתובת IP

תוצאות הפעולה

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

הערך יכול להיות True או False. הערך True אם נקודת הקצה ל-API החזירה את סטטוס 201 לכל ישות שסופקה והיא הופעלה בה, בתגובת JSON "status": "Pending", שמציינת שבקשת ה-API בוצעה בהצלחה. אם הפעולה נכשלת לפחות באחת מהישויות, התוצאה הסופית צריכה להיות כישלון (False).

שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "StopAndQuarantineFile",
    "requestor": "requestor-id",
    "requestorComment": "Stopping and quarantining putty",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
    "lastUpdateDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": {
        "fileIdentifier": "d932604ab8e9debe475415851fd26929a0c0dcd1",
        "fileIdentifierType": "Sha1"
    }
}
תובנות
  • סוג: ישות.
  • כותרת (מחרוזת): ישות.
  • IdentifierMessage (מחרוזת): "הקובץ עם גיבוב SHA-1‏ {0} הופסק והועבר להסגר ב-{1}". פורמט (filehash,entity.Identifier).

שליחת אינדיקטורים של ישויות

שליחת ישויות כאינדיקטורים ב-Microsoft Defender for Endpoint.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
פעולה DDL

חסימה

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

  • חסימה
  • ביקורת
  • חסימה ותיקון
  • אישור
כן

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

הערה: הערך "חסימה ותיקון" נתמך רק בישויות של גיבוב קבצים.

חוּמרה DDL

גבוהה

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

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

הפעלה ב-

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

  • כתובת IP
  • כתובת URL
  • Filehash

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר של נרתיק הטעינה
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

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

אם יש נתונים זמינים לישות אחת (is_success = true): "הישויות הבאות נשלחו בהצלחה כאינדיקטורים ל-Microsoft Defender for Endpoint: ‏{entity.identifier}".

אם הנתונים לא זמינים לישות אחת (is_success=true): "הפעולה לא הצליחה לשלוח את הישויות הבאות כאינדיקטורים ל-Microsoft Defender for Endpoint:‏ {entity.identifier}".

אם קוד הסטטוס 403 מדווח עבור ישות אחת: "למופע אין מספיק הרשאות כדי לשלוח עבור הישויות הבאות: {entity.identifier}

אם הנתונים לא זמינים לכל הישויות (is_success=false): "None of the provided entities were submitted as indicators to Microsoft Defender for Endpoint".

אם ישות היא כבר אינדיקטור: "הישויות הבאות הן כבר אינדיקטורים ב-Microsoft Defender for Endpoint:‏ {entity.identifier}"

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

אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או בעיה אחרת: "שגיאה בביצוע הפעולה 'שליחת אינדיקטורים של ישויות'. הסיבה: {0}''.format(error.Stacktrace)

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

כללי

ביטול הבידוד של המכונה

ביטול הבידוד של מכונה שבודדה בעבר באמצעות Microsoft Defender for Endpoint.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
תגובה String לא רלוונטי כן מציינים הערה שמסבירה למה צריך לבטל את הבידוד של המכונה.
ליצור תובנה? תיבת סימון סימן אישור אם הפעולה מופעלת, היא יוצרת תובנה ב-Google SecOps עם מידע קשור, אם היא בוצעה בהצלחה.

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

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

הפעלה ב-

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

  • מארח
  • כתובת IP

תוצאות הפעולה

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

הערך True אם נקודת הקצה ל-API החזירה את סטטוס 201 לכל ישות שסופקה והיא הופעלה בה, בתגובת JSON "status": "Pending", שמציינת שבקשת ה-API בוצעה בהצלחה. אם הפעולה נכשלת לפחות באחת מהישויות, התוצאה הסופית צריכה להיות כישלון (False).

שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "Unisolate",
    "requestor": "requestor-id",
    "requestorComment": "Unisolate machine due to the following remediation measures taken...",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
    "lastUpdateDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}
תובנות
  • סוג: ישות
  • כותרת: ישות.
  • ‫IdentifierMessage: הבידוד של Microsoft Defender for Endpoint הוסר.

התראה על עדכון

עדכון התראה ספציפית ב-Microsoft Defender for Endpoint. אפשר להשתמש בפעולה כדי לסגור התראה ב-Microsoft Defender for Endpoint.

פרמטרים

פרמטר סוג ערך ברירת המחדל Is Mandatory תיאור
מזהה ההתראה String לא רלוונטי כן מציינים את מזהה ההתראה של Microsoft Defender for Endpoint שרוצים לעדכן.
סטטוס DDL

חדש

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

  • חדש
  • InProgress
  • הסתיים
לא מציינים את הסטטוס החדש של ההתראה.
הוקצה ל: String לא רלוונטי לא כדי לעדכן את השדה הזה, צריך לציין את פרטי המשתמש.
סיווג DDL

לא ידוע

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

  • לא ידוע
  • FalsePositive
  • TruePositive
לא מציינים את הסיווג שרוצים לעדכן בהתראה.
החלטה DDL

NotAvailable

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

  • NotAvailable
  • דירה
  • תוכנה זדונית
  • SecurityPersonnel
  • SecurityTesting
  • UnwantedSoftware
  • אחר
לא מציינים את ההחלטה שרוצים לעדכן בהתראה.

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

  • משתמשים בפעולה כדי לעדכן אזהרה של Defender ATP.

  • אפשר להשתמש בפעולה כדי להתערב בתהליך עבודה שכולל ניתוח אזהרות של Defender ATP.

    אחרי שההתראה תעובד ב-Google SecOps, תוכלו להתעלם מההתראה ב-Defender ATP כדי שרשימות ההתראות ב-Defender ATP וב-Google SecOps יהיו זהות. אפשר גם לשנות את ההתראה כדי להציג את התקדמות הניתוח שלה (לדוגמה, להגדיר את המאפיין assignedTo או להגדיר את סטטוס ההתראה ל-inProgress).

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts/$entity",
    "id": "example-id",
    "incidentId": 1,
    "investigationId": null,
    "assignedTo": null,
    "severity": "Informational",
    "status": "Resolved",
    "classification": null,
    "determination": null,
    "investigationState": "UnsupportedAlertType",
    "detectionSource": "WindowsDefenderAtp",
    "category": "Execution",
    "threatFamilyName": null,
    "title": "[Test Alert] Suspicious Powershell commandline",
    "description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
    "alertCreationTime": "2019-11-18T11:17:48.287421Z",
    "firstEventTime": "2019-11-18T11:15:06.5226815Z",
    "lastEventTime": "2019-11-18T11:15:06.5226815Z",
    "lastUpdateTime": "2019-11-20T04:12:03.6066667Z",
    "resolvedTime": "2019-11-20T04:12:03.4976288Z",
    "machineId": "machine-id",
    "alertUser": {
        "accountName": "Administrator",
        "domainName": "example-domain"
    },
    "comments": [],
    "alertFiles": [
        {
            "sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
            "sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
            "filePath": "C:\\Windows\\System32\\cmd.exe",
            "fileName": "cmd.exe"
        },
        {
            "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
            "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
            "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
            "fileName": "powershell.exe"
        }
    ],
    "alertDomains": [],
    "alertIps": [],
    "alertProcesses": []
}

המתנה לסטטוס המשימה

מחכים לסטטוס של משימה.

פרמטרים

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

הפעלה ב-

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

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות של ערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[
    {
        "status": "Succeeded",
        "creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
        "cancellation_requestor": null,
        "cancellation_date_time_utc": null,
        "id": "2e39d22e-60a7-4267-899c-a1471e800000",
        "last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
        "related_file_info": null,
        "cancellation_comment": null,
        "requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
        "error_h_result": 0,
        "scope": "Selective",
        "machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
        "type": "Isolate",
        "requestor_comment": "test"
    }
]

מחברים

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

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

מחבר Microsoft Defender ATP

ה-API של Defender ATP SIEM שמשמש ב-Microsoft Defender ATP Connector לאירועים הוצא משימוש ב-1 במרץ 2022.

המחבר מתחבר מדי פעם לנקודת קצה ל-API של Defender ATP ומאחזר רשימה של התראות שנוצרו בתקופה מסוימת. לגבי ההתראות שעובדו, המחבר שולח בקשה נפרדת כדי לשלוף את המידע על הזיהויים מ-Defender ATP. לזיהויים יש שדה AlertId שאפשר להשתמש בו כדי לשייך את הזיהויים להתראות ספציפיות.

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

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

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
שם שדה המוצר String ProductName כן מתאר את שם השדה שבו מאוחסן שם המוצר.
שם השדה של האירוע String AlertName כן מתאר את שם השדה שבו מאוחסן שם האירוע.
שם השדה של הסביבה String "" לא

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

אם שדה הסביבה לא נמצא, הסביבה היא "".

תבנית ביטוי רגולרי של סביבה String .* לא

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

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

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

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

הרמה הבסיסית (root) של ה-API String https://api.securitycenter.windows.com כן

כתובת ה-URL הבסיסית של ה-API שמשמשת לשילוב.

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

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
מזהה Azure Active Directory String לא רלוונטי כן מזהה הדייר ב-Microsoft Entra, שמופיע ב-Active Directory > App Registration > האפליקציה שלך > Directory (tenant) ID.
מזהה הלקוח של השילוב String לא רלוונטי כן מזהה הלקוח (האפליקציה) שנוסף לרישום האפליקציה ב-Microsoft Entra לצורך השילוב.
סוד הלקוח של השילוב סיסמה לא רלוונטי כן הסוד שהוזן לרישום של אפליקציית Azure AD לשילוב.
מזהה לקוח SIEM String לא רלוונטי כן מזהה הלקוח (האפליקציה) של שילוב ה-SIEM שמופעל ב-Microsoft Defender for Endpoint.
סוד הלקוח של SIEM סיסמה לא רלוונטי כן סוד לשילוב SIEM מופעל ב-Microsoft Defender for Endpoint.
הפרש הזמן בשעות מספר שלם 24 כן אחזור התראות מ-X שעות אחורה.
מספר ההתראות המקסימלי בכל מחזור מספר שלם 100 כן מספר ההתראות שעובדו במהלך הפעלה אחת של המחבר.
סטטוסים של התראות לאחזור String Unknown, New, InProgress, Resolved כן

מציינים את הסטטוסים של ההתראות של Defender ATP ששרת Google SecOps צריך לאחזר.

הפרמטר יכול לקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

רמות החומרה של ההתראות שצריך לאחזר String לא צוין, מידע, נמוכה, בינונית, גבוהה כן

מציינים את רמות החומרה של ההתראות מ-Defender ATP ששרת Google SecOps צריך לאחזר.

הפרמטר יכול לקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

כתובת שרת ה-Proxy IP_OR_HOST לא רלוונטי לא שרת ה-proxy שבו צריך להשתמש לחיבור.
שם המשתמש של שרת ה-Proxy String לא רלוונטי לא שם המשתמש של שרת ה-Proxy.
סיסמת שרת ה-Proxy סיסמה לא רלוונטי לא סיסמה לשרת proxy.

כללי מחברים

  • המחבר לא תומך בכללים של רשימת חסימה או רשימה דינמית.

  • המחבר תומך בשרתי proxy.

Microsoft Defender ATP Connector V2

אחזור ההתראות של Defender ATP באמצעות ה-API של אירועי 365 Defender כדי לקבל את נתוני האירועים. אפשר להשתמש ברשימה הדינמית של המחבר כדי להטמיע רק סוגים ספציפיים של התראות על סמך ערך המאפיין detectionSource של ההתראה.

אפשר להשתמש במאפיין SourceGroupIdentifier של המחבר כדי לקבץ התראות על סמך מזהה האירוע ב-Defender ATP.

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

לפני שמגדירים את המחבר, צריך לתת הרשאות נוספות לאפליקציית Microsoft Entra:

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

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

  3. עוברים אל API Permissions > Add a permission > APIs my organization uses.

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

  5. בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:

    • Incident.Read.All
    • Incident.ReadWrite.All
  6. לוחצים על הוספת הרשאות.

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

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

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

שם הפרמטר לתצוגה סוג ערך ברירת המחדל חובה תיאור
שם שדה המוצר String :: כן מתאר את שם השדה שבו מאוחסן שם המוצר.
שם השדה של האירוע String EventName כן מתאר את שם השדה שבו מאוחסן שם האירוע.
שם השדה של הסביבה String "" לא

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

אם שדה הסביבה לא נמצא, הסביבה היא "".

תבנית ביטוי רגולרי של סביבה String .* לא

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

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

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

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

Defender ATP API Root String https://api.securitycenter.windows.com כן

כתובת ה-URL הבסיסית של ה-API לשילוב

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

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
365 Defender API Root String https://api.security.microsoft.com כן שורש ה-API של מכונת Microsoft 365 Defender שמשמשת לקבלת נתוני האירועים של Google SecOps.
מזהה Azure Active Directory String לא רלוונטי כן מזהה הדייר (tenant) ב-Microsoft Entra, שאפשר למצוא ב-Microsoft Entra > רישום אפליקציה > האפליקציה שלך > מזהה הספרייה (הדייר).
מזהה הלקוח של השילוב String לא רלוונטי כן מזהה הלקוח (האפליקציה) שנוסף לרישום האפליקציה ב-Microsoft Entra לצורך השילוב.
סוד הלקוח של השילוב סיסמה לא רלוונטי כן הסוד שהוזן לרישום של אפליקציית Azure AD לשילוב.
אימות SSL תיבת סימון סימן אישור כן אם המדיניות מופעלת, המערכת מאמתת שאישור ה-SSL לחיבור לשרת Microsoft 365 Defender תקף.
הפרש הזמן בשעות מספר שלם 24 כן אחזור התראות מ-X שעות אחורה.
מספר ההתראות המקסימלי בכל מחזור מספר שלם 10 כן מספר ההתראות שעובדו במהלך הפעלה אחת של המחבר.
סטטוסים של התראות לאחזור String Unknown, New, InProgress, Resolved כן

מציינים את הסטטוסים של ההתראות של Defender ATP ששרת Google SecOps צריך לאחזר.

הפרמטר יכול לקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

רמות החומרה של ההתראות שצריך לאחזר String לא צוין, מידע, נמוכה, בינונית, גבוהה כן

מציינים את רמות החומרה של ההתראות של Defender ATP ששרת Google SecOps צריך לאחזר.

הפרמטר יכול לקבל כמה ערכים כמחרוזת מופרדת בפסיקים.

השבתת התפריט הנפתח תיבת סימון התיבה לא מסומנת לא אם ההגדרה הזו מופעלת, המחבר מתעלם ממנגנון ההעברה.
זמן קצוב לתפוגה של הסקריפט מספר שלם 300 כן מציינים את הזמן הקצוב לתפוגה של הפעלת המחבר.
שימוש ברשימת ההיתרים כרשימת חסימה תיבת סימון התיבה לא מסומנת לא אם המדיניות מופעלת, הרשימה הדינמית משמשת כרשימת חסימה.
כתובת שרת ה-Proxy IP_OR_HOST לא רלוונטי לא שרת ה-proxy שבו צריך להשתמש לחיבור.
שם המשתמש של שרת ה-Proxy String לא רלוונטי לא שם המשתמש של שרת ה-Proxy.
סיסמת שרת ה-Proxy סיסמה לא רלוונטי לא סיסמה לשרת proxy.

כללי מחברים

המחבר תומך בלוגיקה של רשימה דינמית שמבוססת על ערך השדה של ההתראה ב-detectionSource Defender ATP.

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