تصدير أساليب التقييم وخصائصه لكل جهاز

مقالة
04/27/2024

ينطبق على:

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

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

يوفر الأساليب وتفاصيل الخصائص حول واجهات برمجة التطبيقات التي تسحب بيانات إدارة الثغرات الأمنية على أساس كل جهاز. هناك استدعاءات واجهة برمجة تطبيقات مختلفة للحصول على أنواع مختلفة من البيانات. بشكل عام، يحتوي كل استدعاء واجهة برمجة تطبيقات على البيانات المطلوبة للأجهزة في مؤسستك.

ملاحظة

ما لم يشار إلى خلاف ذلك، فإن جميع طرق تقييم التصدير المدرجة هي التصدير الكاملوالجهاز ( يشار إليه أيضا باسم لكل جهاز).

يمكنك استخدام واجهات برمجة تطبيقات تقييم التصدير لاسترداد (تصدير) أنواع مختلفة من المعلومات:

1. تصدير تقييم التكوينات الآمنة
2. تصدير تقييم مخزون البرامج
3. تصدير تقييم نقاط الضعف في البرامج
4. تصدير تقييم مخزون البرامج غير البرمجية للمنتج

يتم وصف واجهات برمجة التطبيقات التي تتوافق مع أنواع معلومات التصدير في الأقسام 1 و2 و3.

يحتوي كل أسلوب على استدعاءات واجهة برمجة تطبيقات مختلفة للحصول على أنواع مختلفة من البيانات. نظرا لأن كمية البيانات يمكن أن تكون كبيرة، فهناك طريقتان يمكن استردادهما:

استجابة JSON تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام حقل @odata.nextLink من الاستجابة لإحضار النتائج التالية.
عبر الملفات يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل جميع بياناتك من Azure Storage كما يلي:
- اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل مع جميع بيانات مؤسستك.
- قم بتنزيل جميع الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.

البيانات التي يتم جمعها باستخدام إما "استجابة JSON أو عبر الملفات" هي اللقطة الحالية للحالة الحالية. لا يحتوي على بيانات تاريخية. لجمع البيانات التاريخية، يجب على العملاء حفظ البيانات في مخازن البيانات الخاصة بهم.

1. تصدير تقييم التكوينات الآمنة

إرجاع جميع التكوينات وحالتها، على أساس كل جهاز.

1.1 أساليب

الاسلوب	نوع البيانات	الوصف
التكوين الآمن حسب مجموعة الأجهزة. راجع: 1.2 خصائص (استجابة JSON)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId، ConfigurationId. تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية.
التكوين الآمن حسب مجموعة الأجهزة. راجع: 1.3 خصائص (عبر الملفات)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId، ConfigurationId. يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل جميع بياناتك من Azure Storage كما يلي: اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل مع جميع بيانات مؤسستك. قم بتنزيل جميع الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.

1.2 خصائص (استجابة JSON)

