https://github.com/mwarning/device-observatory
Discover what your phone does on the Internet.
https://github.com/mwarning/device-observatory
monitoring openwrt-package phone privacy-aware wifi-hotspot
Last synced: 12 months ago
JSON representation
Discover what your phone does on the Internet.
- Host: GitHub
- URL: https://github.com/mwarning/device-observatory
- Owner: mwarning
- License: gpl-3.0
- Created: 2018-03-15T18:58:17.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-09-21T10:59:06.000Z (almost 4 years ago)
- Last Synced: 2024-11-05T14:45:07.338Z (over 1 year ago)
- Topics: monitoring, openwrt-package, phone, privacy-aware, wifi-hotspot
- Language: C
- Homepage:
- Size: 737 KB
- Stars: 32
- Watchers: 6
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Device Observatory
The Device Observatory shows the activities of WiFi devices on a network on a local website. It is meant to raise the awareness for private data leaking from devices such as smartphones.
This also includes a package for [OpenWrt](http://openwrt.org). The package will create an WiFi Access Point for your phone to connect to. You can track your devices activity on a website on the router. External devices will only see their own data for privacy.
Pull Requests are welcome!
Features:
* Devices accessing the info page only see own data (except for the local host)
* Shows MAC address, DHCP device host name, device manufacturer
* Shows accessed domains, IP addresses and ports
* Shows first/last time a website was accessed
* Show SSIDs from active scanning
* Show traffic by destination
## Usage
* `--dev` *device*
Device to parse raw ethernet packets from.
This option may occur multiple times.
E.g. `wlan0`
* `--mdev` *device*
Device to parse raw wifi packets from.
This option may occur multiple times.
E.g. `mon0`
* `--mac-db` *file*
MAC to manufacturer database.
E.g. `macdb.txt`
Default: disabled
* `--port-db` *file*
File to map port numbers to human readable names.
E.g. `/etc/services`
Default: disabled
* `--json-output` *file*
Ouput all data as JSON file.
Default: disabled
* `--device-timeout` *seconds*
Timeout device data after last ethernet activity.
Default: never
* `--track-localhost` *[1|0]*
Track localhost as an device.
Default: on
* `--webserver-port` *port*
Port of the build-in webserver. Set to 0 to disable webserver.
Default: 8080
* `--webserver-path` *path*
Root folder for the build-in webserver. Usually not needed as all files are included into the binary.
Default: internal
* `--help`
Show these options and help text.
## Build On Linux Based Operating Systems
Install dependencies for compiling:
```
apt install libpcap-dev libmicrohttpd-dev vim-common
```
* package libpcap-dev allows to capture pakets
* package libmicrohttpd-dev is an embeddeable webserver
* package `vim-common` contains the xxd tool
Get source code:
```
git clone https://github.com/mwarning/device-observatory.git
cd device-observatory
```
Compile:
```
make
```
Start program:
```
./device-repository --dev eth0
```
Here, eth0 is an example interface.
Normally you would create an Access Point WiFi interface (e.g. `--dev wlan0`) and an optional monitoring interface (e.g. `--mdev mon0`).
To see the data captured by the program, go to [localhost:8080](http://localhost:8080) or [192.168.1.1:8080](http://192.168.1.1:8080) if the program runs your router.
## Create WiFi Access Point
```
TODO
```
## Create monitor mode interface
A monitor mode interface can be used to get all raw packets from the air on a specific channel. This is needed to detect SSIDs from scanning by phones/devices.
Do `iw dev` to get a list of physical wireless devices.
```
iw phy phy0 interface add mon0 type monitor
ip link set dev mon0 up
```
On OpenWrt, this can also be done via the create_monitor setting in `/etc/config/device-observatory`.
The mon0 device will be appended as `--mdev mon0`.
## Build for OpenWrt
See the [OpenWrt build instructions](openwrt/README.md) page.
## Update macdb.txt
Console command to load the official database and create a stripped down database that is more usable:
```
curl http://standards-oui.ieee.org/oui/oui.txt | awk -F'[[:space:]]+' '/^[A-F0-9]{6}/{ printf("%s", $1); for(i=4; i < NF; i++) printf(" %s", $i); printf("\n"); }' > macdb.txt
```
## Similar Projects
[PiRogue](https://github.com/PiRogueToolSuite/)