Linkwarden - روبوت ماسح ضوئي الارتباط Discord
يعزز Bot Discord ، المصمم للاستخدام الشخصي والمجتمع ، أمان الخادم عن طريق تدقيق الروابط المشتركة في قنوات Discord. إنه يعزز من API Virustotal API و Whois Lookups و urlscan.io لتوفير تحليل شامل في الوقت الفعلي ، مما يساعد على الحفاظ على بيئة آمنة عبر الإنترنت للأعضاء.
سمات
- تحليل الارتباط في الوقت الفعلي : يتحقق تلقائيًا من الروابط المشتركة في Discord مقابل قاعدة بيانات Virustotal ، ويقوم بإجراء عمليات البحث عن Whois ، ويقوم بتقديم عناوين URL إلى urlscan.io للمسح الضوئي.
- تقارير أمنية شاملة : يولد تقارير مفصلة بما في ذلك تحليل Virustotal ، وتفاصيل تسجيل المجال من Whois ، وبطاقات الويب لقطات ورؤى أمان من urlscan.io.
- أوضاع فحص مرنة : يوفر كل من نظرة عامة موجزة (الوضع البسيط) والتقارير التفصيلية (الوضع التفصيلي) لتناسب تفضيلات المستخدم المختلفة.
- سهولة الاستخدام : سيقوم الروبوت بتضمين لقطة شاشة للرابط المرسلة للتحقق مباشرة في الدردشة في كل من أوضاع المسح ، بسيطة أو مفصلة.
- عمليات مسح الارتباط التلقائي : سيبحث الروبوت عن الروابط المرسلة عبر الخادم ومسحها تلقائيًا إذا لم تكن من مجال موثوق به.
- قائمة المجال الموثوق بالتخصيص - مع إضافة
trusted_domains.json يمكنك تخصيص المجالات التي يجب مسحها. - أمر محدد للدور - لن يقوم BOT بتنفيذ مستخدمي نموذج الأوامر الذين ليس لديهم دور محدد مدرج في ملف
config.py . - مصدر الارتباط - سيقوم الروبوت بتضمين رابط الرسالة حيث تم العثور على الرابط الممسوح ضوئيًا في تسهيل الاعتدال.
- سجل الرابط - يقوم الروبوت بتسجيلات جميع الروابط التي يتم إرسالها ليتم مسحها ضوئيًا وتبقيها للرجوع إليها في المستقبل
- حالة قابلة للتخصيص - رسائل الحالة المخصصة مدمجة.
- Clean Console - رسائل طباعة مخصصة لكل إجراء وتفاعل مع الروبوت.
ابدء
قبل أن تتمكن من استخدام الروبوت ، ستحتاج إلى إعداده مع خادم Discord وتكوينه باستخدام مفاتيح API الخاصة بك.
المتطلبات الأساسية
- حساب خلاف مع امتيازات إدارية على الخادم الخاص بك.
- بيثون 3.6 أو أعلى.
- مفاتيح API لـ virustotal و urlscan.io (متوفرة من مواقعها على الويب).
انضم إلى خادم Discord الخاص بي
تثبيت
- استنساخ هذا المستودع إلى جهازك المحلي.
- قم بتثبيت التبعيات المطلوبة عن طريق تشغيل
pip install -r requirements.txt . - قم بإنشاء ملف
config.py في نفس الدليل مثل البرنامج النصي bot الخاص بك (أو استخدم ملف premade 'config.py') ، وأضف رمز الرمز المميز الخاص بك ، ومفتاح واجهة برمجة تطبيقات virustotal ، ومفتاح urlscan.io api ، ومعرفات النقابة ، ومعرف المشرف ، ومعرف القناة حيث تريد إخراج Scans scans للانتقال إلى النماذج التالية:
TOKEN = 'your_discord_bot_token_here'
VIRUSTOTAL_API_KEY = 'your_virustotal_api_key_here'
URLSCAN_API_KEY = 'your_urlscan_io_api_key_here'
guild_ids = [ your_guild_id_here ]
SCAN_CHANNEL_ID = CHANNEL_WHERE_SCANS_SHOULD_GO
ALLOWED_ROLE_IDS = [ MOD_ROLE_ID_GOES_HERE ]
- تشغيل
main.py
التبعيات
يتطلب هذا الروبوت حزم بيثون التالية:
- Py-Cord
- الطلبات
- Python-whois يمكن تثبيتها باستخدام PIP:
pip install py - cord requests python - whois
أو يمكنك تثبيتها باستخدام ملف المتطلبات.
pip install - r requirements . txt
الاستخدام
الروبوت واضح ومباشر للاستخدام مع بنية الأوامر البسيطة. وهو يدعم الأمر التالي:
هيكل الأوامر
/checklink [LINK] [MODE]
- الوضع البسيط : يوفر ملخصًا سهل الاستخدام بما في ذلك حالة أمان الرابط ، وملخص تسجيل مجال WHOIS ، ورابط لتقرير urlscan.io.
/checklink https://example.com simple
- الوضع التفصيلي : يقدم تقريراً شاملاً مع تصنيفات خاصة من البائعين من معلومات WHOIs المفصلة ، وتقرير أمني شامل من urlscan.io.
/checklink https://example.com detailed
- التاريخ : يخرج قائمة بسيطة من الروابط السابقة التي تم استخدامها للمسح وتتبع عدد المرات التي شوهد فيها كل رابط.
/checklhistory
أوضح أوضاع
- بسيط : يعرض موجزًا مع أفضل 10 تحذيرات من Virustotal ، وهو ملخص لمعلومات Whois ، ورابط إلى تقرير urlscan.io.
- مفصل : يقدم تقريرًا شاملاً ، يحتفل بكل بائع بنقطة مشتركة بالألوان وفقًا للأسطورة أدناه ، إلى جانب معلومات WHOIS التفصيلية وتقرير أمان urlscan.io.
نقاط الحالة الأسطورة
- غير ضار:؟
- ضار:؟
- مثير للشك: ؟
- غير مكتشف: ⚪
التحسينات المستقبلية
- تكامل لوحة القيادة : قم بتطوير لوحة معلومات قائمة على الويب توفر نظرة عامة على عمليات المسح السابقة ، بما في ذلك النتائج والاحصاءات التفصيلية. ستقدم لوحة القيادة هذه نظرة ثاقبة على أنواع الروابط المشتركة داخل الخادم وفعالية الروبوت في تحديد التهديدات ، وتعزيز الشفافية والثقة في قدرات الروبوت.
- تكامل المسح الإضافي : قم بتوسيع قدرات المسح الضوئي في BOT من خلال دمج أدوات وخدمات أمان إضافية. سيوفر هذا التوسع تغطية وحماية أكثر شمولية ضد مجموعة واسعة من التهديدات عبر الإنترنت.
- نظام ملاحظات المستخدم : قم بتنفيذ نظام للمستخدمين لتقديم ملاحظات حول نتائج المسح ، مثل الإبلاغ عن إيجابيات كاذبة أو التهديدات الفائتة. ستساعد حلقة التغذية المرتدة هذه على تحسين دقة الروبوت وفعاليتها مع مرور الوقت.
المساهمة
- مساهماتك مرحب بها! سواء أكان ذلك إضافة ميزات جديدة أو تحسين الوثائق أو الإبلاغ عن الأخطاء ، فلا تتردد في تغطية هذا المستودع وتقديم طلب سحب.
المساهمين
- Cazaira - ساعد في تحسين وجعل ملف
trusted_domains.json أقوى ضد إيجابيات كاذبة. - النتررين - اكتشف خطأ حرجًا تسبب في تعطل الروبوت على روابط معينة.
رخصة
هذا المشروع مفتوح المصدر بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.