December 4, 2018

287 words 2 mins read

MisterBianco/BoopSuite

MisterBianco/BoopSuite

A Suite of Tools written in Python for wireless auditing and security testing.

repo name MisterBianco/BoopSuite
repo link https://github.com/MisterBianco/BoopSuite
homepage
language Python
size (curr.) 5746 kB
stars (curr.) 777
created 2017-05-05
license MIT License

alt text

License: MIT CodeFactor

Synopsis:

BoopSuite is a wireless testing suite with extensible and independent components.

Need to hop wireless channels? … ✅

Need to only work with beacon packets? … ✅

Need to Monitor Deauth requests? … ✅

Both a library and a toolset

Enumerate wireless interfaces

sudo python3 -m boop interface

Need additional information about a wireless interface?

sudo python3 -m boop interface {INTERFACE} -vvvv

Changing a cards mode

sudo python3 -m boop mode {INTERFACE} {monitor|managed}

The suite mimics flask!

#!/usr/bin/env python3

import boop
import time

app = boop.BoopSniff(boop.WIRELESS_DEVICES[0])
app.packets = 0

@app.handler(boop.MGMT_DEAUTH)
def pkt(self, p):
    self.packets += 1
    return

@app.handler(boop.MGMT_BEACON)
def pkt(self, p):
    self.packets += 1
    return

app.run()

Import the modules you need, add handlers for the packets you want and parse away.

List of all packet types:

  • MGMT_ASSOC_REQ
  • MGMT_ASSOC_RESP
  • MGMT_REASSOC_REQ
  • MGMT_REASSOC_RESP
  • MGMT_PROBE_REQ
  • MGMT_PROBE_RESP
  • MGMT_BEACON
  • MGMT_ATIM
  • MGMT_DISASSOC
  • MGMT_AUTH
  • MGMT_DEAUTH
  • CTRL_POLL
  • CTRL_RTS
  • CTRL_CTS
  • CTRL_ACK
  • CTRL_CFEND
  • CTRL_CFECFA
  • DATA_ANY

Note:

I use this project personally for my wireless endeavours, feel free to use, modify and extend.

Requirements:

  • python3
  • Now uses Poetry for library management

Installation:

To install open a terminal and type:

* work in progress adding to pypi

Motivation:

I am motivated by the want to be better. To prove others wrong and to prove to myself that I can do things that were previously impossible to me.

In Progress:

  • Code Fixes will be happening.
  • More functional API and better imports
  • recreating the old boopsuite sniffer in the main file
  • argparsing for said file

License:

Logos are all free to use.

MIT License (c) MisterBianco, 2017-2019

comments powered by Disqus