विवरण   |   स्थापना   |   वेबसाइट   |   मॉड्यूल   |   मुद्दे   |   समर्थन

iKy

विवरण

iKy एक OSINT टूल है जो एक ईमेल पते या अन्य चयनकर्ताओं से जानकारी एकत्र करता है और परिणामों को एक दृश्य इंटरफ़ेस में प्रदर्शित करता है।

स्थापना

पूर्वापेक्षाएँ

• Docker
• Docker Compose (Docker Desktop के साथ शामिल)
• (वैकल्पिक) just टास्क रनर

त्वरित प्रारंभ

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

अपना ब्राउज़र http://localhost:4300 पर खोलें।

सभी सेवाओं को रोकने के लिए:

just down

just up backend, iky-frontend, और redis प्रारंभ करता है। डिफ़ॉल्ट रूप से कोई अन्य सेवा लॉन्च नहीं की जाती है।

Docker के बिना (नेटिव)

यदि आप Docker नहीं चला सकते हैं, तो iKy नेटिव रूप से चल सकता है: Caddy प्री-बिल्ट फ्रंटएंड को सर्व करता है और Redis + Celery + Uvicorn स्थानीय प्रक्रियाओं के रूप में चलते हैं। होस्ट पर redis-server, Python 3.12, curl और tar की आवश्यकता है (Caddy स्वचालित रूप से डाउनलोड होता है)।

just setup          # venv बनाएं
just up-native      # निर्भरताएँ इंस्टॉल करता है, Caddy + फ्रंटएंड डाउनलोड करता है, सब कुछ प्रारंभ करता है

अपना ब्राउज़र http://localhost:4300 पर खोलें। Ctrl-C या just down-native से रोकें।

फ्रंटएंड नवीनतम GitHub रिलीज़ से खींचा जाता है — Node बिल्ड की आवश्यकता नहीं है। tor नेटिव मोड में लॉन्च नहीं होता है; केवल darkweb मॉड्यूल को इसकी आवश्यकता है।

आर्किटेक्चर

मॉड्यूल

iKy backend/module_registry.py के माध्यम से 26 मॉड्यूल को रूट करता है:

API कुंजियाँ

एक बार एप्लिकेशन ब्राउज़र में लोड हो जाने पर, सेटिंग्स पैनल में अपनी API कुंजियाँ दर्ज करें। नीचे backend/factories/apikeys_default.json से फ़ील्ड की पूरी तालिका है:

🍪 से चिह्नित APIs ब्राउज़र सत्र कुकीज़ का उपयोग करते हैं; बाकी सेवा टोकन का उपयोग करते हैं।

सत्र कुकीज़

कुछ मॉड्यूल (LinkedIn, Twitter, TikTok) को आपके ब्राउज़र से सत्र कुकीज़ की आवश्यकता होती है। कुकीज़ backend/cookies/ में संग्रहीत की जाती हैं (कंटेनर में /app/cookies के रूप में माउंट) और पुनरारंभ होने पर बनी रहती हैं। इन्हें लोड करने के दो तरीके हैं, दोनों just के माध्यम से।

कुकीज़ व्यक्तिगत सत्र टोकन हैं: उन्हें साझा न करें या रिपॉजिटरी में कमिट न करें (backend/cookies/ git-ignored है)।

विकल्प A: ब्राउज़र निर्यात आयात करें

Cookie-Editor जैसे एक्सटेंशन के साथ साइट कुकीज़ को JSON फ़ाइल में निर्यात करें और इसे आयात करें:

just cookies-import linkedin ~/Downloads/linkedin_cookies.json

विकल्प B: ब्राउज़र से स्वचालित रूप से निकालें

आपके स्थानीय ब्राउज़र से सीधे कुकीज़ निकालता है। चलाने से पहले ब्राउज़र बंद करें (एक खुला ब्राउज़र अपने कुकी डेटाबेस को लॉक कर देता है):

# सभी इंस्टॉल किए गए ब्राउज़र आज़माएं (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com

# या कोई विशिष्ट
just cookies-grab linkedin linkedin.com brave

कमांड ब्राउज़र दर ब्राउज़र रिपोर्ट करता है कि वह क्या पढ़ सका और क्या नहीं, और फ़ाइल तभी लिखता है जब उसे मॉड्यूल को आवश्यक कुकीज़ मिलती हैं। उदाहरण के लिए, LinkedIn को li_at और JSESSIONID की आवश्यकता होती है।