الخاصية (المعرف)	نوع البيانات	الوصف
configurationCategory	سلسلة	الفئة أو التجميع الذي ينتمي إليه التكوين: التطبيق ونظام التشغيل والشبكة والحسابات وعناصر التحكم في الأمان.
معرف التكوين	سلسلة	معرف فريد لتكوين معين.
configurationImpact	سلسلة	تأثير مصنف للتكوين على درجة التكوين الإجمالية (1-10).
اسم التكوين	سلسلة	عرض اسم التكوين.
configurationSubcategory	سلسلة	الفئة الفرعية أو التجميع الفرعي الذي ينتمي إليه التكوين. في كثير من الحالات، قدرات أو ميزات محددة.
معرف الجهاز	سلسلة	معرف فريد للجهاز في الخدمة.
اسم الجهاز	سلسلة	اسم المجال المؤهل بالكامل (FQDN) للجهاز.
isApplicable	Bool	يشير إلى ما إذا كان التكوين أو النهج قابلا للتطبيق.
isCompliant	Bool	يشير إلى ما إذا كان التكوين أو النهج قد تم تكوينه بشكل صحيح.
isExpectedUserImpact	Bool	يشير إلى ما إذا كان المستخدم سيتأثر إذا كان سيتم تطبيق التكوين.
osPlatform	سلسلة	النظام الأساسي لنظام التشغيل الذي يعمل على الجهاز. أنظمة تشغيل محددة مع اختلافات داخل نفس العائلة، مثل Windows 10 Windows 11. راجع أنظمة التشغيل والأنظمة الأساسية والقدرات المدعومة للحصول على التفاصيل.
osVersion	سلسلة	إصدار محدد من نظام التشغيل الذي يعمل على الجهاز.
rbacGroupName	سلسلة	مجموعة التحكم في الوصول استنادا إلى الدور (RBAC). إذا لم يتم تعيين الجهاز إلى أي مجموعة RBAC، ستكون القيمة "غير معينة". إذا لم تحتوي المؤسسة على أي مجموعات RBAC، ستكون القيمة "بلا".
معرف rbacGroup	سلسلة	معرف مجموعة التحكم في الوصول استنادا إلى الدور (RBAC).
مرجع التوصية	سلسلة	مرجع إلى معرف التوصية المتعلق بالبرنامج.
الطابع الزمني	سلسلة	آخر مرة شوهد فيها التكوين على الجهاز.

1.3 خصائص (عبر الملفات)

الخاصية (المعرف)	نوع البيانات	الوصف
تصدير الملفات	array[string]	قائمة بعناوين URL للتنزيل للملفات التي تحتفظ باللقطة الحالية للمؤسسة.
وقت التوليد	سلسلة	الوقت الذي تم فيه إنشاء التصدير.

2. تصدير تقييم مخزون البرامج

إرجاع جميع البرامج المثبتة وتفاصيلها على كل جهاز.

2.1 أساليب

الاسلوب	نوع البيانات	الوصف
تصدير تقييم مخزون البرامج (استجابة JSON)	مخزون البرامج حسب مجموعة الأجهزة. راجع: 2.2 خصائص (استجابة JSON)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion. تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية.
تصدير تقييم مخزون البرامج (عبر الملفات)	مخزون البرامج حسب ملفات الجهاز. راجع: 2.3 خصائص (عبر الملفات)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion. يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل البيانات من Azure Storage كما يلي: اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل باستخدام بيانات مؤسستك قم بتنزيل الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.

2.2 خصائص (استجابة JSON)

الخاصية (المعرف)	نوع البيانات	الوصف
معرف الجهاز	سلسلة	معرف فريد للجهاز في الخدمة.
اسم الجهاز	سلسلة	اسم المجال المؤهل بالكامل (FQDN) للجهاز.
مسارات القرص	Array[string]	دليل القرص على تثبيت المنتج على الجهاز.
EndOfSupportDate	سلسلة	التاريخ الذي ينتهي فيه دعم هذا البرنامج أو سينتهي.
EndOfSupportStatus	سلسلة	حالة انتهاء الدعم. يمكن أن يحتوي على هذه القيم المحتملة: None، إصدار EOS، إصدار EOS القادم، برنامج EOS، برنامج EOS القادم.
NumberOfWeaknesses	الباحث	عدد نقاط الضعف في هذا البرنامج على هذا الجهاز.
OSPlatform	سلسلة	النظام الأساسي لنظام التشغيل الذي يعمل على الجهاز؛ أنظمة تشغيل محددة مع اختلافات داخل نفس العائلة، مثل Windows 10 Windows 11. راجع أنظمة التشغيل والأنظمة الأساسية والقدرات المدعومة للحصول على التفاصيل.
RbacGroupName	سلسلة	مجموعة التحكم في الوصول استنادا إلى الدور (RBAC). إذا لم يتم تعيين هذا الجهاز إلى أي مجموعة RBAC، ستكون القيمة "غير معينة". إذا لم تحتوي المؤسسة على أي مجموعات RBAC، ستكون القيمة "بلا".
معرف rbacGroup	سلسلة	معرف مجموعة التحكم في الوصول استنادا إلى الدور (RBAC).
مسارات التسجيل	Array[string]	دليل التسجيل على تثبيت المنتج في الجهاز.
الطابع الزمني ل SoftwareFirstSeen	سلسلة	في المرة الأولى التي شوهد فيها هذا البرنامج على الجهاز.
اسم البرنامج	سلسلة	اسم منتج البرنامج.
SoftwareVendor	سلسلة	اسم مورد البرنامج.
SoftwareVersion	سلسلة	رقم إصدار منتج البرنامج.

