EasyTokens

एक डिवाइस-कोड फ़िशिंग सर्वर जो प्रतिद्वंद्वी अनुकरण के लिए है। डिवाइस ऑथराइज़ेशन ग्रांट प्रवाह के माध्यम से Microsoft 365 OAuth टोकन कैप्चर करता है। GraphSpy से प्रेरित।

चेतावनी — केवल अधिकृत उपयोग। यह उपकरण पैठ परीक्षकों और रेड टीम सदस्यों के लिए है जो स्पष्ट लिखित प्राधिकरण के तहत काम कर रहे हैं। दुरुपयोग कंप्यूटर धोखाधड़ी कानूनों का उल्लंघन कर सकता है।

यह कैसे काम करता है

1. ऑपरेटर ऑपरेटर UI के माध्यम से एक डिवाइस कोड अभियान बनाता है।
2. एक पीड़ित-सामना करने वाला नामांकन पृष्ठ (डंडर मिफ्लिन थीम) उपयोगकर्ता कोड प्रदर्शित करता है और लक्ष्य को microsoft.com/devicelogin पर प्रमाणित करने का संकेत देता है।
3. एक पृष्ठभूमि पोलर यह पता लगाता है कि लक्ष्य प्रमाणीकरण पूरा करता है और कैप्चर किए गए एक्सेस/रिफ्रेश टोकन को SQLite में संग्रहीत करता है।
4. पीड़ित का ब्राउज़र एक पोस्ट-प्रमाणीकरण खोज पृष्ठ पर पुनर्निर्देशित होता है।
5. ऑपरेटर कैप्चर किए गए टोकन का उपयोग करके Microsoft Graph के माध्यम से पीड़ित के OneDrive और ईमेल को खोज सकता है।

आर्किटेक्चर

Python बैकएंड (प्रति अभियान एक पोर्ट) + nginx फ्रंट-एंड + SQLite स्थिरता।

main_server.py          ← एकीकृत प्रवेश बिंदु (इसे चलाएं)
db.py                   ← SQLite स्थिरता परत
html_enroll.py          ← पीड़ित नामांकन पृष्ठ निर्माता
html_search.py          ← पीड़ित पोस्ट-प्रमाणीकरण खोज पृष्ठ निर्माता
css_shared.py           ← ऑपरेटर UI के लिए साझा 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 प्रबंधन को अक्षम करने के लिए NGINX_CONF='' या NGINX_RELOAD_CMD='' सेट करें।

त्वरित आरंभ (Docker)

docker compose up --build

Docker द्वारा खुले पोर्ट:

• पीड़ित पृष्ठ (सीधा): http://localhost:3000/
• ऑपरेटर UI: http://localhost:3000/app
• डोमेन अभियान: http://<campaign-domain>/ (पोर्ट 80 पर nginx के माध्यम से रूट किया गया)

कैप्चर किए गए टोकन और लॉग Docker वॉल्यूम में संग्रहीत होते हैं:

मैन्युअल सेटअप

आवश्यकताएँ: Python 3.12+, कोई तृतीय-पक्ष पैकेज नहीं।

python main_server.py

पर्यावरण चर

PHP रिले नोड

php-relay/ निर्देशिका में एक स्वतंत्र Apache/PHP कंटेनर है जो वितरित पीड़ित-सामना करने वाले नोड के रूप में कार्य करता है। यह मुख्य सर्वर के समान डिवाइस-कोड नामांकन पृष्ठ प्रदान करता है, Microsoft को सीधे पोल करता है, और कैप्चर किए गए टोकन को POST /webhook के माध्यम से मुख्य पैनल पर अग्रेषित करता है।

यह कैसे काम करता है

1. स्टार्टअप पर, checkin.php मुख्य पैनल पर POST /relay/checkin पर POST करता है, RELAY_SECRET के साथ प्रमाणित होता है। पैनल नोड को पंजीकृत करता है और एक node_id लौटाता है।
2. पीड़ित रिले के नामांकन पृष्ठ (index.php) पर ब्राउज़ करते हैं, जो एक नया डिवाइस-कोड प्रवाह शुरू करता है।
3. ब्राउज़र-साइड JS 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
# .env में MAIN_SERVER_URL को सार्वजनिक पैनल URL पर सेट करें
docker compose up --build

साझा रहस्य सेटअप

1. एक रहस्य उत्पन्न करें: openssl rand -hex 32
2. EasyTokens/.env में RELAY_SECRET=<secret> सेट करें (मुख्य पैनल द्वारा docker-compose.yml के माध्यम से उठाया गया)
3. वही मान php-relay/.env में सेट करें

डेटाबेस

SQLite डेटाबेस में दो तालिकाएँ:

• tokens — प्रत्येक कैप्चर किया गया एक्सेस/रिफ्रेश टोकन (UPN, एक्सेस टोकन, रिफ्रेश टोकन, आईडी टोकन, स्कोप, स्रोत, कैप्चर टाइमस्टैम्प)
• device_codes — ऑपरेटर द्वारा आरंभ किए गए अभियान (उपयोगकर्ता कोड, डिवाइस कोड, सत्यापन URL, स्थिति, लिंक किया गया टोकन आईडी, पोर्ट, डोमेन)

Microsoft OAuth विवरण

लाइसेंस

MIT — कॉपीराइट (c) 2026 केसी स्मिथ