Veto

عميل VirusTotal مفتوح المصدر لأندرويد

مجاني ومفتوح المصدر. استخدم مفتاح API الخاص بك من VirusTotal لفحص الملفات والروابط والتطبيقات المثبتة عبر أكثر من 70 محركًا، بواجهة Material 3. لا حسابات، لا تتبع، لا إعلانات.

ما هو Veto؟

Veto هو عميل Android لـ VirusTotal. أرسل ملفًا أو رابطًا أو تطبيقًا مثبتًا لعرض نتائج التحليل في الوقت الفعلي. يعرض التطبيق تقريرًا واضحًا يتراوح من حكم موحد واحد إلى المجموعة الكاملة من الحقول التي تُرجعها الخدمة.

المشروع مجاني ومفتوح المصدر، ولا يحتوي على أي حسابات مستخدمين أو أنظمة تتبع أو إعلانات. نظرًا لأن المستخدمين يقدمون مفتاح API الخاص بهم لـ VirusTotal، فإن جميع عمليات الفحص تتم مباشرة تحت حسابهم الشخصي دون المرور عبر خوادم وسيطة تابعة لجهات خارجية.

لقطات الشاشة

مجموعة الميزات

• قدرة الفحص: فحص التطبيقات المثبتة، أو الملفات المحلية، أو عناوين URL المستهدفة.
• تجميع متعدد المحركات: يجمع التشخيصات من أكثر من 70 محركًا لمكافحة الفيروسات.
• وضعا الإبلاغ المزدوجان: وضع سريع لملخصات التحقق السريع، ووضع مفصل للفحص العميق.
• تفسيرات سياقية: يوجد نص توضيحي لكل قسم، مع إمكانية إخفاء التفسيرات إذا رغبت.
• تقارير عالية الدقة: يعرض تجزئات الملفات، تصنيفات التهديدات، السجل، تصويتات المجتمع، سلوكيات الصندوق الرملي، مطابقات YARA، تفاصيل تطبيقات Android الداخلية، وجميع حقول حمولة API الإضافية.
• التنفيذ في الخلفية: تتبع تقدم التحميل والتحليل في الوقت الفعلي يستمر داخل خدمة خلفية.
• الوصول دون اتصال: يحفظ التقارير محليًا للسماح بمراجعتها لاحقًا، حتى بدون اتصال بالإنترنت.
• تحذيرات حد المعدل: يعرض إشعارات واضحة عندما يصل مفتاح API المحلي إلى حد المعدل.
• السمات: دعم كامل لـ Material 3 مع ألوان النظام الديناميكية، ودعم السمات الفاتحة والداكنة.

تفاصيل تنفيذ البنية الأساسية

• مزامنة الحالة: يعمل ScanManager على نطاق التطبيق كمصدر مركزي للحقيقة لجميع حالات الفحص. يضمن ذلك بقاء واجهة المستخدم متزامنة سواء كان التطبيق نشطًا في المقدمة، أو معلقًا في الخلفية، أو تم تدميره بواسطة نظام التشغيل.
• الاستقصاء المرن: يطلب التطبيق نقطة النهاية /analyses/{id} باستخدام حد زمني قدره ست دقائق. إذا تمت مواجهة استجابة حد معدل، تنتظر العملية بدلاً من الفشل. تتم إعادة جلب التقرير حتى يتم ملء النتائج، مع إرجاع حالة فشل منظمة إذا تم الوصول إلى حد المهلة.
• دورة حياة العملية: بينما توجد ScanState داخل ScanManager لتحمل تدمير النشاط، تحافظ ScanService على دورة حياة العملية أثناء العمليات النشطة وتدير الإشعارات الجارية وعند الانتهاء.
• تحليل كامل الدقة: يتم التقاط الحقول الشائعة باستخدام نماذج مكتوبة، بينما يتم الاحتفاظ بـ JSON الخام الكامل لـ attributes عبر مسلسل مخصص. يسمح ذلك لعرض التقرير المفصل بعرض جميع الحقول المرتجعة، بما في ذلك أي حقول جديدة تضاف إلى حمولة API بمرور الوقت.

الرصيد التقني

هيكل المشروع

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # النماذج، واجهة برمجة التطبيقات عن بُعد، وتنفيذ المستودع
    ├── domain/        # واجهة المستودع وحالات الاستخدام التجارية
    ├── di/            # وحدات حقن التبعية Hilt
    ├── scan/          # ScanManager و ScanService وإشعارات النظام
    └── ui/            # مكونات واجهة المستخدم وطبقات العرض
        ├── intro/     # شاشة البداية وتكوين مفتاح API
        ├── dashboard/ # مركز التنقل: وحدات فحص الرابط والملف والتطبيق
        ├── results/   # عارضو التقارير السريعة والمفصلة
        ├── components/# عناصر واجهة المستخدم القابلة لإعادة الاستخدام والتخطيطات
        ├── theme/     # تكوينات الألوان والأشكال والطباعة والحركة
        └── util/      # أدوات اللمس اللمسي والإيماءات والروابط العميقة

• أصول متجر القوائم وموارد النص متاحة في fastlane/metadata/android/en-US/.
• ملفات SVG النموذجية القابلة للتحرير موجودة في docs/store/svg/.
• يمكن تصدير النماذج إلى تنسيق PNG باستخدام docs/store/export.html.

البدء

المتطلبات الأساسية

• Android Studio (أحدث إصدار مستقر)
• JDK 17
• مفتاح VirusTotal API مجاني، يمكن الحصول عليه من: https://www.virustotal.com/gui/my-apikey

البناء والتشغيل

استنساخ المستودع وتجميع الإصدار التصحيحي باستخدام سطر الأوامر:

git clone https://github.com/ProfessorQuantumUniverse/VTScan.git
cd VTScan
./gradlew :app:assembleDebug

بدلاً من ذلك، افتح الدليل الجذر داخل Android Studio وحدد تكوين التشغيل.

عند الإطلاق الأول، أدخل مفتاح VirusTotal API الخاص بك في شاشة الإعداد التمهيدية. يتم تخزين المفتاح محليًا على جهازك. تخضع مفاتيح API المجانية عادةً لحد أقصى قدره أربع عمليات بحث في الدقيقة.

سياسة الخصوصية

يتواصل التطبيق حصريًا مع واجهة برمجة تطبيقات VirusTotal باستخدام بيانات الاعتماد التي تقدمها. يتم إرسال الملفات التي تم تحميلها وعناوين URL المقدمة والنتائج الديناميكية مباشرة إلى خوادم VirusTotal. يتم تخزين مفتاح API محليًا على جهازك. لا يجمع Veto بيانات تحليلات ولا يحتوي على أي حزم تطوير إعلانية.

الترخيص

هذا المشروع مرخص بموجب شروط رخصة GNU العامة العامة الإصدار 3.0.

الشروط الرئيسية لـ GPLv3:

• الاستخدام التجاري: مسموح
• التعديل: مسموح
• التوزيع: مسموح
• الكشف عن الكود المصدري: مطلوب عند التوزيع
• نفس الترخيص: يجب أن يستخدم الكود المعدل أيضًا GPLv3
• المسؤولية والضمان: لا يقدمهما المؤلفون

لمزيد من التفاصيل، يرجى الاطلاع على ملف LICENSE في هذا المستودع.