2.3 خصائص (عبر الملفات)

الخاصية (المعرف)	نوع البيانات	الوصف
تصدير الملفات	array[string]	قائمة بعناوين URL للتنزيل للملفات التي تحتفظ باللقطة الحالية للمؤسسة.
وقت التوليد	سلسلة	الوقت الذي تم فيه إنشاء التصدير.

3. تصدير تقييم نقاط الضعف في البرامج

إرجاع جميع الثغرات الأمنية المعروفة على الجهاز وتفاصيلها، لجميع الأجهزة.

3.1 أساليب

الاسلوب	نوع البيانات	الوصف
مجموعة التحقيق راجع: 3.2 خصائص (استجابة JSON)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId. تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية.
كيان التحقيق راجع: 3.3 خصائص (عبر الملفات)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId. يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل جميع بياناتك من Azure Storage كما يلي: اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل مع جميع بيانات مؤسستك. قم بتنزيل جميع الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.
مجموعة التحقيق راجع: 3.4 تصدير دلتا الخصائص (استجابة JSON)	إرجاع جدول مع إدخال لكل مجموعة فريدة من: DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId و EventTimestamp. تسحب واجهة برمجة التطبيقات البيانات في مؤسستك كاستجابات JSON. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية. يتم استخدام تقييم الثغرات الأمنية الكاملة للبرامج (استجابة JSON) للحصول على لقطة كاملة لتقييم الثغرات الأمنية للبرامج لمؤسستك حسب الجهاز. ومع ذلك، يتم استخدام استدعاء واجهة برمجة تطبيقات تصدير دلتا لجلب التغييرات التي حدثت بين تاريخ محدد والتاريخ الحالي فقط (استدعاء واجهة برمجة تطبيقات "دلتا"). بدلا من الحصول على تصدير كامل مع كمية كبيرة من البيانات في كل مرة، ستحصل فقط على معلومات محددة حول الثغرات الأمنية الجديدة والثابتة والمحدثة. يمكن أيضا استخدام استدعاء واجهة برمجة تطبيقات تصدير دلتا لحساب مؤشرات الأداء الرئيسية المختلفة مثل "كم عدد الثغرات الأمنية التي تم إصلاحها؟" أو "كم عدد الثغرات الأمنية الجديدة التي تمت إضافتها إلى مؤسستي؟" نظرا لأن استدعاء واجهة برمجة تطبيقات تصدير دلتا للثغرات الأمنية في البرامج يرجع البيانات لنطاق تاريخ مستهدف فقط، فإنه لا يعتبر تصديرا كاملا.

الاسلوب

نوع البيانات

الوصف

مجموعة التحقيق راجع: 3.2 خصائص (استجابة JSON)

إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId. تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية.

كيان التحقيق راجع: 3.3 خصائص (عبر الملفات)

إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId. يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل جميع بياناتك من Azure Storage كما يلي:

اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل مع جميع بيانات مؤسستك.
قم بتنزيل جميع الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.

مجموعة التحقيق راجع: 3.4 تصدير دلتا الخصائص (استجابة JSON)

إرجاع جدول مع إدخال لكل مجموعة فريدة من: DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion و CveId و EventTimestamp.

