Flowsint

Flowsint एक ओपन-सोर्स OSINT ग्राफ अन्वेषण उपकरण है जो नैतिक जांच, पारदर्शिता और सत्यापन के लिए डिज़ाइन किया गया है।

नैतिकता: कृपया जिम्मेदार उपयोग दिशानिर्देशों के लिए ETHICS.md पढ़ें।

https://github.com/user-attachments/assets/eaabfa81-d7b3-414d-8cf7-f69b4e37bab6

https://github.com/user-attachments/assets/7457d94a-cf1d-4a97-949f-f9b1d8d92644

https://github.com/user-attachments/assets/65c3f26e-7132-4853-be45-21b8933688bd

योगदान

Flowsint अभी भी प्रारंभिक विकास में है और निश्चित रूप से समुदाय की मदद की आवश्यकता है! बेझिझक मुद्दे उठाएँ, सुविधाएँ प्रस्तावित करें, आदि।

आरंभ करें

पढ़ना नहीं चाहते? समझ गया। ये रहे आपके इंस्टॉल निर्देश:

Linux / macOS

1. पूर्व-आवश्यकताएँ स्थापित करें

• Docker
• Make

2. इंस्टॉल कमांड चलाएँ

git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod

Windows

Make की आवश्यकता नहीं। Command Prompt (cmd) और PowerShell दोनों में काम करता है।

1. पूर्व-आवश्यकताएँ स्थापित करें

• Docker Desktop (सुनिश्चित करें कि अगले चरण से पहले यह चल रहा है)
• Git

2. क्लोन करें और एनवायरनमेंट फ़ाइलें सेट करें

git clone https://github.com/reconurge/flowsint.git
cd flowsint

copy .env.example .env
copy .env.example flowsint-api\.env
copy .env.example flowsint-core\.env
copy .env.example flowsint-app\.env

3. प्रारंभ करें

docker compose -f docker-compose.prod.yml up -d

यह GitHub Container Registry से पूर्व-निर्मित इमेज खींचता है — किसी स्थानीय बिल्ड की आवश्यकता नहीं।

पहला लॉगिन

फिर http://localhost:5173/register पर जाएँ और एक खाता बनाएँ। डिफ़ॉल्ट रूप से कोई क्रेडेंशियल या खाता नहीं है।

✅ OSINT जांच के लिए उच्च स्तर की गोपनीयता की आवश्यकता होती है। सब कुछ आपकी मशीन पर संग्रहीत है।

नेटवर्क पर तैनात करें (टीम / सर्वर)

वही सेटअप सर्वर पर बिना किसी बदलाव के काम करता है: फ्रंटएंड UI प्रस्तुत करता है और सभी API कॉल को आंतरिक रूप से प्रॉक्सी करता है, इसलिए क्लाइंट के लिए कोई अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है।

git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# .env संपादित करें — नीचे "नेटवर्क पर उजागर करने से पहले" देखें
docker compose -f docker-compose.prod.yml up -d

नेटवर्क पर कोई भी व्यक्ति http://<server-ip>:5173 पर Flowsint तक पहुँच सकता है।

नेटवर्क पर उजागर करने से पहले, .env में डिफ़ॉल्ट रहस्य बदलें:

• AUTH_SECRET — प्रमाणीकरण टोकन पर हस्ताक्षर करता है। एक जनरेट करें: openssl rand -hex 32
• MASTER_VAULT_KEY_V1 — संग्रहीत API कुंजियों को एन्क्रिप्ट करता है। एक जनरेट करें: python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"
• NEO4J_PASSWORD — Neo4j डेटाबेस पासवर्ड।

अपने सर्वर होस्टनाम/IP को Host-हेडर अनुमत सूची में जोड़ें flowsint-app/nginx.conf में (map $http_host $is_flowsint_host देखें)। डिफ़ॉल्ट अनुमत सूची केवल localhost / 127.0.0.1 / [::1] को स्वीकार करती है, जो एकल-उपयोगकर्ता इंस्टॉल को DNS रीबाइंडिंग से बचाती है; LAN और सार्वजनिक डिप्लॉय को अपना स्वयं का होस्टनाम जोड़ना होगा। उसी मैप ब्लॉक में दो टिप्पणी की गई टेम्पलेट लाइनें प्रारूप दिखाती हैं।

केवल पोर्ट 5173 नेटवर्क पर उजागर होता है। PostgreSQL, Redis, Neo4j और API सर्वर पर 127.0.0.1 से बंधे हैं और केवल फ्रंटएंड प्रॉक्सी के माध्यम से पहुँच योग्य हैं।

latest के बजाय एक विशिष्ट संस्करण को पिन करने के लिए, .env में FLOWSINT_VERSION सेट करें (जैसे FLOWSINT_VERSION=1.2.10)।

HTTPS (विश्वसनीय LAN से परे अनुशंसित): पोर्ट 5173 के सामने कोई भी रिवर्स प्रॉक्सी रखें। Caddy के साथ उदाहरण:

