EasyTokens

خادم تصيد برمز الجهاز لمحاكاة الخصم. يلتقط رموز OAuth لمايكروسوفت 365 عبر تدفق ترخيص الجهاز. مستوحى من GraphSpy.

تحذير — الاستخدام المصرح به فقط. هذه الأداة مخصصة لمختبرِي الاختراق وفرق الأحمر الذين يعملون تحت تصريح كتابي صريح. قد يؤدي سوء الاستخدام إلى انتهاك قوانين الاحتيال الحاسوبي.

كيف يعمل

1. يقوم المشغل بإنشاء حملة رمز جهاز عبر واجهة المشغل.
2. تظهر صفحة تسجيل موجهة للضحية (بتصميم Dunder Mifflin) رمز المستخدم وتطلب من الهدف المصادقة على microsoft.com/devicelogin.
3. يكتشف مُصوِّت خلفي عند اكتمال المصادقة من قبل الهدف ويخزن رمز الوصول/التحديث الذي تم التقاطه في SQLite.
4. يتم إعادة توجيه متصفح الضحية إلى صفحة بحث بعد المصادقة.
5. يمكن للمشغل البحث في OneDrive والبريد الإلكتروني للضحية عبر Microsoft Graph باستخدام الرمز الملتقط.

البنية

خلفية Python (منفذ واحد لكل حملة) + واجهة nginx أمامية + تخزين SQLite.

main_server.py          ← نقطة دخول موحدة (شغّل هذا)
db.py                   ← طبقة تخزين SQLite
html_enroll.py          ← باني صفحة تسجيل الضحية
html_search.py          ← باني صفحة بحث ما بعد المصادقة للضحية
css_shared.py           ← CSS مشترك لواجهة المشغل
nginx_helper.py         ← يولد بشكل تلقائي ويُعيد تحميل إعدادات nginx العكسية
nginx.conf              ← إعدادات nginx الأساسية (تتضمن /etc/nginx/conf.d/*.conf)

المسارات

Nginx — حملات النطاقات

عند إنشاء حملة مع تعيين نطاق، يقوم nginx_helper.py تلقائيًا بكتابة كتلة خادم لكل نطاق إلى NGINX_CONF (افتراضيًا /etc/nginx/conf.d/easytokens.conf) ويعيد تحميل nginx. يتم توجيه حركة مرور الضحية الواردة على المنفذ 80 لذلك النطاق إلى مثيل Python الصحيح.

• الحملات بدون نطاق تُخدم مباشرة على منفذ Python (افتراضي 3000).
• الحملات مع نطاق تُخدم عبر nginx على المنفذ 80.
• تتجاهل إعدادات nginx.conf الأساسية أي طلب لا يتطابق رأس Host الخاص به مع حملة معروفة (return 444)، مما يمنع التعرض العرضي لخلفية Python.
• قم بتعيين NGINX_CONF='' أو NGINX_RELOAD_CMD='' لتعطيل الإدارة التلقائية لـ nginx.

البدء السريع (Docker)

docker compose up --build

المنافذ المكشوفة بواسطة Docker:

• صفحة الضحية (مباشرة): http://localhost:3000/
• واجهة المشغل: http://localhost:3000/app
• حملات النطاق: http://<campaign-domain>/ (تُوجه عبر nginx على المنفذ 80)

يتم تخزين الرموز الملتقطة والسجلات في وحدات تخزين Docker:

الإعداد اليدوي

المتطلبات: Python 3.12+، لا حزم خارجية.

python main_server.py

متغيرات البيئة

عقدة ترحيل PHP

يحتوي الدليل php-relay/ على حاوية Apache/PHP مستقلة تعمل كعقدة موزعة موجهة للضحية. تقدم نفس صفحة تسجيل رمز الجهاز مثل الخادم الرئيسي، وتستقصي Microsoft مباشرة، وتُحول الرموز الملتقطة إلى اللوحة الرئيسية عبر POST /webhook.

كيف يعمل

1. عند بدء التشغيل، يقوم checkin.php بإرسال طلب POST إلى POST /relay/checkin على اللوحة الرئيسية، مع المصادقة باستخدام RELAY_SECRET. تقوم اللوحة بتسجيل العقدة وتعرض node_id.
2. يتصفح الضحايا صفحة تسجيل العقدة (index.php)، التي تبدأ تدفق رمز جهاز جديد.
3. يقوم JavaScript في المتصفح باستقصاء poll.php. عندما يتم التقاط رمز، يقوم poll.php بإرساله إلى POST /webhook على اللوحة الرئيسية، مع وسوم node_id.

متغيرات بيئة الترحيل

قم بتكوينها في php-relay/.env:

البدء السريع

الحاويتان معًا في وقت واحد (موصى به):

# من EasyTokens/
docker compose -f docker-compose.yml -f php-relay/docker-compose.yml up --build

تشغيل كلتيهما بدمج -f يضعهما على نفس شبكة Docker، لذا فإن MAIN_SERVER_URL=http://easytokens:3000 يعمل بشكل صحيح.

الوصول:

الترحيل فقط (لوحة عن بعد):

cd php-relay
# عيّن MAIN_SERVER_URL إلى رابط اللوحة العامة في .env
docker compose up --build

إعداد السر المشترك

1. أنشئ سرًا: openssl rand -hex 32
2. عيّن RELAY_SECRET=<secret> في EasyTokens/.env (تلتقطه اللوحة الرئيسية عبر docker-compose.yml)
3. عيّن نفس القيمة في php-relay/.env

قاعدة البيانات

جدولان في قاعدة بيانات SQLite:

• tokens — كل رمز وصول/تحديث تم التقاطه (UPN، رمز الوصول، رمز التحديث، رمز الهوية، النطاق، المصدر، طابع وقت الالتقاط)
• device_codes — الحملات التي بدأها المشغل (رمز المستخدم، رمز الجهاز، رابط التحقق، الحالة، معرّف الرمز المرتبط، المنفذ، النطاق)

تفاصيل OAuth لمايكروسوفت

الترخيص

MIT — حقوق النشر (c) 2026 Casey Smith