कुकीज़ समय-समय पर समाप्त होती हैं (LinkedIn कुकीज़ 1 से 3 महीने के बीच चलती हैं)। जब कोई मॉड्यूल प्रमाणीकरण करना बंद कर देता है, तो कमांड फिर से चलाएँ।

विकास

विकास कार्यप्रवाह linting/pre-commit हुक के लिए एक वर्चुअलएनवी और एप्लिकेशन बनाने और चलाने के लिए Docker (या देशी just up-native प्रवाह) का उपयोग करता है।

डेव वातावरण सेट करना

just इंस्टॉल करें, फिर:

just setup
source .venv/bin/activate

यह pre-commit और ruff के साथ एक Python virtualenv बनाता है, और git हुक स्थापित करता है।

सामान्य रेसिपी

iKy अपडेट करें

नवीनतम परिवर्तन खींचें और Docker इमेज को पुनर्निर्माण करें:

git pull
just rebuild

अपडेट के दौरान अपनी API कुंजियों को संरक्षित करने के लिए, ग्राफिकल इंटरफ़ेस के apikeys मेनू में एक्सपोर्ट/इम्पोर्ट विकल्प का उपयोग करें।

विकी

• iKy विकी

वीडियो डेमो

Vimeo

परियोजना का समर्थन करें

चाहे आप इस परियोजना का उपयोग करते हों, इससे कुछ सीखा हो, या बस इसे पसंद करते हों, कृपया मुझे एक कॉफी खरीदकर इसका समर्थन करने पर विचार करें, ताकि मैं इस तरह की ओपन-सोर्स परियोजनाओं पर अधिक समय दे सकूं।

अस्वीकरण

जो कोई भी परियोजना में योगदान देता है या दे चुका है, जिसमें मैं भी शामिल हूं, टूल के उपयोग के लिए जिम्मेदार नहीं है (न तो कानूनी उपयोग और न ही अवैध उपयोग, और न ही "अन्य" उपयोग)।

ध्यान रखें कि यह सॉफ्टवेयर शुरू में एक मजाक के लिए लिखा गया था, फिर शैक्षिक उद्देश्यों (खुद को शिक्षित करने के लिए) के लिए, और अब लक्ष्य गुणवत्ता वाले मुफ्त सॉफ्टवेयर बनाकर समुदाय के साथ सहयोग करना है, और जबकि गुणवत्ता उत्कृष्ट नहीं है (कभी-कभी अच्छी भी नहीं), हम उत्कृष्टता का पीछा करने का प्रयास करते हैं।

समझें कि एकत्रित सभी जानकारी मुफ्त और ऑनलाइन उपलब्ध है, टूल केवल इसे खोजने, एकत्र करने और प्रदर्शित करने का प्रयास करता है। कई बार टूल खोज और संग्रह के अपने लक्ष्य को प्राप्त भी नहीं कर पाता। कृपया मेरी माँ को याद करने से पहले आवश्यक APIs लोड करें। यदि APIs के साथ भी यह वे "अच्छी" चीजें नहीं दिखाता जिन्हें आप देखने की उम्मीद करते हैं, तो मेरी माँ को याद करने से पहले अन्य ईमेल आज़माएँ। यदि आप अभी भी वे "अच्छी" चीजें नहीं देखते जिनकी आप अपेक्षा करते हैं, तो आप एक मुद्दा बना सकते हैं, ईमेल द्वारा या किसी भी RRSS के माध्यम से हमसे संपर्क कर सकते हैं, लेकिन ध्यान रखें कि मेरी माँ न तो निर्माता है और न ही परियोजना में योगदान करती है।

यदि आप संतुष्ट नहीं हैं तो हम आपके पैसे वापस नहीं करते हैं। मुझे आशा है कि आप टूल का उपयोग करने का उतना ही आनंद लेंगे जितना हम इसे बनाने में लेते हैं। प्रयास बहुत बड़ा था और है (समय, ज्ञान, कोडिंग, परीक्षण, समीक्षाएँ, आदि) लेकिन हम इसे फिर से करेंगे। यदि आप निर्देश और/या इस अस्वीकरण को स्पष्ट रूप से नहीं पढ़ सकते हैं तो टूल का उपयोग न करें।

वैसे, उन लोगों के लिए जो मेरी माँ को याद करने पर जोर देते हैं, उनकी कई साल पहले मृत्यु हो गई लेकिन मैं उन्हें उतना ही प्यार करता हूं जितना कि वे यहीं होतीं।