Skip to content

korczis/zlown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Rogue and Evil Access Point

Resources

License

Stars

Watchers

Forks

Packages

No packages published