reconurge/flowsintUna piattaforma moderna per indagini visive, flessibili ed estensibili basate su grafi. Per analisti e investigatori di cybersecurity.
Flowsint è uno strumento di esplorazione grafica OSINT open-source progettato per indagini etiche, trasparenza e verifica.
Etica: Si prega di leggere ETHICS.md per le linee guida sull'uso responsabile.
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 è ancora in fase di sviluppo iniziale e ha sicuramente bisogno dell'aiuto della community! Sentiti libero di segnalare problemi, proporre funzionalità, ecc.
Non vuoi leggere? Capito. Ecco le istruzioni di installazione:
git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod
Niente Make. Funziona sia in Command Prompt (cmd) che PowerShell.
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
docker compose -f docker-compose.prod.yml up -d
Questo estrae le immagini pre-costruite dal GitHub Container Registry — nessuna build locale necessaria.
Poi vai su http://localhost:5173/register e crea un account. Non ci sono credenziali o account predefiniti.
✅ Le indagini OSINT richiedono un alto livello di privacy. Tutto è archiviato sulla tua macchina.
La stessa configurazione funziona subito su un server: il frontend serve l'interfaccia utente e fa da proxy a tutte le chiamate API internamente, quindi non è necessaria alcuna configurazione aggiuntiva per i client.
git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# Modifica .env — vedi "Prima di esporre su una rete" di seguito
docker compose -f docker-compose.prod.yml up -d
Chiunque sulla rete può quindi accedere a Flowsint all'indirizzo http://<indirizzo-server>:5173.
Prima di esporre su una rete, modifica i segreti predefiniti in .env:
AUTH_SECRET — firma i token di autenticazione. Generane uno: openssl rand -hex 32MASTER_VAULT_KEY_V1 — crittografa le chiavi API memorizzate. Generane uno: python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"NEO4J_PASSWORD — password del database Neo4j.Aggiungi anche il nome host/indirizzo IP del tuo server alla lista consentita dell'Host-header in flowsint-app/nginx.conf (cerca map $http_host $is_flowsint_host). La lista consentita predefinita accetta solo localhost / 127.0.0.1 / [::1], il che difende le installazioni a utente singolo da attacchi DNS rebinding; le reti LAN e le distribuzioni pubbliche devono opt-in per il proprio nome host. Due righe di modello commentate nello stesso blocco map mostrano il formato.
Solo la porta 5173 è esposta alla rete. PostgreSQL, Redis, Neo4j e l'API sono vincolati a 127.0.0.1 sul server e raggiungibili solo tramite il proxy del frontend.
Per fissare una versione specifica invece di latest, imposta FLOWSINT_VERSION in .env (ad es. FLOWSINT_VERSION=1.2.10).
HTTPS (consigliato oltre una LAN fidata): posiziona un reverse proxy davanti alla porta 5173. Esempio con Caddy:
flowsint.example.com {
reverse_proxy 127.0.0.1:5173
}
Quando si utilizza un reverse proxy, vincola anche la porta dell'app a localhost in docker-compose.prod.yml ("127.0.0.1:5173:8080") in modo che i client possano passare solo attraverso HTTPS.
Flowsint è uno strumento di indagine basato su grafi focalizzato su ricognizione e OSINT (Open Source Intelligence). Permette di esplorare le relazioni tra entità attraverso un'interfaccia grafica visiva e arricchitori automatizzati.
Arricchitori di dominio
Arricchitori IP
Arricchitori ASN
Arricchitori CIDR
Arricchitori di social media
Arricchitori di organizzazione
Arricchitori di criptovaluta
Arricchitori di sito web
Arricchitori email
Arricchitori telefonici
Arricchitori individuali
Arricchitori di integrazione
Il progetto è organizzato in moduli autonomi:
flowsint-app (frontend)
↓
flowsint-api (server API)
↓
flowsint-core (orchestratore, task, vault)
↓
flowsint-enrichers (arricchitori e strumenti)
↓
flowsint-types (tipi)
Linux / macOS (richiede Make):
make dev
Windows (cmd o PowerShell, senza Make — crea prima i file .env, vedi Per iniziare):
docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f
L'app è accessibile all'indirizzo http://localhost:5173.
Utility core e classi base utilizzate da tutti gli altri moduli:
Modelli Pydantic per tutti i tipi di dati:
Moduli arricchitori che elaborano i dati:
Server FastAPI che fornisce:
Applicazione frontend.
flowsint-typesflowsint-enrichersflowsint-apiflowsint-coreOgni modulo ha la propria suite di test (incompleta):
# Test del modulo core
cd flowsint-core
uv run pytest
# Test del modulo types
cd ../flowsint-types
uv run pytest
# Test del modulo enrichers
cd ../flowsint-enrichers
uv run pytest
# Test del modulo API
cd ../flowsint-api
uv run pytest
Etica: Si prega di leggere ETHICS.md per le linee guida sull'uso responsabile.
Flowsint è progettato esclusivamente per scopi di indagine e ricerca legali ed etici.
È stato creato per assistere:
Flowsint non deve essere utilizzato per:
Qualsiasi uso improprio di questo software è severamente vietato e va contro i principi etici definiti in ETHICS.md.