גש לממשקי ה- API של Microsoft Defender עבור נקודת קצה

  • חל על: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender for Business

חשוב

יכולות ציד מתקדמות אינן נכללות Defender for Business.

הערה

אם אתה לקוח של ממשלת ארה"ב, השתמש בURI המפורטים ב- Microsoft Defender עבור נקודת קצה עבור לקוחות של ממשלת ארה"ב.

Defender for Endpoint חושף חלק גדול מהנתונים והפעולות שלו באמצעות קבוצה של ממשקי API תיכנותיים. ממשקי API אלה יאפשרו לך להפוך זרימות עבודה וחדשות לאוטומטיות בהתבסס על יכולות של Defender for Endpoint. גישת ה- API מחייבת אימות OAuth2.0. לקבלת מידע נוסף, ראה זרימת קוד הרשאה של OAuth 2.0.

צפה בסרטון וידאו זה לקבלת סקירה מהירה של ממשקי ה- API של Defender for Endpoint.

באופן כללי, יהיה עליך לבצע את השלבים הבאים כדי להשתמש בממשקי ה- API:

  • יצירת יישום Microsoft Entra חדש
  • קבל אסימון גישה באמצעות יישום זה
  • השתמש לאסימון כדי לגשת ל- API של Defender for Endpoint

באפשרותך לגשת ל- API של Defender for Endpoint עם הקשר יישום או הקשר משתמש.

  • הקשר יישום: (מומלץ)

    נמצא בשימוש על-ידי אפליקציות שיפעלו ללא משתמש מחובר. לדוגמה, אפליקציות שפועלות כ'שירותי רקע' או 'Daemons'.

    שלבים שיש לבצע כדי לגשת ל- API של Defender for Endpoint עם הקשר יישום:

    1. צור יישום Microsoft Entra אינטרנט חדש.

    2. הקצה את ההרשאה הרצויה ליישום, לדוגמה, 'קרא התראות', 'מחשבים מבודדים'.

    3. צור מפתח עבור יישום זה.

    4. קבל אסימון באמצעות היישום עם המפתח שלו.

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

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

  • הקשר משתמש:

    משמש לביצוע פעולות ב- API בשם משתמש.

    השלבים שיש לבצע כדי לגשת ל- API של Defender for Endpoint עם הקשר משתמש:

    1. צור Microsoft Entra Native-Application.

    2. הקצה את ההרשאה הרצויה ליישום, למשל 'קריאת התראות', 'מחשבים מבודדים' וכו'.

    3. קבל אסימון באמצעות היישום עם אישורי משתמש.

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

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

עצה

כאשר נדרשת יותר מבקשת שאילתה אחת כדי לאחזר את כל התוצאות, Microsoft Graph @odata.nextLink מחזיר מאפיין בתגובה המכיל כתובת URL לדף התוצאות הבא. לקבלת מידע נוסף, ראה קידוד נתוני Microsoft Graph באפליקציה שלך.

  • Last updated on