تجيب النتائج عمّا إذا كانت الأدلة المسلّمة قد حددت حالة أمنية. وتجيب التغطية عمّا إذا كانت مصادر الأدلة المطلوبة قد عملت ولبّت السياسة.
حالات المحلل الخام
يسجل عقد التغطية v1 ثلاث حالات فقط في scanner_status. تعني الحالة ok أن المحلل اكتمل؛ ويبقى عدد النتائج وسجلات الأدلة منفصلين، لذلك لا تميّز ok بين صفر نتائج ونتيجة واحدة أو أكثر.
فئات دورة الحياة المشتقة
| الفئة | المعنى | فجوة محرك | تلبي --require-analyzers |
|---|---|---|---|
| ok | اكتمل تشغيل المحلل، وقد تكون محصلته صفر نتائج بصورة صحيحة. | لا | نعم |
| not_applicable | لا يحتاج الإدخال المطلوب إلى هذا المحلل، أو لم تتغير الملفات المعنية. | لا | نعم |
| disabled | منعت التهيئة تشغيل المحلل عمدًا. | لا | لا |
| unavailable | هُيئ المحلل للعمل لكن اعتمادًا مطلوبًا كان مفقودًا. تمثل هذه الحالة فجوة في تغطية المحرك. | نعم | لا |
| unsupported | شكل الهدف خارج العقد المدعوم للمحلل، وتُسجل الحالة كقيد. | لا | لا |
| failed | بدأ المحلل أو كان مطلوبًا لكنه لم يسلّم اكتمالًا موثوقًا. تمثل هذه الحالة فجوة في تغطية المحرك. | نعم | لا |
| unknown | لا يمكن تصنيف اقتران حالة وسبب قديم أو غير صالح بأمان. | لا | لا |
سجل الأسباب المغلق
تستخدم الحالة skipped سبب تخطٍ، وتستخدم الحالة failed سبب فشل. ويجب ألا يستنتج المستهلك الفئة من التفاصيل النصية الحرة.
| السبب | الحالة الخام | الفئة | فجوة محرك |
|---|---|---|---|
| not_applicable | skipped | not_applicable | لا |
| diff_unchanged | skipped | not_applicable | لا |
| disabled_by_flag | skipped | disabled | لا |
| disabled_offline | skipped | disabled | لا |
| dependency_missing | skipped | unavailable | نعم |
| unsupported_target | skipped | unsupported | لا |
| network_error | failed | failed | نعم |
| timeout | failed | failed | نعم |
| execution_error | failed | failed | نعم |
| malformed_output | failed | failed | نعم |
| truncated_output | failed | failed | نعم |
| input_error | failed | failed | نعم |
| no_endpoints | failed | failed | نعم |
التغطية المطلوبة
تصبح قيمة configured_complete في المحرك false لفئتي unavailable وfailed. أما عقد --require-analyzers الصريح فأشد: لا يلبي المتطلب المسمى إلا ok وnot_applicable. وتصبح المحللات المعطلة أو غير المدعومة أو المفقودة أو غير المسجلة فجوات مطلوبة.
لماذا يكون قرار الإصدار INCOMPLETE؟
| المدخل | الحقيقة المرصودة | الأثر في القرار |
|---|---|---|
| SAST | تدعم الأدلة المتاحة نتيجة بخطورة HIGH وتصرف WARN. | WARN |
| DAST | اكتمل مصدر الأدلة الحية المطلوب. | تغطية مسلّمة |
| SCA | تشترط السياسة أدلة التبعيات، لكن المحلل المطلوب لم يسلّمها. | INCOMPLETE |
لا تجعل نتيجة WARN الإصدار INCOMPLETE. السبب هو غياب تغطية SCA المطلوبة. ولا تحول Fendix هذه الفجوة إلى نتيجة ثغرة.
توثيق مرتبط
مفهوم التغطية · سجل المحللات · اشتراط التغطية · خيارات تغطية scan