azure/stormspotterأداة فريق Red Team لـ Azure لإنشاء رسم بياني لكائنات Azure و Azure Active Directory
يقوم Stormspotter بإنشاء "رسم بياني للهجوم" للموارد في اشتراك Azure. يمكّن الفرق الحمراء ومختبري الاختراق من تصور سطح الهجوم وفرص التنقل داخل المستأجر، ويدعم المدافعين لديك لترتيب أولويات أعمال الاستجابة للحوادث بسرعة.
قد يجد معظم المستخدمين أنه من الأسهل تثبيت Stormspotter عبر Docker. هذه هي الطريقة الموصى بها.
git clone https://github.com/Azure/Stormspotter
docker-compose up
سينشئ ملف docker-compose ثلاث حاويات:
بشكل افتراضي، ستكشف حاوية Stormspotter عن واجهة المستخدم على المنفذ 9091. ستعرض حاوية neo4j واجهة neo4j على المنافذ 7474 (HTTP) و 7687 (Bolt). التكوين الافتراضي لـ Neo4j لا يتضمن SSL نشطًا، لذا يمكنك في البداية التفاعل مباشرة مع واجهة neo4j على المنفذ 7474.
ملاحظة: حاليًا، يدعم Stormspotter تشغيل هذه الحاويات محليًا فقط. محاولة الرفع إلى الواجهة الأمامية المستضافة عن بُعد ستكون غير ناجحة، لكن من المتوقع أن يتغير هذا السلوك في المستقبل.
بيانات الاعتماد الافتراضية لـ neo4j هي: neo4j/password. يمكنك تغيير ذلك في ملف docker-compose عبر متغير البيئة NEO4JAUTH.
إذا اخترت تشغيل Stormspotter بدون Docker، يجب أن يكون لديك Python 3.8 و NodeJS/npm و Neo4j مثبتة. يمكنك أيضًا الحصول على أحدث إصدارات Stormspotter من هنا.
تم بناء الواجهة الخلفية التي تتولى تحليل البيانات إلى Neo4j باستخدام FastAPI. إذا كنت لا تخطط لرفع محتوى جديد لقاعدة البيانات، فقد لا تحتاج إلى تشغيل الواجهة الخلفية على الإطلاق. تم تكوين الواجهة الخلفية للعمل على المنفذ 9090. يمكنك تغيير ذلك بتغيير رقم المنفذ في السطر 5 من app.py. إذا قمت بذلك، يجب أيضًا تغيير المنفذ في مكون Q-Uploader في مكون عرض قاعدة البيانات ليتم إرسال الرفعات من الواجهة الأمامية إلى المنفذ الصحيح حيث توجد الواجهة الخلفية.
cd backend
python3 ssbackend.pyz
تم تطوير تطبيق الويب باستخدام Vue و إطار Quasar. تم بناء التطبيق ذو الصفحة الواحدة (SPA) لك ويوجد في frontend/dist/spa. لخدمة هذا الدليل:
npm install -g @quasar/cli
cd frontend/dist/spa
quasar serve -p 9091 --history
يمكنك بعد ذلك زيارة http://localhost:9091 في متصفحك.
Stormcollector هو الجزء من Stormspotter الذي يتيح لك تعداد الاشتراكات التي يمكن لبيانات الاعتماد المقدمة الوصول إليها. الطريقة الموصى بها لاستخدام Stormcollector هي تشغيل حزمة sscollector.pyz الموجودة في ملف الإصدار الخاص بنظام تشغيلك. تم إنشاء هذا PYZ باستخدام Shiv ويأتي مع جميع الحزم مضغوطة مسبقًا! ستقوم التبعيات باستخراج نفسها إلى مجلد .shiv في دليل المستخدم الرئيسي.
cd stormcollector
python3 sscollector.pyz -h
إذا كان هناك سبب يمنعك من استخدام الحزمة المقدمة، يمكنك تثبيت الحزم المطلوبة باستخدام pip أو pipenv. مع هذا الأسلوب، يُوصى بشدة بتثبيت Stormcollector في بيئة افتراضية لمنع تعارض الحزم. إذا كانت لديك مشكلات في إدارة البيئات الافتراضية، يجب استخدام الطريقة الموصى بها أعلاه.
cd stormcollector
python3 -m pip install pipenv
pipenv install .
python3 ./sscollector.py
أنواع تسجيل الدخول المدعومة حاليًا:
az login أولاً)يمكنك الاطلاع على جميع الخيارات التي يقدمها Stormcollector باستخدام المفتاح -h كما هو موضح أعلاه. الاستخدامات الأساسية لـ Stormcollector هي:
python3 sscollector.pyz cli
python3 sscollector.pyz spn -t <tenant> -c <clientID> -s <clientSecret>
الخيارات الشائعة لجميع أنواع المصادقة
رفع النتائج
بمجرد بدء تشغيل واجهة المستخدم، سترى قسمًا في علامة تبويب قاعدة البيانات بعنوان "Stormcollector Upload". أضف ملفك إلى أداة الرفع هذه وستبدأ المعالجة. أثناء معالجة النتائج، يمكنك التحقق من سجلات الواجهة الخلفية لعرض التقدم، ويجب أن تنعكس النتائج أيضًا في نفس علامة تبويب عرض قاعدة البيانات.
عرض الأذونات على KeyVault
عرض أعضاء دور Azure AD
عرض العلاقات الواردة والصادرة
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات موافقتك على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في، وتقوم بالفعل بمنحنا الحقوق لاستخدام مساهمتك. للتفاصيل، قم بزيارة https://cla.opensource.microsoft.com.
عند تقديم طلب سحب (pull request)، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وسيزين PR بشكل مناسب (على سبيل المثال، فحص الحالة، تعليق). ما عليك سوى اتباع التعليمات المقدمة من الروبوت. ستحتاج فقط إلى القيام بذلك مرة واحدة عبر جميع المستودعات التي تستخدم CLA الخاص بنا.
اعتمد هذا المشروع مدونة قواعد السلوك مفتوحة المصدر من Microsoft. لمزيد من المعلومات، راجع الأسئلة الشائعة حول مدونة قواعد السلوك أو اتصل على [email protected] مع أي أسئلة أو تعليقات إضافية.