Skip to content

Red-Team-Alliance/Odo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Odo

Odo Pi

What is it?

Odo is a framework for coordinating and automating tools during red teaming and other scenarios. In the case demonstrated at DefCon 29 it automates monitoring an ESPKey in a weaponized reader, cloning the captured credential using a Proxmark3, and alerting the user via haptic at each step in the process.

Requirements

  • python3 (>= 3.9 for Lovense module)
  • python3 venv module (some OS need to install it separately)
  • MQTT broker (tested with mosquitto v2.0.10)

Setup

  • Setup python virtualenv

    python3 -m venv .venv

  • Activate virtualenv

    source .venv/bin/activate

  • Install requirements

    pip install -r requirements.txt

Running

  • Modify config.yaml.sample as needed and save as config.yaml

  • Run main.py

    python main.py

Example minimal config.yaml with ESPKey, Proxmark3, & Lovense haptic feedback

---
modules:
  espkey:
  lovense:
  proxmark3:

Module Information

ESPKey

Requirements

  • Pi & ESPKey on same WiFi network.
  • Recommend to configure Pi in AP mode with hostapd and connect ESPKey as client.

Defaults to espkey.local mDNS name for ESPKey host

python -m espkey

Proxmark3

Requirements

  • Proxmark3 client

Setup

Running individually

python -m proxmark3

Waveshare Screen

Display captured credentials, status of components, change modes, & select a specific credential

Requirements

To run screen without root:

sudo setcap "cap_dac_override+ep cap_sys_rawio+ep" $(eval readlink -f `which node`)
  • node >= v15
  • npm
  • pigpio

Setup

  • cd screen_ws13
  • npm install

Running individually

  • cd screen_ws13
  • node index.js

Contributing

See our contributers guide here

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published