oakatsume / astromurr Goto Github PK

Welcome to the AstroMurr Project! This Ruby-based project is designed to simplify the deployment of Rogue Access Points for out-field testing purposes. Whether you are a network administrator, security professional, or researcher, AstroMurr aims to provide you with a streamlined toolset to test and evaluate the security of wireless networks and devices abroad.

Disclaimer: This project is intended for educational and ethical testing purposes only. Unauthorized deployment of Rogue Access Points can be illegal and unethical. Always ensure you have proper authorization and follow the law when conducting any wireless network testing.

• Getting Started
• Usage
• Contributing
• License

• Ruby (>= 2.6.3)
• Bundler (>= 2.0.2)
• Hostapd (>= 2.9)
• Dnsmasq (>= 2.80)
• Iwconfig
• Ifconfig
• A Linux-based operating system (tested on Debian 10)

1. Clone the repository

git clone https://github.com/OakAtsume/AstroMurr.git

2. Install the required gems

bundle install

3. Run the setup script (optional)

chmod +x setup.sh
./setup.sh

4. Run the application

bundle exec ruby astromurr.rb <options>

Astromurr will bind on ports 53 (DNS), 67 (DHCP), and 80 (HTTP) by default. Ensure these ports are not in use by other services before running Astromurr.

# Example usage
ruby astromurr.rb wlan1 "Hello World WiFi" 11
# Example usage (with wpa2)
ruby astromurr.rb wlan1 "Hello World WiFi" 11 MyStrongPassword

• Ensure you are running the application as root.
• Ensure you have the required dependencies installed.
• Ensure you don't have task's running on ports 53, 67, or 80.
• Ensure you killed wpa_supplicant, NetworkManager,dhcpcd, and any other network services. (These can interfere with the Rogue Access Point)

Distributed under the MIT License. See LICENSE.md for more information.