Kamerka GUI

Kamerka GUI è un dashboard di ricognizione basato su Django per scoprire, esaminare e classificare i sistemi di controllo industriale, i dispositivi dell'Internet delle Cose (IoT) e i dispositivi medici esposti su Internet. Combina dati di ricerca Shodan, visualizzazione Google Maps, screenshot dei dispositivi, arricchimento di intelligence passiva e helper di scansione/exploit selezionati in un'unica interfaccia web.

L'app aiuta a ridurre il rumore durante la revisione con un interruttore Filter Honeypots nelle tabelle dei dispositivi. Questo esclude i dispositivi che espongono indicatori stile honeypot, così gli analisti possono concentrarsi prima su risorse probabilmente reali. Kamerka mostra anche un campo Indicator del dispositivo, costruito da banner analizzati, risposte di protocollo, etichette di screenshot e altri metadati del dispositivo, per spiegare perché un dispositivo è stato segnalato o come può essere localizzato o classificato.

Utilizzalo solo per ricerche autorizzate, inventario delle risorse, gestione difensiva dell'esposizione e segnalazione ai proprietari appropriati o ai team CERT/CSIRT.

Cosa Fa

• Cerca su Shodan categorie di dispositivi ICS, IoT, sanitari e infrastruttura attaccante.
• Supporta ricerche per paese e ricerche per coordinate.
• Memorizza ricerche e dispositivi scoperti in un database Django locale.
• Mostra cronologia delle ricerche, dashboard, statistiche, preferiti e una galleria di screenshot.
• Visualizza i dispositivi su viste Google Maps globali e per dispositivo.
• Analizza gli indicatori dei dispositivi da banner e risposte di protocollo per aiutare con la geolocalizzazione.
• Mostra intelligence a livello di dispositivo, dati banner, screenshot, hostname, organizzazione, posizione, porte, prodotti e vulnerabilità.
• Esegue scansioni host Shodan e arricchimento API Whois XML dalla scheda Intel.
• Supporta l'importazione di output Nmap XML e l'esecuzione di scansioni Nmap NSE selezionate.
• Include helper di exploit proof-of-concept selezionati per famiglie di dispositivi specifiche.

Schermate

Mappa

Intelligence dispositivo

Intelligence dispositivo con screenshot

Galleria screenshot

Dashboard

Viste Principali

• Dashboard: conteggi di alto livello, crediti Shodan, ricerche recenti, grafici, copertura mondiale e preferiti.
• Database: tabella ricercabile di tutti i dispositivi scoperti con filtro per probabili honeypot.
• History: ricerche precedenti con nomi di paesi, categorie di dispositivi selezionate e collegamenti ai risultati.
• Map: mappa Google Maps globale con cluster dei dispositivi scoperti.
• Gallery: tutti gli screenshot dei dispositivi raccolti, con filtro per paese.
• Results: tabella dei dispositivi per ricerca, mappa, statistiche e navigazione in stile esportazione.
• Device: schede Locate, Intel e Exploit per un singolo dispositivo.

Requisiti

• Python 3.10-3.13 consigliato per lo stack Django 5.2 e Celery mantenuto.
• Server Redis per lavori in background Celery.
• Chiave API Shodan. Si consiglia un account a pagamento perché le ricerche estese consumano crediti/pagine.
• Chiave API JavaScript Google Maps per mappe e funzionalità di percorso/posizione.
• Chiave API Whois XML se si desidera l'arricchimento Whois.
• GeoLite2-City.mmdb nella radice del repository se si desidera la geolocalizzazione dell'importazione Nmap XML.
• Nmap installato localmente se si desidera eseguire scansioni attive Nmap.

Le dipendenze Python sono elencate in requirements.txt. Il progetto ora punta alla linea Django 5.2 LTS, Celery 5.6 e pacchetti Python vincolati in modo che le installazioni rimangano aggiornate senza saltare a versioni maggiori incompatibili.

Installazione

Clona il repository e crea un ambiente virtuale:

git clone https://github.com/woj-ciech/Kamerka-GUI.git
cd Kamerka-GUI
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt

Se python3.12 non è disponibile, usa un altro interprete Python 3.10-3.13. Evita di riutilizzare un vecchio ambiente virtuale Python 3.8/3.9 perché il set di dipendenze attuale richiede Python 3.10+.

Crea lo schema del database:

python manage.py migrate

Crea keys.json nella radice del repository:

{
  "keys": {
    "shodan": "YOUR_SHODAN_API_KEY",
    "google_maps": "YOUR_GOOGLE_MAPS_API_KEY",
    "whoisxmlapi": "YOUR_WHOIS_XML_API_KEY"
  }
}

Avvia Redis in un terminale separato:

redis-server

Avvia un worker Celery in un altro terminale:

source .venv/bin/activate
celery --app kamerka worker --loglevel=info

Avvia il server di sviluppo Django:

source .venv/bin/activate
python manage.py runserver

Apri l'app:

http://localhost:8000/

Note di Configurazione

• keys.json è richiesto in fase di esecuzione perché l'app legge le chiavi API da keys['keys'].
• Mantieni keys.json fuori dal controllo versione. Contiene credenziali private.
• Il database predefinito è SQLite. Va bene per test locali; utilizza un database di produzione se lo distribuisci.
• Le ricerche in background, le scansioni Shodan, le scansioni Whois e le importazioni Nmap dipendono da worker Celery attivi.
• Le ricerche per coordinate utilizzano query geografiche Shodan intorno alla latitudine/longitudine fornita.
• Grandi ricerche Shodan possono consumare crediti rapidamente. Usa i limiti di pagina intenzionalmente.

Flusso di Lavoro Tipico

1. Apri la pagina di ricerca e scegli una modalità di ricerca ICS, IoT, sanitaria o infrastruttura.
2. Seleziona una o più categorie di dispositivi.
3. Scegli un paese o fornisci coordinate, poi scegli quante pagine Shodan raccogliere.
4. Invia la ricerca e attendi il completamento del task Celery.
5. Esamina il cruscotto, la cronologia o la pagina dei risultati per ricerca.
6. Apri singoli dispositivi per ispezionare Intel, posizione sulla mappa, screenshot, risultati scansione Shodan e dati Whois.
7. Utilizza scansioni attive o helper di exploit solo quando hai autorizzazione esplicita.

Categorie di Ricerca Supportate

L'elenco completo delle query Shodan supportate è mantenuto in queries.md.

Le categorie generali includono:

• Sistemi di controllo industriale e protocolli OT.
• Telecamere e dispositivi IoT in grado di catturare screenshot.
• Sistemi sanitari e medici.
• Automazione degli edifici e infrastrutture intelligenti.
• Indicatori di infrastruttura attaccante.
• Servizi esposti generici come VNC, RDP, MQTT, stampanti e webcam.

Supporto Nmap