ROADtools

(Rogue Office 365 and Azure (active) Directory tools)

ROADtools هو إطار للتفاعل مع Azure AD. يتكون من مكتبة (roadlib) بمكونات شائعة، وأداة استكشاف ROADrecon لـ Azure AD، وأداة تبادل الرموز ROADtools Token eXchange (roadtx).

ROADlib

ROADlib هي مكتبة يمكن استخدامها للمصادقة مع Azure AD أو لبناء أدوات تتكامل مع قاعدة بيانات تحتوي على بيانات ROADrecon. يتم إنشاء نموذج قاعدة البيانات في ROADlib تلقائيًا بناءً على تعريف البيانات الوصفية لواجهة برمجة التطبيقات الداخلية لـ Azure AD. يعيش ROADlib في مساحة أسماء ROADtools، لذا لاستيراده في نصوصك البرمجية استخدم from roadtools.roadlib import X

ROADrecon

ROADrecon هي أداة لاستكشاف المعلومات في Azure AD من منظور كل من الفريق الأحمر والفريق الأزرق. باختصار، هذا ما تفعله:

• تستخدم نموذج بيانات وصفية تم إنشاؤه تلقائيًا لإنشاء قاعدة بيانات مدعومة بـ SQLAlchemy على القرص.
• تستخدم استدعاءات HTTP غير متزامنة في Python لتفريغ جميع المعلومات المتاحة في رسم بياني لـ Azure AD إلى قاعدة البيانات هذه.
• توفر إضافات للاستعلام عن قاعدة البيانات هذه وإخراجها بتنسيق مفيد.
• توفر واجهة واسعة مبنية في Angular تستعلم قاعدة البيانات غير المتصلة مباشرة لتحليلاتها.

يستخدم ROADrecon ميزات async في Python وهو متوافق فقط مع Python 3.10 والإصدارات الأحدث (يتم التطوير باستخدام Python 3.11، ويتم تشغيل الاختبارات بإصدارات حتى Python 3.14).

التثبيت

هناك عدة طرق لتثبيت ROADrecon:

استخدام إصدار منشور على PyPi
يمكن تثبيت الإصدارات المستقرة باستخدام pip install roadrecon. سيضيف هذا الأمر roadrecon تلقائيًا إلى PATH الخاص بك.

استخدام إصدار من GitHub
يتم بناء كل التزام (commit) على master تلقائيًا إلى إصدار مع Azure Pipelines. هذا يضمن أنه يمكنك تثبيت أحدث إصدار من الواجهة الرسومية دون الحاجة إلى تثبيت npm وجميع تبعياته. يمكنك تنزيل ملفات البناء الخاصة بـ roadlib و roadrecon من عناصر Azure Pipelines (انقر على الزر "1 Published"). يتم تخزين ملفات الإخراج في ROADtools.zip. يمكنك إما تثبيت ملفات .whl أو .tar.gz مباشرة باستخدام pip أو فك ضغط كليهما وتثبيت المجلدات بالترتيب الصحيح (roadlib أولاً):

pip install roadlib/
pip install roadrecon/

يمكنك أيضًا تثبيتها في وضع التطوير باستخدام pip install -e roadlib/.

تطوير الواجهة الأمامية
إذا كنت ترغب في إجراء تغييرات على الواجهة الأمامية لـ Angular، فستحتاج إلى تثبيت node و npm. ثم قم بتثبيت المكونات من git:

git clone https://github.com/dirkjanm/roadtools.git
pip install -e roadlib/
pip install -e roadrecon/
cd roadrecon/frontend/
npm install

يمكنك تشغيل الواجهة الأمامية لـ Angular باستخدام npm start أو ng serve باستخدام Angular CLI من الدليل roadrecon/frontend/. لبناء ملفات JavaScript في دليل dist_gui لـ ROADrecon، قم بتشغيل npm run build.

استخدام ROADrecon

راجع صفحة الويكي هذه حول كيفية البدء.

ROADtools Token eXchange (roadtx)

roadtx هي أداة لتبادل واستخدام أنواع مختلفة من الرموز الصادرة عن Azure AD. تدعم العديد من تدفقات المصادقة المختلفة، وتسجيل الأجهزة، والعمليات المتعلقة بـ PRT. للحصول على نظرة عامة على الأداة، راجع roadtx Wiki.

التثبيت

هناك عدة طرق لتثبيت roadtx. لاحظ أن roadtx يتطلب Python 3.10 أو أحدث.

استخدام إصدار منشور على PyPi
يمكن تثبيت الإصدارات المستقرة باستخدام pip install roadtx. سيضيف هذا الأمر roadtx تلقائيًا إلى PATH الخاص بك.

استخدام إصدار من GitHub يمكنك استنساخ هذا المستودع وتثبيت roadlib ثم roadtx للتأكد من حصولك على أحدث إصدارات كل من الأداة والمكتبة:

pip install roadlib/
pip install roadtx/

يمكنك أيضًا تثبيتها في وضع التطوير باستخدام pip install -e roadtx/.

استخدام roadtx

راجع الويكي حول كيفية استخدام roadtx. راجع أيضًا مدونة الإصدار.