Signal OPS

Eine Full-Spectrum-All-Source-Signalerfassungs-Fusionsplattform für Sicherheitsforschung und -training. Signal OPS zieht Dutzende offene Sammelquellen — WLAN/Bluetooth/Mobilfunkmast-Datenbanken, Internet-Expositions-Scanner, Kamera-Indizes, ADS-B-Flugdaten-Feeds, Satelliten-TLE-Tracking und SDR/APRS-Netzwerke — in eine einzige taktische Karte und Flask-API zusammen, korreliert die RF-, Mobilfunk-, Luftraum-, Orbital- und Überwachungsdomänen in einem einzigen Echtzeit-Betriebsbild, mit optionalen KI-gestützten Bedrohungszusammenfassungen obendrauf.

Funktionen

• Unified RF/OSINT-Scan — ein einziger Aufruf verteilt sich parallel auf WLAN-, Bluetooth-, Mobilfunkmast-, IoT-, Kamera- und Flugzeugquellen, dedupliziert und bewertet die Ergebnisse.
• Kamera-Erkennung — Shodan, FOFA, BinaryEdge, Windy Webcams, OpenStreetMap-Überwachungsknoten und Insecam, nach Koordinaten oder nach Land.
• Mobilfunk-Intelligenz — Mobilfunkmast-Abfragen (WiGLE, OpenCellID) mit Offline-MCC/MNC → Betreiber/Land-Auflösung und IMSI-Catcher-/Stingray-Heuristiken.
• Drahtlose Bedrohungserkennung — Erkennung von Rogue-/Evil-Twin-Zugangspunkten und Identifizierung von Bluetooth-Trackern (AirTag, Tile, SmartTag…).
• Luftraum-Überwachung — Live-ADS-B über adsb.fi und OpenSky, Notfall-Squawk-Dekodierung, Drohnen-Heuristiken und eine GPS-Störungs-Heatmap, die aus Flugzeug-NAC-P abgeleitet wird.
• Orbital-Tracking — CelesTrak-TLE-Aufnahme mit SGP4-Ausbreitung, Missionsklassifizierung und SatNOGS-Bodenstations-Overlay.
• SDR & APRS — Öffentliche KiwiSDR-Empfängerkarte und APRS.fi-Stationsabfragen.
• IP-Bedrohungsintelligenz — Multi-Quellen-Aggregation (ipinfo, AbuseIPDB, CriminalIP, LeakIX, ZoomEye) mit leichtem Portscan und kombinierter Risikobewertung.
• Watchlist & Alerts — Verfolgen Sie bestimmte BSSIDs, SSIDs, IPs, MACs oder ICAO-Hexadezimalwerte und erhalten Sie Treffer während Scans.
• KI-Analyse (optional) — Google Gemini fasst Scan-Ergebnisse in Bewertungen und Risikostufen zusammen, wenn ein Schlüssel bereitgestellt wird.

Fast jede Quelle ist optional. Wenn ein Schlüssel nicht gesetzt ist, wird dieser Fetcher elegant übersprungen — die kostenlosen Quellen (OpenStreetMap, Insecam, ipinfo.io, ADS-B, CelesTrak, KiwiSDR) funktionieren ganz ohne Schlüssel.

Screenshots

SIGINT-Karte — vereinheitlichte Multi-Quellen-Ansicht

Die Hauptkarte verschmilzt WLAN-, Bluetooth-, Mobilfunk-, Kamera- und Flugzeug-Ebenen über demselben Gebiet, mit umschaltbaren Overlays für OSM-Kameras, ALPR/Flock-Netzwerke und Polizeireviere.

Überwachung & CCTV

Überwachungs-Feed	CCTV-Erkennung

Die Überwachungsliste bewertet jedes Gerät (z. B. "Verdacht 35/100: Nicht authentifizierte Kamera") und führt Router, Fernseher und exponierte Kameras aus WiGLE, Insecam und OSM zusammen. Die CCTV-Ansicht gruppiert entdeckte Kameras nach Quelle mit gerätespezifischem Risiko und Live-/Metadaten-Status.

Mobilfunkmast-Intelligenz & SDR / APRS

Mobilfunkmast-Heatmap	SDR / APRS-Netzwerk

Mobilfunkmast-Intelligenz stellt die Mastdichte mit MCC/MNC-Betreiberabfrage dar; die SDR-Ansicht kartiert öffentliche KiwiSDR-Empfänger und APRS-Stationen mit Rufzeichen-Abfrage.

Anforderungen

• Python 3.9+
• Die unten aufgeführten Python-Pakete

Kernabhängigkeiten:

flask
requests
python-dotenv

Empfohlen (aktiviert die volle Funktionalität — Caching, Ratenbegrenzung, Satellitenausbreitung):

cachetools        # begrenzter Geo-Cache (fällt auf ein unbegrenztes Dict zurück, wenn nicht vorhanden)
flask-limiter     # Anfrage-Ratenbegrenzung
sgp4              # Satellitenpositions-Ausbreitung für /api/satellites
google-genai      # Gemini-KI-Analyse (nur wenn Sie GEMINI_API_KEY verwenden)

