Microsoft Defender XDR API של אירועים וסוג המשאב 'אירועים'

  • מאמר

חל על:

הערה

נסה את ממשקי ה- API החדשים שלנו באמצעות API של אבטחה של MS Graph. קבל מידע נוסף ב: השתמש ב- API לאבטחה של Microsoft Graph - Microsoft Graph | Microsoft Learn.

חשוב

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

מקרה הוא אוסף של התראות קשורות שמסייעות בתיאר התקפה. אירועים מישויות שונות בארגון שלך נצברים באופן אוטומטי על-ידי Microsoft Defender XDR. באפשרותך להשתמש ב- API של האירועים כדי לגשת באופן תיכנותי למקרי הארגון שלך ולהתראות קשורות.

מיכסות והקצאת משאבים

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

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

הרשאות

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

שיטות

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

בקש גוף, תגובה ודוגמאות

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

מאפיינים משותפים

המאפיין סוג תיאור
מזהה אירוע זמן מזהה ייחודי של אירוע.
redirectIncidentId ארוך הניתן ל- Null מזהה האירוע שהתקרית הנוכחית מוזגה לו.
שם אירוע מחרוזת שם האירוע.
createdTime DateTimeOffset התאריך והשעה (ב- UTC) שהתקרית נוצרה.
lastUpdateTime DateTimeOffset התאריך והשעה (ב- UTC) האירוע עודכן לאחרונה.
Assignedto מחרוזת הבעלים של האירוע.
חומרת Enum חומרת האירוע. הערכים האפשריים הם: UnSpecified, Informational, Low, Mediumו- High.
מצב Enum מציין את המצב הנוכחי של האירוע. הערכים האפשריים הם: Active, InProgress, Resolved, ו- Redirected.
סיווג Enum מפרט המקרה. הערכים האפשריים הם: TruePositive, Informational, expected activity, ו- FalsePositive.
נחישות Enum מציין את קביעה של המקרה.

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

  • חיובי אמיתי: Multistage attack (MultiStagedAttack), Malicious user activity (MaliciousUserActivity), Compromised account (CompromisedUser) – שקול לשנות את שם הספירה ב- api הציבורי בהתאם, Malware (תוכנות זדוניות), Phishing (דיוג), Unwanted software (UnwantedSoftware) Other וכן (אחר).
  • מידע, פעילות צפויה:Security test (SecurityTesting), Line-of-business application (LineOfBusinessApplication), Confirmed activity (ConfirmedUserActivity) - שקול לשנות את שם הספירה ב- api הציבורי בהתאם וכן Other (אחר).
  • חיובית מוטעית:Not malicious (נקי) - שקול לשנות את שם הספירה ב- api הציבורי בהתאם, Not enough data to validate (InsufficientData) ו- Other (אחר).
    		•
    תגיות רשימת מחרוזות רשימה של תגיות מקרה.
    הערות רשימה של הערות מקרה אובייקט Comment של אירוע מכיל: מחרוזת הערה, createdBy string ו- createTime date time.
    התראות רשימת התראות רשימת התראות קשורות. עיין בדוגמאות בתיעוד API של List incidents .

    הערה

    סביב 29 באוגוסט 2022, ערכי קביעת ההתראה הנתמכים בעבר (AptSecurityPersonnelו- ) לא יהיו עוד זמינים דרך ה- API.

    עצה

    האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: קהילת האבטחה של Microsoft Defender XDR.