خلال 5 إلى 7 دقائق، ستثبّت Fendix وتفحص واجهة برمجة تطبيقات لديك تصريح لاختبارها، ثم تفهم الفرق بين النتيجة الأمنية وقرار الإصدار.
قبل أن تبدأ
- استخدم macOS أو Linux مع صدفة متوافقة مع POSIX لهذا المسار.
- اختر واجهة برمجة تطبيقات في بيئة تطوير أو مرحلية تملكها أو لديك تصريح صريح لاختبارها.
- يستخدم هذا التشغيل الأول فحوصات سلبية، وتبقى اختبارات الحقن النشطة معطلة.
تثبيت Fendix
ينزّل المسار المستقر ذو الأمر الواحد الإصدار الحالي، ويتحقق من بصمة SHA-256، ثم يضع الملف التنفيذي ضمن PATH.
curl -fsSL https://get.fendix.dev/install.sh | sh
fendix versionتشغيل الفحص الأول
وجّه Fendix إلى الهدف المصرّح به. ينشئ الأمر تقرير HTML يمكنك حفظه ومراجعته.
fendix scan \
--url https://staging.example.com \
--format html \
--output report.htmlفتح النتيجة
افتح report.html في المتصفح. ابدأ بقرار الإصدار، ثم راجع التغطية وأدلة كل نتيجة. يفيد رمز الخروج في الأتمتة، لكن التقرير يوضح سبب الوصول إلى المحصلة.
open report.html # macOS
xdg-open report.html # Linuxفهم النتيجة الأمنية
استخدم هذا السيناريو المختصر لفهم النموذج. السيناريو توضيحي، أما تقريرك فيعكس أدلة هدفك الفعلية.
- النتيجة
SEC-001حالة أمنية مرصودة لها أدلتها ومصدرها.- الخطورة
HIGHحجم الأثر المحتمل إذا كانت الحالة حقيقية.- التصرّف
WARNالأدلة الحالية لا تبرر المنع وفق سياسة النتائج المطبقة.
فهم قرار الإصدار
أضف الآن حالة التغطية. تشترط سياسة الإصدار SCA، لكن أدلة التبعيات المطلوبة لم تصل. تبقى النتيجة HIGH → WARN، وتجعل حقيقة التغطية المستقلة قرار الإصدار INCOMPLETE.
اختياري: الإضافة إلى CI
حدد الحد والتغطية المطلوبة والتقرير الذي يجب على CI حفظه قبل كتابة YAML الخاص بالمزوّد. تعيد النتيجة المانعة رمز الخروج 1، بينما يعيد عقد الفحص أو التغطية الصارم غير المستوفى الرمز 2.
fendix scan --code . --fail-on HIGH --format sarif --output results.sarifاختر خطوتك التالية
- لفهم النظام: نموذج القرار في Fendix.
- لفحص الشيفرة المصدرية أو دمج المدخلات: نظرة عامة على الفحص.
- لفحص المسارات المحمية: الفحص باستخدام المصادقة.
- لإغلاق القرار عند غياب الأدلة: اشتراط التغطية.
- لضبط القيمة الافتراضية للمستودع: تهيئة سياسة الإصدار.
- للبحث عن الصيغة الدقيقة: مرجع CLI.