📡💘🌎 | geowifi

Busca datos de geolocalización WiFi por BSSID y SSID en diferentes bases de datos públicas.

💾 Bases de datos

✔️Requisitos previos

• Python3.
• Para mostrar emojis en Windows, se recomienda instalar la nueva terminal de Windows.

🔑 APIs y archivo de configuración

La herramienta tiene un archivo de configuración en la carpeta gw_utils llamado config.yaml. A continuación se explica cada uno de los parámetros de configuración y cómo obtener la información necesaria:

• wigle_auth:

Para usar el servicio Wigle es necesario obtener una API y configurar el archivo gw_utils/config.yaml reemplazando el valor del parámetro "wigle_auth" por los datos "Encoded for use" proporcionados por Wigle.

• google_api:

Para usar los Servicios de Geolocalización de Google es necesario obtener una API y configurar el archivo gw_utils/config.yaml reemplazando el valor del parámetro "google_api" por la "API" proporcionada. Google ofrece $200 de uso gratuito mensual.

• combain_api:

Para usar la API de Combain es necesario obtener una API y configurar el archivo gw_utils/config.yaml reemplazando el valor del parámetro "combain_api" por la "API" proporcionada. Combain ofrece una prueba gratuita y planes de pago.

• no-ssl-verify:

Opción para habilitar o deshabilitar el proceso de verificación SSL en las solicitudes.

🛠️ Instalación

Comienza clonando el repositorio de GitHub localmente y luego entra en la carpeta geowifi. git debe estar presente en tu sistema

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

Una alternativa es usar https://github.com/GONZOsint/geowifi/archive/refs/heads/main.zip y luego descomprimir el archivo descargado.

Usar Python local

Nota: Usa el gestor de paquetes pip para instalar los requisitos.

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

Docker

docker build -t geowifi:latest .

🔎 Uso

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)

• Buscar por BSSID:

python3 geowifi.py -s bssid <input>

• Buscar por SSID:

python3 geowifi.py -s ssid <input>

Es posible exportar los resultados en formato json usando el parámetro -o json y mostrar las ubicaciones en un mapa html usando -o map.

🐳 Uso con Docker

docker run --rm geowifi:latest

• Buscar por BSSID:

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

• Buscar por SSID:

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

🗺️ Ejemplo de salida en mapa

💾 Ejemplo de salida en 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
  }
]

📢 Menciones

• Este proyecto utiliza parte de la investigación y el código usados en iSniff-GPS.
• Gracias a Micah Hoffman por su atención y respuestas a mis preguntas.
• Gracias a kennbro por prestarme sus escrupulosos ojos para darme retroalimentación.