Alles installieren:

pip install flask requests python-dotenv cachetools flask-limiter sgp4 google-genai

Einrichtung

1. Klonen und ins Projekt wechseln

git https://github.com/emrekybs/signalops.git
unzip signalops-v1.zip

2. (Optional) Virtuelle Umgebung erstellen

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate

3. Abhängigkeiten installieren

pip install -r requirements.txt

Wenn Sie keine requirements.txt haben, verwenden Sie die pip install-Zeile aus dem Abschnitt „Anforderungen" oben.

4. Umgebung konfigurieren

Kopieren Sie die Beispieldatei und füllen Sie die Schlüssel aus, die Sie haben:

cp .env.example .env

Öffnen Sie dann .env und fügen Sie Ihre API-Schlüssel ein. Jeder Schlüssel ist optional — lassen Sie jede Zeile leer (oder löschen Sie sie), um diese Quelle zu deaktivieren. Im nächsten Abschnitt erfahren Sie, was jeder Schlüssel bewirkt und wo Sie ihn erhalten.

5. (Optional) Lokale Datensätze hinzufügen

Für sofortige Offline-Kamera- und Revierabfragen platzieren Sie diese unter einem data/-Verzeichnis (oder zeigen Sie mit DATA_DIR woanders hin):

data/CAMERAS_WITH_NETWORK_DATA.geojson   # Punkt-Features (Kameras)
data/police_precincts_usa.geojson        # Polygon-Features (US-Reviere)
data/camera_networks.json                # Netzwerk-Sharing-Metadaten
data/tiles/{z}/{x}/{y}.json              # optionaler gekachelter Kamera-Datensatz

Wenn diese Dateien fehlen, fällt die App automatisch auf Live-OpenStreetMap-Overpass-Abfragen zurück.

6. Ausführen

python app_v2.py

Der Server startet auf http://0.0.0.0:8080. Öffnen Sie http://localhost:8080 in Ihrem Browser.

Prüfen Sie jederzeit, welche Anbieter erfolgreich geladen wurden:

GET /api/status     # aktive vs. fehlende Schlüssel
GET /api/debug      # Bool pro Schlüssel + Live-WiGLE-Auth-Test

Umgebungsvariablen

Erstellen Sie eine .env-Datei im Projektstammverzeichnis. Unten ist die vollständige Liste, die von der App gelesen wird.

API-Schlüssel für Datenquellen (alle optional)

App-Konfiguration

Quellen ohne Schlüssel (immer aktiv)

Diese benötigen keine Konfiguration: OpenStreetMap Overpass, Insecam, EarthCam, ipinfo.io, ADS-B (adsb.fi / OpenSky), CelesTrak TLE, SatNOGS und KiwiSDR.

.env.example

Speichern Sie dies als .env.example in Ihrem Repository, damit andere das Format kennen:

# ── Signal OPS-Umgebung ──
# Jeder Schlüssel ist optional. Leer lassen, um diese Quelle zu deaktivieren.

# WLAN / Bluetooth / Mobilfunk
WIGLE_API_NAME=
WIGLE_API_TOKEN=
OPENCELLID_API_KEY=

# Internet-Expositions-Scanner
SHODAN_API_KEY=
CENSYS_API_ID=
CENSYS_API_SECRET=
ZOOMEYE_API_KEY=
FOFA_EMAIL=
FOFA_API_KEY=
HUNTERHOW_API_KEY=
NETLAS_API_KEY=
LEAKIX_API_KEY=
CRIMINALIP_API_KEY=
BINARYEDGE_API_KEY=

# Kameras & IP-Reputation
WINDY_API_KEY=
ABUSEIPDB_API_KEY=

# Flugzeuge & Amateurfunk
ADSB_API_KEY=
APRS_FI_KEY=

# KI-Analyse
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# App-Konfiguration
DATA_DIR=./data
FLASK_SECRET_KEY=

API-Übersicht

Eine Auswahl der verfügbaren Endpunkte (die vollständige Liste finden Sie im Quellcode):

Hinweise & Einschränkungen

• Einige Anbieter (z. B. ZoomEye, CriminalIP) können von TLS-Störungen bestimmter ISPs betroffen sein und sind standardmäßig in einigen Scan-Listen deaktiviert — siehe die Inline-Kommentare im Quellcode, um sie hinter einem VPN/Proxy wieder zu aktivieren.
• Ratenbegrenzungen variieren stark zwischen den Anbietern; kostenlose Stufen können klein sein (WiGLE-Mobilfunk ist z. B. ~100 Abfragen/Tag). Die App überspringt oder weicht aus, wo sie kann, aber Sie sind dafür verantwortlich, innerhalb der Grenzen jedes Anbieters zu bleiben.
• Lokale Datensätze sind optional, beschleunigen aber Kamera-/Revierabfragen erheblich gegenüber Live-Overpass-Abfragen.