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.
- 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)
- Clone the repository
git clone https://github.com/OakAtsume/AstroMurr.git- Install the required gems
bundle install- Run the setup script (optional)
chmod +x setup.sh
./setup.sh- 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| Option | Description |
|---|---|
| Interface | The wireless interface to use for the Rogue Access Point. |
| SSID | The SSID to broadcast for the Rogue Access Point. |
| Channel | The channel to broadcast the Rogue Access Point on (Only 2.4 is currently supported). |
| Password | The password to use for the Rogue Access Point (Optional). |
- 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.