boredprog / airoviz Goto Github PK

#UPDATE: If you came here after watching my airoViz video on vimeo the viz code is here: https://github.com/samatt/NSHeyy-Viz/blob/master/nw/app/scripts/graph.js

#Overview This repository contains code for a platform for Wi-Fi based location tracking. It has three main components

• Aircrack-ng on Linux

• Python airodump Parser

  • Sends OSC messages of parsed data
  • Writes data to Google App Engine DB
  • Files

    • airodumpCSVParser.py: * Reads file on timer * Kills old nodes * Sends osc messages

    • airodumpCSVParserWatchdog.py

      • Uses watchdog to monitor when file has changed. Only reads file on change.
      • Checks the last time seen, only send OSC update if time has changed.

    • airodumpToDataStore.py

      • Use this to send a lot of old data to the data store in one shot.
      • Works for both individual files and directories

    • airodumpDataStoreRealTime.py

      • Use this to send data to the data store in real time.

    • Node.py

• Google app NDB Data Store

##Aircrack-ng Aircrack-ng and a compatible router are used to monitor the Wi-Fi spectrum for activity. The activity is can be split into two categories

###Router Routers (as expected) are the devices that act as access points for logging on to networks. Aircrack provides the following paramteres for routers:

• Authentication
• BSSID
• Beacons
• Channel
• Cipher
• ESSID
• First time seen
• ID-length
• IV
• Key
• LAN IP
• Last time seen
• Power
• Privacy
• Speed

###Client

• BSSID
• First time seen
• Last time seen
• Packets
• Power
• Probed ESSIDs
• Station MAC

##Python Airodump Parser

##NDB Datastore

• Kind
• BSSID
• Power
• Speed
• TimeRanges Time Ranges that the Node has been seen
• ESSID
  • Router: For Routers this is the Name of the network associated with that Router.
  • Client: For Clients this is the name of the network the client is currently connected to. If client is not connected to any router this will say 'not associated'
• probedESSIDs These are the beacons that are found for an unassociated client. Not valid for routers

##RaspberryPi Bring-up Guide

• Download PwnPi 3.0 http://pwnpi.sourceforge.net/
• Flash SD Card
• Install python
  • apt-get install python-dev python-setuptools python-rpi.gpio python-pip
• Install python modules
  • pip install requests
  • pip install watchdog
  • pip install pyOSC