Microsoft Defender For Endpoint
במאמר הזה מוסבר איך לשלב את Microsoft Defender For Endpoint עם Google SecOps.
תרחישים לדוגמה
להשתמש בנתונים שנאספו ב-Microsoft Defender for Endpoint כדי להעשיר את המידע בזמן חקירה של מקרה מסוים.
מנתחי נתונים יכולים להשתמש בנתונים שנאספים ונשמרים ב-Microsoft Defender for Endpoint בחקירות – לדוגמה, כדי לקבל מידע על התראות שזוהו ב-Microsoft Defender for Endpoint או להציג רשימה של מכונות שרשומות ב-Microsoft Defender for Endpoint.
לבצע פעולות תגובה אקטיביות באירועי אבטחה פוטנציאליים, כמו בידוד מארח ספציפי מרשת או הפעלת סריקת אנטי-וירוס.
עוקבים אחרי ההתראות של Microsoft Defender for Endpoint ובודקים אותן בתור התראות של Google Security Operations, שנשלפות על ידי המחבר המתאים.
דרישות מוקדמות
לפני שמגדירים את השילוב בפלטפורמת Google SecOps, צריך לבצע את השלבים הבאים:
יוצרים את אפליקציית Microsoft Entra.
מגדירים את הרשאות ה-API לאפליקציה.
יוצרים סוד לקוח.
כשניגשים ל-Microsoft Defender for Endpoint API, מומלץ להשתמש בהקשר של האפליקציה במקום בהקשר של המשתמש.
יצירת אפליקציית Microsoft Entra
נכנסים לפורטל Azure כאדמין של משתמשים או כאדמין של סיסמאות.
בוחרים באפשרות Microsoft Entra ID.
עוברים אל App registrations > New registration.
כותבים את שם האפליקציה.
לוחצים על הרשמה.
שומרים את הערכים של Application (client) ID ו-Directory (tenant) ID כדי להשתמש בהם בהמשך, כשמגדירים את הפרמטרים של השילוב.
הגדרת הרשאות API
עוברים אל API Permissions > Add a permission > APIs my organization uses. תיבת הדו-שיח בקשת הרשאות API נפתחת.
בשדה Search, מזינים
WindowsDefenderATP.בוחרים באפשרות WindowsDefenderATP > הרשאות לאפליקציה.
בסוג ההרשאה התראה, בוחרים את ההרשאה הבאה:
Alert.Read.All
לוחצים על הוספת הרשאות.
בדף API Permissions, לוחצים על Add a permission.
בוחרים באפשרות Microsoft Graph > Delegated permissions.
בקטע Select Permissions, בוחרים את ההרשאה הנדרשת הבאה:
User.Read
לוחצים על הוספת הרשאות.
בדף API Permissions, לוחצים על Add a permission.
בוחרים באפשרות WindowsDefenderATP > הרשאות לאפליקציה.
בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:
AdvancedQuery.Read.AllAlert.Read.AllAlert.ReadWrite.AllEvent.WriteFile.Read.AllIp.Read.AllMachine.IsolateMachine.Read.AllMachine.ReadWrite.AllMachine.ScanMachine.StopAndQuarantineTi.ReadWriteUrl.Read.AllUser.Read.All
לוחצים על 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.
יצירת סוד לקוח
עוברים אל Certificates and secrets > New client secret.
מזינים תיאור של סוד הלקוח ומגדירים את תאריך התפוגה שלו.
לוחצים על הוספה.
שומרים את הערך של סוד הלקוח (לא את מזהה הסוד) כדי להשתמש בו כערך הפרמטר
Client Secretכשמגדירים את השילוב. הערך של סוד הלקוח מוצג רק פעם אחת.
הפעלת השילוב של SIEM – הוצא משימוש
בחלונית הניווט, לוחצים על הגדרות > SIEM.
בוחרים באפשרות הפעלת שילוב 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 שמשמשת לשילוב. כדי לשפר את הביצועים, אפשר להשתמש בשרת שהכי קרוב למיקום שלכם:
ערך ברירת המחדל הוא |
פעולות
מחיקת אינדיקטורים של ישויות
למחוק אינדיקטורים של ישויות ב-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. פורמט לדוגמה: |
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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
|
הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה 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:
HostnameIP Address
קלט של הפעולה
כדי להשתמש בפעולה Get Machine Recommendations, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Max Recommendations To Return |
חובה. מספר ההמלצות המקסימלי שאפשר לאחזר לכל ישות. הערך המקסימלי הוא ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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:
HostnameIP Address
קלט של הפעולה
הפעולה Get Machine Vulnerabilities דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Severity Filter |
זה שינוי אופציונלי. רמות החומרה שמשמשות לסינון נקודות החולשה שמוחזרות. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Threat Filter |
זה שינוי אופציונלי. הקריטריונים של מודיעין איומי הסייבר שמשמשים לסינון נקודות החולשה שמוחזרות. הערכים האפשריים הם:
|
Sort By |
זה שינוי אופציונלי. השדה שמשמש למיון נקודות החולשה שמוחזרות. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Sort Order |
זה שינוי אופציונלי. הסדר שבו מוצגות התוצאות הממוינות. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Max Vulnerabilities To Return |
חובה. מספר נקודות החולשה המקסימלי שיוחזרו לכל ישות. הערך המקסימלי הוא ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 |
חובה. מספר ההתראות המקסימלי שאפשר לאחזר לכל משתמש. הערך המקסימלי הוא ערך ברירת המחדל הוא |
ערכי פלט של פעולות
הפעולה קבלת התראות שקשורות למשתמש מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור לקיר של המארז | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קונסולה צמוד לקיר | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת 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 יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
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 | חדש ערכים אפשריים:
|
לא | מציינים את הסטטוס החדש של ההתראה. |
| הוקצה ל: | String | לא רלוונטי | לא | כדי לעדכן את השדה הזה, צריך לציין את פרטי המשתמש. |
| סיווג | DDL | לא ידוע ערכים אפשריים:
|
לא | מציינים את הסיווג שרוצים לעדכן בהתראה. |
| החלטה | DDL | NotAvailable ערכים אפשריים:
|
לא | מציינים את ההחלטה שרוצים לעדכן בהתראה. |
תרחישים לדוגמה
משתמשים בפעולה כדי לעדכן אזהרה של 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 | .* | לא | תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה ברירת המחדל היא .* כדי לכלול את הכול ולהחזיר את הערך ללא שינוי. משמש כדי לאפשר למשתמש לשנות את שדה הסביבה באמצעות הלוגיקה של הביטוי הרגולרי. אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא "". |
| הרמה הבסיסית (root) של ה-API | String | https://api.securitycenter.windows.com | כן | כתובת ה-URL הבסיסית של ה-API שמשמשת לשילוב. כדי לשפר את הביצועים, אתם יכולים להשתמש בשרת שהכי קרוב למיקום שלכם:
|
| מזהה 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:
נכנסים לפורטל Azure כאדמין של משתמשים או כאדמין של סיסמאות.
בוחרים באפשרות Microsoft Entra ID.
עוברים אל API Permissions > Add a permission > APIs my organization uses.
בוחרים באפשרות Microsoft Threat Protection > Application permissions.
בקטע Select Permissions, בוחרים את ההרשאות הנדרשות הבאות:
Incident.Read.AllIncident.ReadWrite.All
לוחצים על הוספת הרשאות.
לוחצים על Grant admin consent for
YOUR_ORGANIZATION_NAME.
פרמטרים של מחברים
כדי להגדיר את המחבר, משתמשים בפרמטרים הבאים:
| שם הפרמטר לתצוגה | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| שם שדה המוצר | String | :: | כן | מתאר את שם השדה שבו מאוחסן שם המוצר. |
| שם השדה של האירוע | String | EventName | כן | מתאר את שם השדה שבו מאוחסן שם האירוע. |
| שם השדה של הסביבה | String | "" | לא | מתאר את שם השדה שבו מאוחסן שם הסביבה. אם שדה הסביבה לא נמצא, הסביבה היא "". |
| תבנית ביטוי רגולרי של סביבה | String | .* | לא | תבנית של ביטוי רגולרי להפעלה על הערך שנמצא בשדה ברירת המחדל היא .* כדי לכלול את הכול ולהחזיר את הערך ללא שינוי. משמש כדי לאפשר למשתמש לשנות את שדה הסביבה באמצעות הלוגיקה של הביטוי הרגולרי. אם תבנית הביטוי הרגולרי היא null או ריקה, או אם ערך הסביבה הוא null, התוצאה הסופית של הסביבה היא "". |
| Defender ATP API Root | String | https://api.securitycenter.windows.com | כן | כתובת ה-URL הבסיסית של ה-API לשילוב כדי לשפר את הביצועים, אתם יכולים להשתמש בשרת שהכי קרוב למיקום שלכם:
|
| 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.