تسحب واجهة برمجة التطبيقات البيانات في مؤسستك كاستجابات JSON. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية. يتم استخدام تقييم الثغرات الأمنية الكاملة للبرامج (استجابة JSON) للحصول على لقطة كاملة لتقييم الثغرات الأمنية للبرامج لمؤسستك حسب الجهاز. ومع ذلك، يتم استخدام استدعاء واجهة برمجة تطبيقات تصدير دلتا لجلب التغييرات التي حدثت بين تاريخ محدد والتاريخ الحالي فقط (استدعاء واجهة برمجة تطبيقات "دلتا"). بدلا من الحصول على تصدير كامل مع كمية كبيرة من البيانات في كل مرة، ستحصل فقط على معلومات محددة حول الثغرات الأمنية الجديدة والثابتة والمحدثة. يمكن أيضا استخدام استدعاء واجهة برمجة تطبيقات تصدير دلتا لحساب مؤشرات الأداء الرئيسية المختلفة مثل "كم عدد الثغرات الأمنية التي تم إصلاحها؟" أو "كم عدد الثغرات الأمنية الجديدة التي تمت إضافتها إلى مؤسستي؟"

نظرا لأن استدعاء واجهة برمجة تطبيقات تصدير دلتا للثغرات الأمنية في البرامج يرجع البيانات لنطاق تاريخ مستهدف فقط، فإنه لا يعتبر تصديرا كاملا.

3.2 خصائص (استجابة JSON)

الخاصية (المعرف)	نوع البيانات	الوصف
معرف Cve	سلسلة	معرف فريد مخصص للثغرة الأمنية ضمن نظام الثغرات الأمنية الشائعة والتعرض (CVE).
CvssScore	سلسلة	درجة CVSS ل CVE.
معرف الجهاز	سلسلة	معرف فريد للجهاز في الخدمة.
اسم الجهاز	سلسلة	اسم المجال المؤهل بالكامل (FQDN) للجهاز.
مسارات القرص	Array[string]	دليل القرص على تثبيت المنتج على الجهاز.
مستوى قابلية الاستغلال	سلسلة	مستوى قابلية الاستغلال لهذه الثغرة الأمنية (NoExploit، ExploitIsPublic، ExploitIsVerified، ExploitIsInKit)
الطابع الزمني الأول ل FirstSeen	سلسلة	أول مرة شوهد فيها CVE لهذا المنتج على الجهاز.
معرف	سلسلة	معرف فريد للسجل.
الطابع الزمني ل LastSeen	سلسلة	آخر مرة شوهد فيها CVE على الجهاز.
OSPlatform	سلسلة	النظام الأساسي لنظام التشغيل الذي يعمل على الجهاز؛ أنظمة تشغيل محددة مع اختلافات داخل نفس العائلة، مثل Windows 10 Windows 11. راجع أنظمة التشغيل والأنظمة الأساسية والقدرات المدعومة للحصول على التفاصيل.
RbacGroupName	سلسلة	مجموعة التحكم في الوصول استنادا إلى الدور (RBAC). إذا لم يتم تعيين هذا الجهاز إلى أي مجموعة RBAC، ستكون القيمة "غير معينة". إذا لم تحتوي المؤسسة على أي مجموعات RBAC، ستكون القيمة "بلا".
معرف rbacGroup	سلسلة	معرف مجموعة التحكم في الوصول استنادا إلى الدور (RBAC).
مرجع التوصية	سلسلة	مرجع إلى معرف التوصية المتعلق بهذا البرنامج.
تحديث الأمان الموصى به	سلسلة	اسم أو وصف تحديث الأمان الذي يوفره مورد البرنامج لمعالجة الثغرة الأمنية.
RecommendedSecurityUpdateId	سلسلة	معرف تحديثات الأمان أو المعرف القابل للتطبيق للإرشادات المقابلة أو مقالات قاعدة معارف (KB).
مسارات التسجيل	Array[string]	دليل التسجيل على تثبيت المنتج في الجهاز.
SecurityUpdateAvailable	منطقي	يشير إلى ما إذا كان تحديث الأمان متوفرا للبرنامج.
اسم البرنامج	سلسلة	اسم منتج البرنامج.
SoftwareVendor	سلسلة	اسم مورد البرنامج.
SoftwareVersion	سلسلة	رقم إصدار منتج البرنامج.
مستوى الثغرات الأمنية	سلسلة	مستوى الخطورة الذي تم تعيينه للثغرة الأمنية استنادا إلى درجة CVSS.