flowsint.example.com {
    reverse_proxy 127.0.0.1:5173
}

रिवर्स प्रॉक्सी के साथ फ्रंटिंग करते समय, docker-compose.prod.yml में ऐप पोर्ट को लोकलहोस्ट से बांधें ("127.0.0.1:5173:8080") ताकि क्लाइंट केवल HTTPS के माध्यम से जा सकें।

यह क्या है?

Flowsint एक ग्राफ-आधारित जांच उपकरण है जो टोही और OSINT (ओपन सोर्स इंटेलिजेंस) पर केंद्रित है। यह आपको एक दृश्य ग्राफ इंटरफ़ेस और स्वचालित एनरिचर्स के माध्यम से संस्थाओं के बीच संबंधों का पता लगाने की अनुमति देता है।

उपलब्ध एनरिचर्स

डोमेन एनरिचर्स

• रिवर्स DNS रिज़ॉल्यूशन - किसी IP की ओर इशारा करने वाले डोमेन खोजें
• DNS रिज़ॉल्यूशन - डोमेन को IP पतों में हल करें
• उपडोमेन खोज - उपडोमेन की गणना करें
• WHOIS लुकअप - डोमेन पंजीकरण जानकारी प्राप्त करें
• डोमेन से वेबसाइट - डोमेन को वेबसाइट इकाई में बदलें
• डोमेन से रूट डोमेन - रूट डोमेन निकालें
• डोमेन से ASN - डोमेन से संबद्ध ASN खोजें
• डोमेन इतिहास - ऐतिहासिक डोमेन डेटा प्राप्त करें

IP एनरिचर्स

• IP सूचना - भौगोलिक स्थान और नेटवर्क विवरण प्राप्त करें
• IP से ASN - IP के लिए ASN खोजें

ASN एनरिचर्स

• ASN से CIDR - ASN के लिए IP रेंज प्राप्त करें

CIDR एनरिचर्स

• CIDR से IP - एक श्रेणी में IP की गणना करें

सोशल मीडिया एनरिचर्स

• Maigret - सोशल प्लेटफ़ॉर्म पर उपयोगकर्ता नाम खोज

संगठन एनरिचर्स

• संगठन से ASN - संगठन के स्वामित्व वाले ASN खोजें
• संगठन सूचना - कंपनी विवरण प्राप्त करें
• संगठन से डोमेन - संगठन के स्वामित्व वाले डोमेन खोजें

क्रिप्टोकरेंसी एनरिचर्स

• वॉलेट से लेन-देन - लेन-देन इतिहास प्राप्त करें
• वॉलेट से NFT - वॉलेट द्वारा स्वामित्व वाले NFT खोजें

वेबसाइट एनरिचर्स

• वेबसाइट क्रॉलर - वेबसाइट संरचना को क्रॉल और मैप करें
• वेबसाइट से लिंक - सभी लिंक निकालें
• वेबसाइट से डोमेन - URL से डोमेन निकालें
• वेबसाइट से वेबट्रैकर्स - ट्रैकिंग स्क्रिप्ट पहचानें
• वेबसाइट से टेक्स्ट - टेक्स्ट सामग्री निकालें

ईमेल एनरिचर्स

• ईमेल से Gravatar - Gravatar प्रोफ़ाइल खोजें
• ईमेल से उल्लंघन - डेटा उल्लंघन डेटाबेस जाँचें
• ईमेल से डोमेन - संबद्ध डोमेन खोजें

फ़ोन एनरिचर्स

• फ़ोन से उल्लंघन - उल्लंघनों में फ़ोन नंबर जाँचें

व्यक्ति एनरिचर्स

• व्यक्ति से संगठन - संगठनात्मक संबद्धताएँ खोजें
• व्यक्ति से डोमेन - व्यक्ति से संबद्ध डोमेन खोजें

एकीकरण एनरिचर्स

• N8n कनेक्टर - N8n वर्कफ़्लो से कनेक्ट करें

प्रोजेक्ट संरचना

प्रोजेक्ट स्वायत्त मॉड्यूल में संगठित है:

कोर मॉड्यूल

• flowsint-core: कोर उपयोगिताएँ, ऑर्केस्ट्रेटर, वॉल्ट, celery कार्य, और बेस क्लासेस
• flowsint-types: Pydantic मॉडल और प्रकार परिभाषाएँ
• flowsint-enrichers: एनरिचर मॉड्यूल, स्कैनिंग तर्क, और उपकरण
• flowsint-api: FastAPI सर्वर, API मार्ग, और केवल स्कीमा
• flowsint-app: फ्रंटएंड अनुप्रयोग

मॉड्यूल निर्भरताएँ

flowsint-app (फ्रंटएंड)
    ↓
flowsint-api (API सर्वर)
    ↓
flowsint-core (ऑर्केस्ट्रेटर, कार्य, वॉल्ट)
    ↓
flowsint-enrichers (एनरिचर्स और उपकरण)
    ↓
flowsint-types (प्रकार)

डेवलपमेंट सेटअप

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

