📡💘🌎 | geowifi

Pesquise dados de geolocalização Wi-Fi por BSSID e SSID em diferentes bancos de dados públicos.

💾 Bancos de Dados

✔️Pré-requisitos

• Python3.
• Para exibir emojis no Windows, recomenda-se instalar o novo terminal do Windows.

🔑 APIs e arquivo de configuração

A ferramenta possui um arquivo de configuração na pasta gw_utils chamado config.yaml. Cada um dos parâmetros de configuração e como obter as informações necessárias é explicado abaixo:

• wigle_auth:

Para usar o serviço Wigle é necessário obter uma API e configurar o arquivo gw_utils/config.yaml substituindo o valor do parâmetro "wigle_auth" pelos dados "Encoded for use" fornecidos pelo Wigle.

• google_api:

Para usar os Serviços de Geolocalização do Google é necessário obter uma API e configurar o arquivo gw_utils/config.yaml substituindo o valor do parâmetro "google_api" pela "API" fornecida. O Google oferece US$ 200 de uso mensal gratuito.

• combain_api:

Para usar a API Combain é necessário obter uma API e configurar o arquivo gw_utils/config.yaml substituindo o valor do parâmetro "combain_api" pela "API" fornecida. A Combain oferece um teste gratuito e planos pagos.

• no-ssl-verify:

Opção para ativar ou desativar o processo de verificação SSL nas requisições.

🛠️ Instalação

Comece clonando localmente o repositório do GitHub e depois entre na pasta geowifi. O git deve estar presente no seu sistema

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

Alternativamente, use https://github.com/GONZOsint/geowifi/archive/refs/heads/main.zip e descompacte o arquivo baixado.

Usar Python local

Nota: Use o gerenciador de pacotes pip para instalar as dependências.

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)

• Pesquisar por BSSID:

python3 geowifi.py -s bssid <input>

• Pesquisar por SSID:

python3 geowifi.py -s ssid <input>

É possível exportar os resultados no formato json usando o parâmetro -o json e mostrar as localizações em um mapa html usando -o map.

🐳 Uso com Docker

docker run --rm geowifi:latest

• Pesquisar por BSSID:

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

• Pesquisar por SSID:

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

🗺️ Exemplo de saída em mapa

💾 Exemplo de saída 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
  }
]

📢 Menções

• Este projeto utiliza parte da pesquisa e código usado no iSniff-GPS.
• Agradecimentos a Micah Hoffman pela atenção e respostas às minhas perguntas.
• Agradecimentos a kennbro por emprestar seus olhos criteriosos para me dar feedback.