Rogue and Evil Access Point
Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
etc
lib/zlown
scripts
.gitignore
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
zlown.gemspec

README.md

zlown

Rogue and Evil Access Point

Status

Gem Version Downloads

Features implemented

  • Intuitive CLI
  • Configurable (~/.zlown/zlown.yml)
  • Connects to internet using LTE
  • Shares connectivity over WiFi
  • Logs all HTTP trafic

Features planned

Prerequisites

Hardware

Software

Core

These are must to have.

  • apt-get (zlown was developed using Kali Linux)
  • systemd
  • ruby
  • rubygems
  • bundler

Nice to have

These will be installed during zlown install if not present.

  • dnsmasq
  • hostapd

Optional

Presence of these tools affects which features will be available.

  • httpry
  • ngrep
  • sslsniff, sslstrip, sslsplit

Installation

  • gem install zlown
  • zlown install
  • zlown init
  • zlown enable
  • zlown start

OR

  • git clone https://github.com/korczis/zlown.git
  • cd zlown
  • bundle
  • ./bin/zlown install
  • ./bin/zlown init
  • ./bin/zlown enable
  • ./bin/zlown start

Details

  • zlown main entrypoint is zlown systemd service
    • run zlown systemctl status or systemctl status zlown to obtain info about running zlown service
    • run zlown systemctl log or journlctl -u zlown to see complete zlown service log
  • All zlown related stuff is in ~/.zlown folder
  • Main config is stored in ~/.zlown/zlown.yml
  • All captured data are stored in ~/.zlown/data

Warranty and Disclaimer

  • The Software is provided "as is," with all faults, defects and errors, and without warranty of any kind.
  • No Liability. Licensor does not warrant that the Software will be free of bugs, errors, viruses or other defects, and Licensor shall have no liability of any kind for the use of or inability to use the software, the software content or any associated service.
  • zlown hould be used for authorized testing and/or educational purposes only. No Exceptions.