Contact: research@sensepost.com
hostapd-mana, continues to see active development. For more current information and tools, keep an eye on w1f1.net.
Overview: Pioneering Rogue AP Attacks
The MANA Toolkit, first unveiled at Defcon 22, was a significant advancement in the realm of rogue access point (evilAP) attacks. It provided a comprehensive suite of tools designed to exploit vulnerabilities in how client devices connect to Wi-Fi networks. Specifically, MANA implemented substantial improvements to KARMA-style attacks by modifying hostapd, along with providing configurations for effective Man-in-the-Middle (MitM) scenarios once a victim connected.
For in-depth understanding, refer to the SensePost blog post: Improvements in Rogue AP Attacks: MANA, or watch the Defcon 22 talk: Defcon 22 Presentation.
Core Components of the MANA Toolkit
The toolkit bundled several key components to facilitate sophisticated wireless attacks:
- run-mana/ Controller scripts for orchestrating MANA attacks.
- hostapd-mana/ A modified version of
hostapdimplementing novel MANA attack techniques (improvements on KARMA). This is the core of the toolkit. - crackapd/ A utility for offloading the cracking of EAP credentials to external tools and re-integrating them into the
hostapdEAP configuration (auto crack 'n add). - sslstrip-hsts/ Modifications to LeonardoNVE's & Moxie Marlinspike's SSL/TLS interception tools, designed to bypass HSTS.
- apache/ Apache virtual host configurations for "no upstream" hacks, intended for deployment in
/etc/apache2/and/var/www/. - kali-install.sh / ubuntu-install.sh Simple installer scripts tailored for Kali Linux (1.0.9) and Ubuntu (14.04 Trusty Tahr).
- slides/ Presentation slides explaining the toolkit's functionalities.
Installation and Setup
While the easiest way to install MANA on older Kali distributions was via apt-get install mana-toolkit, manual installation from the Git repository was necessary for the latest (at the time) version.
Prerequisites
The installer scripts (ubuntu-install.sh in particular) outline the specific software dependencies. Generally, this includes a Linux environment with development tools, wireless utilities, and services like DHCP and DNS servers.
A crucial requirement is a wireless network adapter that supports "AP" (Access Point) or "master" mode. You can verify this capability by running:
iw listLook for "AP" within the "Supported interface modes" section of the output, for example:
Supported interface modes:
* IBSS
* managed
* AP
* AP/VLAN
* monitor
* mesh pointConfirmed working cards (though availability may vary now):
- Ubiquiti SR-71: Chipset AR9170, driver
carl9170. (No longer manufactured) - Alfa Black AWUS036NHA: Chipset Atheros AR9271.
- TP-Link TL-WN722N (v1): Chipset Atheros AR9271.
Manual Installation from Git (Legacy)
For those installing from the Git repository, the following steps were used after installing dependencies:
git clone --depth 1 https://github.com/sensepost/mana
cd mana
git submodule init
git submodule update
make
sudo make installgit submodule init and update are essential for fetching linked repositories like hostapd-mana and net-creds.
Running MANA
MANA's various attack scenarios and configurations are launched using the example start scripts. Users were encouraged to customize these scripts to their specific needs.
- MANA tools:
/usr/share/mana-toolkit - Start scripts:
/usr/share/mana-toolkit/run-mana - Captured traffic:
/var/lib/mana-toolkit
Key Start Scripts
These scripts are located in /usr/share/mana-toolkit/run-mana/ and must be edited to specify the correct wireless interface (e.g., wlan0, wlan1mon).
start-nat-full.sh: Initiates MANA in NAT mode (requires an upstream internet connection) with all Man-in-the-Middle features enabled (e.g., FireLamb, SSLStrip, SSLSplit).start-nat-simple.sh: Starts MANA in NAT mode but without the advanced MitM tools.start-noupstream.sh: Launches MANA in a "fake Internet" mode. This is useful in environments where targets have Wi-Fi enabled but no actual internet connectivity. It often includes a captive portal.start-noupstream-eap.sh: Combines the EAP (Extensible Authentication Protocol) attack capabilities with the noupstream mode.
hostapd's control over the wireless card. If NetworkManager is used for upstream connectivity, this can cause issues. The recommended solution was to manually configure the upstream adapter or instruct NetworkManager to ignore the wireless device used by MANA.
The Legacy of MANA
The MANA Toolkit represented a significant step forward in Wi-Fi attack methodologies, particularly in its enhancements to KARMA attacks. It highlighted persistent vulnerabilities in how client devices select and connect to wireless networks, providing security professionals with a powerful (albeit now deprecated) tool for demonstrating these risks.
While MANA itself is no longer actively developed, its core principles and the research behind it have influenced subsequent tools and continue to inform wireless security practices. The focus has shifted to more modern toolkits like Bettercap and Berate-AP, which build upon the foundations laid by pioneers like MANA.