3.3 خصائص (عبر الملفات)

الخاصية (المعرف)	نوع البيانات	الوصف
تصدير الملفات	array[string]	قائمة بعناوين URL للتنزيل للملفات التي تحتفظ باللقطة الحالية للمؤسسة.
وقت التوليد	سلسلة	الوقت الذي تم فيه إنشاء التصدير.

3.4 خصائص (استجابة JSON لتصدير دلتا)

الخاصية (المعرف)	نوع البيانات	الوصف
معرف Cve	سلسلة	معرف فريد مخصص للثغرة الأمنية ضمن نظام الثغرات الأمنية الشائعة والتعرض (CVE).
CvssScore	سلسلة	درجة CVSS ل CVE.
معرف الجهاز	سلسلة	معرف فريد للجهاز في الخدمة.
اسم الجهاز	سلسلة	اسم المجال المؤهل بالكامل (FQDN) للجهاز.
مسارات القرص	Array[string]	دليل القرص على تثبيت المنتج على الجهاز.
الطابع الزمني للحدث	سلسلة	وقت العثور على حدث دلتا.
مستوى قابلية الاستغلال	سلسلة	مستوى قابلية الاستغلال للثغرة الأمنية (NoExploit، ExploitIsPublic، ExploitIsVerified، ExploitIsInKit)
الطابع الزمني الأول ل FirstSeen	سلسلة	أول مرة شوهد فيها CVE للمنتج على الجهاز.
معرف	سلسلة	معرف فريد للسجل.
الطابع الزمني ل LastSeen	سلسلة	آخر مرة شوهد فيها CVE على الجهاز.
OSPlatform	سلسلة	النظام الأساسي لنظام التشغيل الذي يعمل على الجهاز؛ أنظمة تشغيل محددة مع اختلافات داخل نفس العائلة، مثل Windows 10 Windows 11. راجع أنظمة التشغيل والأنظمة الأساسية والقدرات المدعومة للحصول على التفاصيل.
RbacGroupName	سلسلة	مجموعة التحكم في الوصول استنادا إلى الدور (RBAC). إذا لم يتم تعيين هذا الجهاز إلى أي مجموعة RBAC، ستكون القيمة "غير معينة". إذا لم تحتوي المؤسسة على أي مجموعات RBAC، ستكون القيمة "بلا".
مرجع التوصية	سلسلة	مرجع إلى معرف التوصية المتعلق بهذا البرنامج.
تحديث الأمان الموصى به	سلسلة	اسم أو وصف تحديث الأمان الذي يوفره مورد البرنامج لمعالجة الثغرة الأمنية.
RecommendedSecurityUpdateId	سلسلة	معرف تحديثات الأمان أو المعرف القابل للتطبيق للإرشادات المقابلة أو مقالات قاعدة معارف (KB)
مسارات التسجيل	Array[string]	دليل التسجيل على تثبيت المنتج في الجهاز.
اسم البرنامج	سلسلة	اسم منتج البرنامج.
SoftwareVendor	سلسلة	اسم مورد البرنامج.
SoftwareVersion	سلسلة	رقم إصدار منتج البرنامج.
حاله	سلسلة	جديد (لثغرة أمنية جديدة تم تقديمها على جهاز). تم إصلاحه (لثغرة أمنية لم تعد موجودة على الجهاز، مما يعني أنه تمت معالجتها). تم التحديث (لثغرة أمنية على جهاز تم تغييره. التغييرات المحتملة هي: درجة CVSS، مستوى قابلية الاستغلال، مستوى الخطورة، DiskPaths، RegistryPaths، RecommendedSecurityUpdate).
مستوى الثغرات الأمنية	سلسلة	مستوى الخطورة المعين للثغرة الأمنية استنادا إلى درجة CVSS.

4. تصدير تقييم مخزون البرامج غير البرمجية للمنتج

