Skip to content

Latest commit

 

History

History
61 lines (34 loc) · 2.52 KB

README.md

File metadata and controls

61 lines (34 loc) · 2.52 KB
Raw

WiFi Pineapple Demo (aka. ssid-jungle)

This project is a demonstration using the Wifi Pineapple Mk7 to show just how much data exists floating around us.

The basic demonstration shows SSID broadcasts being captured by the WiFi Pineapple reconnaissance scan.

Note: this demonstration is designed to use the Hak5 MK7AC WiFi Adapter attached to the WiFi Pineapple. Demonstration will need to be reconfigured to solely run in 2.4 GHz mode without it (see backend/pineapple.go).

Prerequisites

To install you're going to need docker to run Docker.

WiFi Pineapple Configuration

See Configure the WiFi Pineapple

macOS

For macOS, the WiFi Pineapple's ethernet driver needs to be installed/patched. This is not officially supported by the WiFi Pineapple. If you really want to do this, see this article.

Usage

Build

You will need to build the docker containers locally. To do this, simply run:

docker compose build

Running

You will need to plug in the WiFi Pineapple to your local machine and wait for it to start up. The best way to check if the WiFi Pineapple has booted and API is accessible is to navigate to the web UI at 172.16.42.1:1471. If this is accessible you're ready to go.

Then you can start up the docker containers with:

docker compose up
# ...or to start in the background
docker compose up -d

You can then access the webpage at http://localhost

Configuration

SSID Filtering

The SSID Filtering is hacked together for now (please submit a PR with an update!). To modify the SSID filter list, go to backend/pineapple.go (line 14) and modify the filter map to pick which SSIDs should be hidden.

You will have to rebuild the backend docker container to see the changes to this.

Configure the WiFi Pineapple

Please ensure the WiFi Pineapple credentials are set to root:root. Otherwise, you can override this in main.go.

Authors

Disclaimer: This project is created for educational demonstration purposes only. This project's maintainer's, RIT, or anyone affiliated with the RIT CyberCorps© Scholarship for Service program is not liable for misuse of this project.