iSniff-GPS - GitLite

KO | EN

gitlite — search

#python #ai #golang #android #deep-learning #docker #nodejs #cli #awesome-list #vue #pytorch #security #mcp #open-source

iSniff-GPS

(★ 1,289)

Passive sniffing tool for capturing and visualising WiFi location data disclosed by iOS devices

파일 탐색기

최종 버전 다운로드 (.zip)

- - ajax-loader.gif
  - bluff-min.js
  - flag.png
  - jquery-2.1.1.min.js
  - js-class.js
  - locate.png
  - wifi.png
- - ap_detail.html
  - ap_list.html
  - apple-mobile-ajax.js
  - apple-mobile.html
  - apple-wloc-ajax.js
  - apple-wloc.html
  - base.html
  - client_detail.html
  - client_list.html
  - home.html
  - stats.html
  - wigle-wloc.html
- - __init__.py
  - dict_lookup.py
  - dot_colour.py
  - urldecode.py
- __init__.py
- admin.py
- BSSIDApple.proto
- BSSIDApple_pb2.py
- GSM.proto
- GSM_pb2.py
- models.py
- settings.py
- urls.py
- views.py
- wigle_api.py
- wloc.py
- wsgi.py
color.py
iSniff_GPS_Apple_WLOC_screenshot.jpg
iSniff_GPS_Lightning_Talk_29c3_slides.pdf
iSniff_import.py
manage.py
README.md
requirements.txt
run.sh

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/hubert3/iSniff-GPS

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd iSniff-GPS

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python manage.py runserver

장고(Django) 개발 서버를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

iSniff GPS
==========

iSniff GPS passively sniffs for SSID probes, ARPs and MDNS (Bonjour) packets broadcast by nearby iPhones, iPads and other wireless devices.
The aim is to collect data which can be used to identify each device and determine previous geographical locations, based solely on information each device discloses about previously joined WiFi networks.

iOS devices transmit ARPs which sometimes contain MAC addresses (BSSIDs) of previously joined WiFi networks, as described in [[1]][ars]. iSniff GPS captures these ARPs and submits MAC addresses to Apple's WiFi location service (masquerading as an iOS device) to obtain GPS coordinates for a given BSSID. If only SSID probes have been captured for a particular device, iSniff GPS can query network names on wigle.net and visualise possible locations.

By geo-locating multiple SSIDs and WiFi router MAC addresses, it is possible to determine where a device (and by implication its owner) is likely to have been.

Below: Visualisation of WiFi router locations in Melbourne, AU returned by Apple Location Services

![Apple WLOC module screenshot](https://raw.githubusercontent.com/hubert3/iSniff-GPS/master/iSniff_GPS_Apple_WLOC_screenshot.jpg)

Components
----------

iSniff GPS contains 2 major components and further python modules:
* iSniff_import.py uses [Scapy](http://www.secdev.org/projects/scapy/) to extract data from a live capture or pcap file and inserts it into a database (iSniff_GPS.sqlite3 by default).

* A Django web application provides a browser-based interface to view and analyse the data collected. This includes views of all detected devices and the SSIDs / BSSIDs each has probed for, a view by network, Google Maps views for visualising possible locations of a given BSSID or SSID, and a pie chart view showing a breakdown of the most popular device manufacturers based on client MAC address Ethernet OUIs.

* __wloc.py__ provides a _QueryBSSID()_ function which looks up a given BSSID (AP MAC address) on Apple's WiFi location service. It will return the coordinates of the MAC queried for and usually an additional 400 nearby BSSIDs and their coordinates.

* __wigle_api.py__ provides a _getLocation()_ function for querying a given SSID on the wigle.net database and returns GPS coordinates. It must be configured with a valid username and password set in the settings.py file. Please respect the wigle.net ToS in using this module.

Instructions
------------

To use the web interface:

1. Install or update required Python modules by running `pip install -U -r requirements.txt`.
2. Initialise an empty database by running `./manage.py syncdb`.
3. Start the web interface by running `./manage.py runserver 127.0.0.1:8000`.

To sniff wifi traffic:

1. Install Scapy
2. Import data from a wifi pcap capture by running `./run.sh -r <chan11.pcap>`
3. For live capture, bring up a wifi interface in monitor mode (usually mon0) so that airodump-ng shows traffic.
4. Start live sniffing with `./run.sh -i mon0`.

To solicit ARPs from iOS devices, set up an access point with DHCP disabled (e.g. using airbase-ng) and configure your sniffing interface to the same channel.

Once associated, iOS devices will send up to three ARPs destined for the MAC address of the DHCP server on previously joined networks. On typical home WiFi routers, the DHCP server MAC address is the same as the WiFi interface MAC address, which can be used for accurate geolocation. On larger corporate WiFi networks, the MAC of the DHCP server may be different and thus cannot be used for geolocation.

Note that as of iOS 6, DNAv4 ARPs containing the information disclosure should only be sent on encrypted networks (to be verified). See http://lists.apple.com/archives/security-announce/2012/Sep/msg00003.html (CVE-2012-3725)

Dependencies
------------

See requirements.txt for python modules and versions required.

iSniff GPS was developed on a Ubuntu 12.04 (32-bit) VM with Python 2.7.3, Django 1.5.4 and Scapy 2.2.0-dev.
The web interface code has been updated and tested with Django 1.7.1 running on Mac OS X Yosemite with Python 2.7.8.
Network sniffing has not been tested on Mac OS X.

Credits
-------

Written by @hubert3 / hubert(at)pentest.com. Presented at Blackhat USA July 2012, code published on Github 2012-08-31.

The implementation of wloc.py is based on work by François-Xavier Aguessy and Côme Demoustier [[2]][paper].

Mark Wuergler of Immunity, Inc. provided helpful information through mailing list posts and Twitter replies.

Includes Bluff JS chart library by James Coglan.

1. http://arstechnica.com/apple/2012/03/anatomy-of-an-iphone-leak/
2. http://fxaguessy.fr/rapport-pfe-interception-ssl-analyse-donnees-localisation-smartphones/

[ars]: http://arstechnica.com/apple/2012/03/anatomy-of-an-iphone-leak/
[paper]: http://fxaguessy.fr/rapport-pfe-interception-ssl-analyse-donnees-localisation-smartphones/