📡💘🌎 | geowifi

Durchsuche WiFi-Geolokalisierungsdaten nach BSSID und SSID in verschiedenen öffentlichen Datenbanken.

💾 Datenbanken

✔️Voraussetzungen

• Python3.
• Um Emojis unter Windows anzuzeigen, wird empfohlen, die neue Windows-Terminal zu installieren.

🔑 APIs und Konfigurationsdatei

Das Tool hat eine Konfigurationsdatei im Ordner gw_utils mit dem Namen config.yaml. Im Folgenden wird jeder Konfigurationsparameter und wie die erforderlichen Informationen bezogen werden, erklärt:

• wigle_auth:

  Um den Wigle-Dienst nutzen zu können, muss ein API-Schlüssel besorgt und die Datei gw_utils/config.yaml konfiguriert werden, indem der Wert des Parameters "wigle_auth" durch die von Wigle bereitgestellten "Encoded for use"-Daten ersetzt wird.

• google_api:

  Um die Google Geolocation Services nutzen zu können, muss ein API-Schlüssel besorgt und die Datei gw_utils/config.yaml konfiguriert werden, indem der Wert des Parameters "google_api" durch die bereitgestellte "API" ersetzt wird. Google stellt eine kostenlose monatliche Nutzung im Wert von 200 $ zur Verfügung.

• combain_api:

  Um die Combain API nutzen zu können, muss ein API-Schlüssel besorgt und die Datei gw_utils/config.yaml konfiguriert werden, indem der Wert des Parameters "" durch die bereitgestellte "" ersetzt wird. Combain bietet eine kostenlose Testversion und kostenpflichtige Tarife an.

🛠️ Installation

Klonen Sie zunächst das GitHub-Repository lokal und wechseln Sie dann in den geowifi-Ordner. git muss auf Ihrem System vorhanden sein.

git clone https://github.com/GONZOsint/geowifi
cd ./geowifi/

Alternativ kann https://github.com/GONZOsint/geowifi/archive/refs/heads/main.zip verwendet und dann die heruntergeladene Datei entpackt werden.

Lokales Python verwenden

Hinweis: Verwenden Sie den Paketmanager pip, um die Abhängigkeiten zu installieren.

virtualenv geowifi
source geowifi/bin/activate
python3 -m pip install -r requirements.txt

Docker

docker build -t geowifi:latest .

🔎 Verwendung

usage: geowifi.py [-h] [-s {bssid,ssid}] [-o {map,json}] identifier

Search for information about a network with a specific BSSID or SSID.

positional arguments:
  identifier            The BSSID or SSID of the network to search for.

options:
  -h, --help            show this help message and exit
  -s {bssid,ssid}, --search-by {bssid,ssid}
                        Specifies whether to search by BSSID or SSID (default: bssid)
  -o {map,json}, --output-format {map,json}
                        Specifies the output format for the search results (default: map)

• Suche nach BSSID:

python3 geowifi.py -s bssid <input>

• Suche nach SSID:

python3 geowifi.py -s ssid <input>

Es ist möglich, die Ergebnisse im JSON-Format mit dem Parameter -o json zu exportieren und die Standorte auf einer HTML-Karte mit -o map anzuzeigen.

🐳 Docker-Verwendung

docker run --rm geowifi:latest

• Suche nach BSSID:

docker run --rm geowifi:latest -s bssid <input>

• Suche nach SSID:

docker run --rm geowifi:latest -s ssid <input>

🗺️ Beispiel für Kartenausgabe

💾 Beispiel für JSON-Ausgabe

[
  {
    "module": "google", 
    "bssid": "C8:XX:XX:XX:5E:45", 
    "latitude": 33.571844, 
    "longitude": -1XX.XXXXX97
  }, 
  {
    "module": "combain", 
    "error": "Not enough witooth"}, 
  {
    "module": "mylnikov", 
    "error": "Object was not found"
  },
  {
    "module": "vendor_check", 
    "vendor": "Cisco-Linksys, LLC"}, 
  {
    "module": "apple", 
    "bssid": "C8:XX:XX:XX:5E:45", 
    "latitude": 33.57198715, 
    "longitude": -1XX.XXXXX12}, 
  {
    "module": "wigle", 
    "bssid": "C8:XX:XX:XX:5E:45", 
    "ssid": "Vertigo", 
    "latitude": 33.60998154, 
    "longitude": -1XX.XXXXX22}, 
  {
    "module": "wifidb", 
    "bssid": "C8:XX:XX:XX:5E:45", 
    "ssid": "Vertigo", 
    "latitude": 33.6109, 
    "longitude": -1XX.XXXXX533
  }
]

📢 Erwähnungen

• Dieses Projekt verwendet einen Teil der Forschung und den Code von iSniff-GPS.
• Dank an Micah Hoffman für seine Aufmerksamkeit und seine Antworten auf meine Fragen.
• Dank an kennbro dafür, dass er mir seine gewissenhaften Augen geliehen hat, um mir Feedback zu geben.