base4security/t3sfإطار محاكاة تمارين الطاولة التقنية
إطار محاكاة تمارين الطاولة التقنية
T3SF هو إطار يقدم بنية معيارية لتنسيق الأحداث بناءً على قائمة أحداث السيناريو الرئيسي (MSEL) مع مجموعة من القواعد المحددة لكل تمرين (اختياري) وإعدادات تسمح بتحديد معلمات المنصة المقابلة. تقوم الوحدة الرئيسية بالاتصال بالوحدة الخاصة (Discord، Slack، Telegram، إلخ) التي تسمح للأحداث بعرض الأحداث في قنوات الإدخال كحقن لكل منصة. بالإضافة إلى ذلك، يدعم الإطار حالات استخدام مختلفة: "منظمة واحدة، مناطق متعددة"، "منظمات متعددة، منطقة واحدة" و "منظمات متعددة، مناطق متعددة".
لاستخدام الإطار مع المنصة التي تريدها، سواء كانت Slack أو Discord، ستحتاج إلى تثبيت الوحدات المطلوبة لتلك المنصة. ولكن لا تقلق، تثبيت هذه الوحدات سهل ومباشر.
للقيام بذلك، يمكنك اتباع هذا الدليل البسيط خطوة بخطوة، أو إذا كنت مرتاحًا بالفعل لتثبيت الحزم باستخدام pip، يمكنك الانتقال مباشرة إلى الخطوة الأخيرة!
# Python 3.6+ مطلوب
python -m venv .venv # سننشئ بيئة افتراضية بايثون
source .venv/bin/activate # لندخل إليها
pip install -U pip # ترقية pip
بمجرد إنشاء بيئة افتراضية بايثون وتنشيطها، يمكنك تثبيت إطار T3SF للمنصة التي تريدها عن طريق تشغيل الأمر التالي:
pip install "T3SF[Discord]" # تثبيت الإطار للعمل مع Discord
أو
pip install "T3SF[Slack]" # تثبيت الإطار للعمل مع Slack
سيؤدي ذلك إلى تثبيت إطار T3SF مع التبعيات المطلوبة للمنصة التي اخترتها. بمجرد اكتمال التثبيت، يمكنك البدء في استخدام الإطار مع المنصة المفضلة لديك.
نوصي بشدة باتباع الإرشادات الخاصة بكل منصة في وثائقنا على Read The Docs! إليك الروابط:
لقد أنشأنا هذا الإطار لتبسيط كل عملك!
$ docker run --rm -t --env-file .env -v $(pwd)/MSEL.json:/app/MSEL.json base4sec/t3sf:slack
داخل ملف .env الخاص بك، يجب توفير الرموز SLACK_BOT_TOKEN و SLACK_APP_TOKEN. اقرأ المزيد عنها هنا.
هناك متغير بيئة آخر يجب تعيينه، وهو MSEL_PATH. يخبر هذا المتغير الإطار بمسار ملف MSEL. بشكل افتراضي، مسار الحاوية هو /app/MSEL.json. إذا قمت بتغيير موقع تحميل الحجم، فقم بتغيير المتغير أيضًا.
$ docker run --rm -t --env-file .env -v $(pwd)/MSEL.json:/app/MSEL.json base4sec/t3sf:discord
بمجرد أن يصبح كل شيء جاهزًا، استخدم قالبنا لملف main.py، أو قم بتعديل الكود التالي:
إليك مثال إذا كنت ترغب في تشغيل الإطار مع بوت Discord و GUI.
from T3SF import T3SF
import asyncio
async def main():
await T3SF.start(MSEL="MSEL_TTX.json", platform="Discord", gui=True)
if __name__ == '__main__':
asyncio.run(main())
أو إذا كنت تفضل تشغيل الإطار بدون GUI ومع Slack بدلاً من ذلك، يمكنك تعديل الوسائط، وهذا كل شيء!
نعم، بهذه البساطة!
await T3SF.start(MSEL="MSEL_TTX.json", platform="Slack", gui=False)
إذا كنت بحاجة إلى مزيد من المساعدة، يمكنك دائمًا مراجعة وثائقنا هنا!
داخل ملف .env الخاص بك، يجب توفير الرمز DISCORD_TOKEN. اقرأ المزيد عنه هنا.
هناك متغير بيئة آخر يجب تعيينه، وهو MSEL_PATH. يخبر هذا المتغير الإطار بمسار ملف MSEL. بشكل افتراضي، مسار الحاوية هو /app/MSEL.json. إذا قمت بتغيير موقع تحميل الحجم، فقم بتغيير المتغير أيضًا.