📡💘🌎 | geowifi

Cerca dati di geolocalizzazione WiFi per BSSID e SSID su diversi database pubblici.

💾 Database

✔️ Prerequisiti

• Python3.
• Per visualizzare le emoji su Windows, si consiglia di installare il nuovo terminale Windows.

🔑 API e file di configurazione

Lo strumento ha un file di configurazione nella cartella gw_utils chiamato config.yaml. Ciascuno dei parametri di configurazione e come ottenere le informazioni necessarie è spiegato di seguito:

• wigle_auth:

Per utilizzare il servizio Wigle è necessario ottenere un'API e configurare il file gw_utils/config.yaml sostituendo il valore del parametro "wigle_auth" con i dati "Encoded for use" forniti da Wigle.

• google_api:

Per utilizzare i Servizi di geolocalizzazione Google è necessario ottenere un'API e configurare il file gw_utils/config.yaml sostituendo il valore del parametro "google_api" con l'"API" fornita. Google offre $200 di utilizzo gratuito mensile.

• combain_api:

Per utilizzare l'API Combain è necessario ottenere un'API e configurare il file gw_utils/config.yaml sostituendo il valore del parametro "combain_api" con l'"API" fornita. Combain offre una prova gratuita e piani a pagamento.

• no-ssl-verify:

Opzione per abilitare o disabilitare il processo di verifica SSL nelle richieste.

🛠️ Installazione

Inizia clonando localmente il repository GitHub, quindi entra nella cartella geowifi. git deve essere presente sul tuo sistema.

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

In alternativa, usa https://github.com/GONZOsint/geowifi/archive/refs/heads/main.zip, poi decomprimi il file scaricato.

Usa Python locale

Nota: usa il gestore di pacchetti pip per installare i requisiti.

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

Docker

docker build -t geowifi:latest .

🔎 Utilizzo

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)

• Ricerca per BSSID:

python3 geowifi.py -s bssid <input>

• Ricerca per SSID:

python3 geowifi.py -s ssid <input>

È possibile esportare i risultati in formato json usando il parametro -o json e mostrare le posizioni su una mappa html usando -o map.

🐳 Utilizzo Docker

docker run --rm geowifi:latest

• Ricerca per BSSID:

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

• Ricerca per SSID:

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

🗺️ Esempio di output mappa

💾 Esempio di output JSON

[
  {
    "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
  }
]

📢 Riconoscimenti

• Questo progetto utilizza parte della ricerca e del codice utilizzati in iSniff-GPS.
• Grazie a Micah Hoffman per la sua attenzione e le risposte alle mie domande.
• Grazie a kennbro per avermi prestato i suoi occhi scrupolosi per fornirmi feedback.