oraj

command module
v0.0.0-...-aedb146 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 20, 2020 License: BSD-3-Clause Imports: 9 Imported by: 0

README

Oraj

Tool for wireless reconnaissance

This tool captures probe requests sent by clients and lets you view the clients and access points via network graph.
I've built this tool to experiment with GoPacket and Dot11 protocol.

TODO

  • Fix bugs in AirMap
  • Use database
  • Connect nodes via edges
  • Process beacon frames

Installation

Prerequisites
  • Unix or macOS based machine (must be capable of monitor mode)
  • gcc
  • libpcap

On Debian derivatives:

sudo apt install build-essential libpcap-dev

On Arch Linux:

sudo pacman --needed -Sy base-devel libpcap
Build
To build and install Oraj
make
sudo make install
To build web UI (Vue and Yarn required)

Note: This step is not required. Web UI is already built and embedded inside statik/statik.go. You only need it for contribution.

cd ui
yarn install
yarn build

Get statik first:

go get github.com/rakyll/statik

Then to embed UI into statik/statik.go:

make statik
Usage

When you run make, Oraj configuration file and oui.txt will be copied to ~/.oraj. When Oraj is run, it looks for config.yml at:

  • Current working directory
  • ~/.oraj

Note: If you want to debug Oraj, simply copy config_example.yml to config.yml and run Oraj at the project root directory.

To start using Oraj, all you need to do is to start monitor mode on a specific network interface, then edit the configuration file config.yml

Note: Change the UI password in config.yml!

Warning: If you set monitorMode configuration to true in config.yml, Oraj will setup monitor mode for you, but it is not recommended as it is not stable. It is better to use airmon-ng or equivalent at the moment.

Finally: sudo oraj

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
api

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL