مشاركة عبر

الحصول على واجهة برمجة تطبيقات مستخدمي تسجيل الدخول إلى الجهاز

  • مقالة

ينطبق على:

هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.

ملاحظة

إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات URI المدرجة في Microsoft Defender لنقطة النهاية لعملاء حكومة الولايات المتحدة.

تلميح

للحصول على أداء أفضل، يمكنك استخدام الخادم الأقرب إلى موقعك الجغرافي:

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

وصف واجهة برمجة التطبيقات

استرداد مجموعة من المستخدمين المسجلين على جهاز معين.

القيود

  1. يمكنك الاستعلام عن آخر تحديث للتنبيهات وفقا لفترة الاستبقاء التي تم تكوينها.
  2. قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

الأذونات

أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة تطبيقات Microsoft Defender لنقطة النهاية

نوع الإذن إذن اسم عرض الإذن
Application User.Read.All "قراءة ملفات تعريف المستخدمين"
مفوض (حساب العمل أو المؤسسة التعليمية) User.Read.All "قراءة ملفات تعريف المستخدمين"

ملاحظة

عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:

  • يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "عرض البيانات". لمزيد من المعلومات، راجع إنشاء الأدوار وإدارتها.
  • ستشمل الاستجابة المستخدمين فقط إذا كان الجهاز مرئيا للمستخدم، استنادا إلى إعدادات مجموعة الأجهزة. لمزيد من المعلومات، راجع إنشاء مجموعات الأجهزة وإدارتها.

يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.

طلب HTTP

GET /api/machines/{id}/logonusers

عناوين الطلبات

الاسم نوع الوصف
إذن سلسلة الحامل {token}. مطلوب.

نص الطلب

أجوف

استجابه

إذا كان ناجحا وكان الجهاز موجودا - 200 موافق مع قائمة كيانات المستخدم في النص الأساسي. إذا لم يتم العثور على الجهاز - 404 غير موجود.

مثل

طلب

فيما يلي مثال على الطلب.

GET https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/logonusers

استجابه

فيما يلي مثال على الاستجابة.

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Users",
    "value": [
        {
            "id": "contoso\\user1",
            "accountName": "user1",
            "accountDomain": "contoso",
            "firstSeen": "2019-12-18T08:02:54Z",
            "lastSeen": "2020-01-06T08:01:48Z",
            "logonTypes": "Interactive",
            "isDomainAdmin": true,
            "isOnlyNetworkUser": false
        },
        ...
    ]
}

تلميح

هل تريد معرفة المزيد؟ التفاعل مع مجتمع أمان Microsoft في مجتمع التكنولوجيا لدينا: Microsoft Defender for Endpoint Tech Community.