pysap - مكتبة Python لصياغة حزم بروتوكولات شبكات SAP

الإصدار 0.2.2.dev0 (قيد التطوير)

نظرة عامة

SAP Netweaver و SAP HANA هما منصتان تقنيتان لبناء وتكامل تطبيقات أعمال SAP. يستخدم الاتصال بين المكونات بروتوكولات شبكة مختلفة، كما تستخدم بعض الخدمات والأدوات صيغ ملفات مخصصة. وبينما بعضها بروتوكولات قياسية ومعروفة، فإن البعض الآخر خاص بالمؤسسة والمعلومات العامة عنه غير متاحة بشكل عام.

pysap هي مكتبة Python مفتوحة المصدر توفر وحدات لصياغة وإرسال الحزم باستخدام بروتوكولات SAP التالية: NI، Diag، Enqueue، Router، MS، SNC، IGS، RFC، NWRFC و HDB. بالإضافة إلى ذلك، يتم تضمين دعم لإنشاء وتحليل صيغ ملفات مخصصة مختلفة. تم بناء الوحدات فوق Scapy وتستند إلى المعلومات المكتسبة من البحث في البروتوكولات وصيغ الملفات والخدمات المختلفة.

الميزات

• تشريح وصياغة بروتوكولات الشبكة التالية:

  • واجهة شبكة SAP (NI)
  • SAP Diag
  • SAP Enqueue
  • SAP Router
  • خادم رسائل SAP (MS)
  • اتصال الشبكة الآمن من SAP (SNC)
  • خادم الرسوميات الإنترنتي من SAP (IGS)
  • استدعاء الدالة عن بعد من SAP (RFC)
  • SAP Netweaver RFC SDK (NWRFC)
  • شبكة أوامر SQL لـ SAP HANA (HDB)

• واجهات عميل للتعامل مع صيغ الملفات التالية:

  • ملفات أرشيف SAP SAR
  • ملفات بيئة الأمان الشخصية من SAP (PSE)
  • ملفات بيانات اعتماد الدخول الموحد من SAP (Credv2)
  • ملفات التخزين الآمن في نظام الملفات من SAP (SSFS)

• مكتبة تنفذ خوارزميات الضغط LZH و LZC الخاصة بـ SAP.

• ضغط/فك ضغط تلقائي للحمولات باستخدام خوارزميات SAP.

• فئات العميل والوكيل والخادم منفذة لبعض البروتوكولات.

• أدوات سطر أوامر للعمل دون اتصال مع ملفات أرشيف SAP و PSE و Credv2 و SSFS.

• نصوص برمجية مثال لتوضيح استخدام الوحدات والبروتوكولات المختلفة.

التثبيت

لتثبيت pysap ببساطة قم بتشغيل:

$ python3 -m pip install pysap

يتطلب pysap الإصدار 3.10 من Python أو أحدث.

خارطة الطريق

مشروع Python 3

بعد وقت طويل وبفضل جهد مجتمعي رائع، تم نقل المشروع للتو إلى Python 3. يعمل المشروع الآن على Python 3، لكن لا يزال من المتوقع ظهور أخطاء مع اختبار المزيد من الوظائف وتقييمها. دعم الاختبار من المجتمع محل تقدير كبير.

بالإضافة إلى ذلك، لم يتم بعد تكييف بعض قدرات Python 3 الحديثة بشكل كامل، مثل الكتابة الثابتة، والتزامن الأصلي وغيرها.

جهود إضافية

• إصلاح الأخطاء في كل مكان
• زيادة تغطية اختبارات الوحدة
• دمج الكتابة الثابتة وميزات Python 3.10+ الأخرى
• اكتمال البروتوكول (مثل NWRFC، RFC، Diag، HDB)
• إنشاء أدوات أكثر استقرارًا تحاكي أدوات SAP الأصلية (مثل genpse، dpmon، gwmon)
• تحديث مشاريع OWASP المعتمدة مثل honeysap ومراقبة سطح الهجوم في SAP

التوثيق

التوثيق متاح على Read the Docs.

يتضمن توثيق التطوير دليل اختبار قصير في docs/dev/testing.rst. يصف مجموعات اختبار الوحدة والتكامل، وأداة الاختبار، وأوامر tox و pytest الموصى بها.

الترخيص

هذه المكتبة موزعة تحت ترخيص GPLv2. راجع ملف COPYING لمزيد من التفاصيل.

المؤلفون

تم تصميم وتطوير الأداة في البداية بواسطة Martin Gallo أثناء عمله في فريق SecureAuth's Innovation Labs، بمساعدة العديد من المساهمين. ثم تمت المساهمة بالكود من قبل SecureAuth إلى مشروع OWASP CBAS في أكتوبر 2022.

المساهمون

مساهمات من Florian Grunow (@0x79)، Scott Walsh (@invisiblethreat)، Joris van de Vis (@jvis)، Victor Portal Gonzalez، Dmitry Yudin (@ret5et)، Hans-Christian Esperer (@hce)، Vahagn Vardanyan (@vah13)، Mathieu Geli (@gelim)، Yvan Genuer (@iggy38)، Malte Heinzelmann (@hnzlmnn)، @codeHorse87، Albert Zedlitz، @cclauss، @okuuva، Dmitry Chastuhin (@_chipik)، fabhap، Andreas Hornig، Jennifer Hornig (@gloomicious)، RedRays Security Team، Vincent Berg، Waseem Ajrab (@default-eshu)، @randomstr1ng، Tyrox (@DominikHolzapfel)، Hackbarth، و Timm Lippert (@Tmm).

إخلاء المسؤولية

روح هذه المبادرة مفتوحة المصدر هي مساعدة باحثي الأمن، والمجتمع، على تسريع أنشطة البحث والأنشطة التعليمية المتعلقة بتنفيذ بروتوكولات ومكدسات الشبكات.

المعلومات في هذا المستودع لأغراض البحث والتعليم فقط وليس المقصود استخدامها في بيئات الإنتاج و/أو كجزء من المنتجات التجارية.

إذا كنت ترغب في استخدام هذه الأداة أو جزء منها لأغراضك الخاصة، فإننا نوصي بتطبيق دورة حياة تطوير الأمن المناسبة وممارسات الترميز الآمن، بالإضافة إلى إنشاء وتتبع مؤشرات الاختراق المعنية وفقًا لاحتياجاتك.

اتصل بنا

سواء كنت تريد الإبلاغ عن خطأ، أو إرسال تصحيح، أو تقديم بعض الاقتراحات حول هذه الحزمة، أرسل بضعة أسطر إلى قادة مشروع OWASP CBAS.

للأسئلة المتعلقة بالأمن راجع سياسة الأمن الخاصة بنا.