pySigma

pySigma هي مكتبة بايثون تقوم بتحليل قواعد Sigma وتحويلها إلى استعلامات. وهي بديل لسلسلة أدوات Sigma القديمة (sigmac) بتصميم أنظف بكثير وهي مُختبرة بالكامل تقريبًا. الواجهات الخلفية لدعم التحويل إلى لغات الاستعلام وخطوط المعالجة لتحويل القواعد لنماذج بيانات السجلات مفصولة إلى مشاريع مخصصة للحفاظ على pySigma نفسها خفيفة ومحايدة تجاه الموردين. راجع قسم المشاريع ذات الصلة أدناه للحصول على نظرة عامة.

البدء

لبدء استخدام pySigma، تحتاج إلى Python 3.11 أو أحدث. قم بتثبيته باستخدام مدير حزم بايثون المفضل لديك. أمثلة:

pip install pysigma
pipenv install pysigma
poetry add pysigma

يمكن العثور على الوثائق مع بعض أمثلة الاستخدام هنا.

أنشئ واجهتك الخلفية الخاصة لـ pySigma

أصبح إنشاء واجهة خلفية أسهل بكثير مع pySigma. نوصي باستخدام "Cookie Cutter Template" ومراجعة الواجهات الخلفية الموجودة المدرجة في قسم "المشاريع ذات الصلة" في هذا الملف.

pySigma Cookie Cutter Template

الميزات

تقدم pySigma عددًا من الميزات الإضافية مقارنة بـ sigmac الشامل، بالإضافة إلى بعض التغييرات.

sigma-cli هو المكافئ لـ sigmac للتحويل عبر سطر الأوامر

المُعدِّل

استخدم sigma list modifiers

الواجهات الخلفية

استخدم sigma plugin list --plugin-type backend

نظرة عامة

نظرة عامة على التحويل

خطوط المعالجة

يتم وصف المزيد من التفاصيل في الوثائق.

الاختبار

يستخدم pySigma إطار pytest كإطار اختبار. ما عليك سوى تشغيل pytest لتشغيل جميع الاختبارات. شغّل pytest --cov=sigma للحصول على تقرير التغطية.

البناء

لبناء حزمتك الخاصة شغّل poetry build.

فحص الكود

لفحص الكود شغّل poetry run black. للتحقق من أخطاء الفحص شغّل poetry run black --check.

يستخدم هذا المشروع أيضًا pre-commit، والذي يتم تثبيته بواسطة poetry كجزء من تبعيات التطوير. لتثبيت خطافات git شغّل poetry run pre-commit install بعد استنساخ المستودع وتثبيت التبعيات.

المساهمة

طلبات السحب مرحب بها. لا تتردد في تقديم أي مشكلات/طلبات سحب كنقاط للنقاش.

هذا المنشور من Micah Babinski يشرح العملية من منظور المطور.

المشرفون

يتم صيانة المشروع حاليًا بواسطة:

• Thomas Patzke [email protected]
• François Hubaut

المشاريع ذات الصلة

pySigma ليست مكتبة متجانسة تحاول دعم كل شيء بل النواة فقط. يتم توفير الدعم للغات الاستعلام المستهدفة ونماذج بيانات السجلات بواسطة حزم إضافية توسّع pySigma:

• sigma-cli: واجهة سطر أوامر لتحويل قواعد Sigma بناءً على pySigma.
• pySigma-backend-splunk
• pySigma-pipeline-sysmon
• pySigma-pipeline-crowdstrike
• pySigma-backend-netwitness
• pySigma-backend-panther

يمكن أيضًا تثبيت جميع الحزم من PyPI إن لم يُذكر خلاف ذلك بواسطة مدير حزم بايثون الذي تختاره.

الترخيص

GNU Lesser General Public License v2.1. للتفاصيل، يرجى الاطلاع على ملف الترخيص الكامل الموجود هنا.