/hostap-rs

Host 802.11 access point creation utility

Primary LanguageRustApache License 2.0Apache-2.0

hostap

Build Status License License: MIT

hostap is a Linux tool for debugging 802.11 wireless devices. It provides an out of the box solution for eavesdropping on Wi-Fi devices for testing purposes. This is achieved by setting up a local wireless network on an interface that supports AP mode then routing traffic to the external network.

Warning

This tool currently requires root access for the following:

  • Allow NetworkManager to ignore the selected interface
  • Bring up/down the selected wireless interface using iproute2
  • Use sysctl to forward ipv4 packets
  • Manipulate the host's internal routing table to forward ip packets

Dependencies

  • NetworkMananger (only supported manager currently)
  • iproute2
  • hostapd
  • dhcpd
  • iptables

Tested Network Adapters

To use this tool, you must have a dongle or local wireless interface that supports AP mode.

Supported adaptors:

  • Alfa AWUS036NHA

Quick Start

  1. Select your wireless interface from the following list:
ip link
  1. Bring up a network on the selected interface:
hostap -i <interface>

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.