📡💘🌎 | geowifi

Поиск данных геолокации Wi-Fi по BSSID и SSID в различных общедоступных базах данных.

💾 Базы данных

✔️Предварительные требования

• Python3.
• Для отображения эмодзи в Windows рекомендуется установить новый терминал Windows.

🔑 API и конфигурационный файл

Инструмент имеет конфигурационный файл в папке gw_utils с именем config.yaml. Ниже объясняются каждый из параметров конфигурации и способы получения необходимой информации:

• wigle_auth:

  Для использования сервиса Wigle необходимо получить API и настроить файл gw_utils/config.yaml, заменив значение параметра "wigle_auth" на данные "Encoded for use", предоставленные Wigle.

• google_api:

  Для использования сервисов геолокации Google необходимо получить API и настроить файл gw_utils/config.yaml, заменив значение параметра "google_api" на предоставленный "API". Google предоставляет $200 бесплатного использования в месяц.

• combain_api:

  Для использования API Combain необходимо получить API и настроить файл gw_utils/config.yaml, заменив значение параметра "" на предоставленный "". Combain предлагает бесплатный пробный период и платные тарифы.

🛠️ Установка

Начните с клонирования репозитория GitHub локально, затем перейдите в папку geowifi. В системе должен быть установлен git.

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

Альтернативный вариант — использовать https://github.com/GONZOsint/geowifi/archive/refs/heads/main.zip, затем распаковать скачанный файл.

Использование локального Python

Примечание: Используйте менеджер пакетов pip для установки зависимостей.

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

Docker

docker build -t geowifi:latest .

🔎 Использование

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)

• Поиск по BSSID:

python3 geowifi.py -s bssid <input>

• Поиск по SSID:

python3 geowifi.py -s ssid <input>

Вы можете экспортировать результаты в формате json, используя параметр -o json, и отображать местоположения на HTML-карте с помощью -o map.

🐳 Использование Docker

docker run --rm geowifi:latest

• Поиск по BSSID:

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

• Поиск по SSID:

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

🗺️ Пример вывода карты

💾 Пример вывода 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
  }
]

📢 Благодарности

• В этом проекте используются некоторые исследования и код из iSniff-GPS.
• Спасибо Micah Hoffman за его внимание и ответы на мои вопросы.
• Спасибо kennbro за то, что он предоставил свои дотошные глаза для обратной связи.