إرجاع جميع البرامج المثبتة التي لا تحتوي على تعداد النظام الأساسي المشترك (CPE) وتفاصيلها على كل جهاز.

4.1 أساليب

الاسلوب	نوع البيانات	الوصف
تصدير تقييم مخزون البرامج غير البرمجية للمنتج (استجابة JSON)	مخزون البرامج غير البرمجية للمنتج حسب مجموعة الأجهزة. راجع: 4.2 خصائص (استجابة JSON)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion. تسحب واجهة برمجة التطبيقات جميع البيانات في مؤسستك كاستجابات JSON. هذا الأسلوب هو الأفضل للمؤسسات الصغيرة ذات الأجهزة الأقل من 100 كيلوبايت. يتم ترقيم الاستجابة، بحيث يمكنك استخدام @odata.nextLink الحقل من الاستجابة لجلب النتائج التالية.
تصدير تقييم مخزون البرامج غير البرمجية للمنتج (عبر الملفات)	مخزون البرامج غير البرمجية للمنتج حسب ملفات الجهاز. راجع: 4.3 خصائص (عبر الملفات)	إرجاع جدول مع إدخال لكل مجموعة فريدة من DeviceId و SoftwareVendor و SoftwareName و SoftwareVersion. يتيح حل واجهة برمجة التطبيقات هذا سحب كميات أكبر من البيانات بشكل أسرع وأكثر موثوقية. لذلك، يوصى به للمؤسسات الكبيرة، مع أكثر من 100 كيلوبايت من الأجهزة. تسحب واجهة برمجة التطبيقات هذه جميع البيانات في مؤسستك كملفات تنزيل. تحتوي الاستجابة على عناوين URL لتنزيل جميع البيانات من Azure Storage. تمكنك واجهة برمجة التطبيقات هذه من تنزيل البيانات من Azure Storage كما يلي: اتصل بواجهة برمجة التطبيقات للحصول على قائمة بعناوين URL للتنزيل باستخدام بيانات مؤسستك قم بتنزيل الملفات باستخدام عناوين URL للتنزيل ومعالجة البيانات كما تريد.

4.2 خصائص (استجابة JSON)

الخاصية (المعرف)	نوع البيانات	الوصف
معرف الجهاز	سلسله	معرف فريد للجهاز في الخدمة.
اسم الجهاز	سلسله	اسم المجال المؤهل بالكامل (FQDN) للجهاز.
OSPlatform	سلسله	النظام الأساسي لنظام التشغيل الذي يعمل على الجهاز. هذه أنظمة تشغيل محددة مع اختلافات داخل نفس العائلة، مثل Windows 10 Windows 11. راجع أنظمة التشغيل والأنظمة الأساسية والقدرات المدعومة للحصول على التفاصيل.
RbacGroupName	سلسله	مجموعة التحكم في الوصول استنادا إلى الدور (RBAC). إذا لم يتم تعيين هذا الجهاز إلى أي مجموعة RBAC، ستكون القيمة "غير معينة". إذا لم تحتوي المؤسسة على أي مجموعات RBAC، ستكون القيمة "بلا".
RbacGroupId	سلسله	معرف مجموعة التحكم في الوصول استنادا إلى الدور (RBAC).
الطابع الزمني ل SoftwareLastSeen	سلسله	آخر مرة شوهد فيها هذا البرنامج على الجهاز.
اسم البرنامج	سلسله	اسم منتج البرنامج.
SoftwareVendor	سلسله	اسم مورد البرنامج.
SoftwareVersion	سلسله	رقم إصدار منتج البرنامج.

4.3 خصائص (عبر الملفات)

الخاصية (المعرف)	نوع البيانات	الوصف
تصدير الملفات	array[string]	قائمة بعناوين URL للتنزيل للملفات التي تحتفظ باللقطة الحالية للمؤسسة.
وقت التوليد	سلسلة	الوقت الذي تم فيه إنشاء التصدير.

راجع أيضًا

أخرى ذات صلة

تلميح

هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.

مشاركة عبر