• Docker

चलाएँ

Linux / macOS (Make आवश्यक है):

make dev

Windows (cmd या PowerShell, Make के बिना — पहले .env फ़ाइलें बनाएँ, आरंभ करें देखें):

docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f

विकास

एप्लिकेशन http://localhost:5173 पर सुलभ है।

मॉड्यूल विवरण

flowsint-core

अन्य सभी मॉड्यूल द्वारा उपयोग की जाने वाली कोर उपयोगिताएँ और बेस क्लासेस:

• डेटाबेस कनेक्शन (PostgreSQL, Neo4j)
• प्रमाणीकरण और प्राधिकरण
• लॉगिंग और इवेंट हैंडलिंग
• कॉन्फ़िगरेशन प्रबंधन
• एनरिचर्स और उपकरणों के लिए बेस क्लासेस
• उपयोगिता फ़ंक्शन

flowsint-types

सभी डेटा प्रकारों के लिए Pydantic मॉडल:

• डोमेन, IP, ASN, CIDR
• व्यक्ति, संगठन, ईमेल, फ़ोन
• वेबसाइट, सोशल प्रोफ़ाइल, क्रेडेंशियल
• क्रिप्टो वॉलेट, लेन-देन, NFT
• और भी बहुत कुछ...

flowsint-enrichers

एनरिचर मॉड्यूल जो डेटा प्रोसेस करते हैं:

• डोमेन एनरिचर्स (उपडोमेन, WHOIS, रिज़ॉल्यूशन)
• IP एनरिचर्स (भौगोलिक स्थान, ASN लुकअप)
• सोशल मीडिया एनरिचर्स (Maigret, Sherlock)
• ईमेल एनरिचर्स (उल्लंघन, Gravatar)
• क्रिप्टो एनरिचर्स (लेन-देन, NFT)
• और भी बहुत कुछ...

flowsint-api

FastAPI सर्वर प्रदान करता है:

• REST API एंडपॉइंट
• प्रमाणीकरण और उपयोगकर्ता प्रबंधन
• ग्राफ़ डेटाबेस एकीकरण
• रीयल-टाइम इवेंट स्ट्रीमिंग

flowsint-app

फ्रंटएंड अनुप्रयोग।

• आधुनिक और UI-अनुकूल इंटरफ़ेस
• प्रदर्शन के लिए निर्मित (हज़ारों नोड्स पर भी कोई अंतराल नहीं)

विकास कार्यप्रवाह

1. नए प्रकार जोड़ना: flowsint-types मॉड्यूल में जोड़ें
2. नए एनरिचर जोड़ना: flowsint-enrichers मॉड्यूल में जोड़ें
3. नए API एंडपॉइंट जोड़ना: flowsint-api मॉड्यूल में जोड़ें
4. नई उपयोगिताएँ जोड़ना: flowsint-core मॉड्यूल में जोड़ें

परीक्षण

प्रत्येक मॉड्यूल का अपना (अपूर्ण) परीक्षण सूट है:

# कोर मॉड्यूल का परीक्षण
cd flowsint-core
uv run pytest

# टाइप्स मॉड्यूल का परीक्षण
cd ../flowsint-types
uv run pytest

# एनरिचर्स मॉड्यूल का परीक्षण
cd ../flowsint-enrichers
uv run pytest

# API मॉड्यूल का परीक्षण
cd ../flowsint-api
uv run pytest

योगदान

1. मॉड्यूलर संरचना का पालन करें
2. निर्भरता प्रबंधन के लिए Poetry का उपयोग करें
3. नई कार्यक्षमता के लिए परीक्षण लिखें
4. आवश्यकतानुसार दस्तावेज़ीकरण अपडेट करें

⚖️ कानूनी और नैतिक उपयोग

नैतिकता: कृपया जिम्मेदार उपयोग दिशानिर्देशों के लिए ETHICS.md पढ़ें।

Flowsint केवल कानूनी, नैतिक जांच और अनुसंधान उद्देश्यों के लिए डिज़ाइन किया गया है।

इसे निम्नलिखित की सहायता के लिए बनाया गया था:

• साइबर सुरक्षा शोधकर्ता और विश्लेषक
• पत्रकार और OSINT अन्वेषक
• कानून प्रवर्तन या धोखाधड़ी जांच दल
• आंतरिक खतरा खुफिया या डिजिटल जोखिम विश्लेषण करने वाले संगठन

Flowsint का उपयोग निम्नलिखित के लिए नहीं किया जाना चाहिए:

• अनधिकृत घुसपैठ, निगरानी, या डेटा संग्रह
• उत्पीड़न, डॉक्सिंग, या व्यक्तियों को लक्षित करना
• राजनीतिक हेरफेर, गलत सूचना, या गोपनीयता कानूनों का उल्लंघन

इस सॉफ्टवेयर का कोई भी दुरुपयोग सख्त वर्जित है और ETHICS.md में परिभाषित नैतिक सिद्धांतों के विरुद्ध है।

❤️ समर्थन