PPAP

Pi-Pineapple-Apple-Pi or PentestPiAccessPoint

This project is a really easy hotspot creator and traffic logger. It creates a hotspot (of any name and password) for clients to connect to. My purpose for this is to have a connection point for a deployed pi.

Getting Started

Prerequisites

The system this was designed for was kali linux. The required tools are as follows:

For the startAP and stopAP

nmcli (part of NetworkManager)

For sniff

tshark (a part of wireshark)

Running

AP

To start the AP, run:

bash startAP.sh [interface] [essid] [passwd]

The parameters are as follows:

interface: The interface to broadcast with
essid: The essid to broadcast
passwd: The password of the point (- for no password)

To stop the AP, run:

bash stopAP.sh

Example run:

bash connect.sh
bash startAP.sh wlan1 FREEWIFI -
bash stopAP.sh

This follows the connection wizard, creates an open point called FREEWIFI on wlan1, then stops it.

Sniff

You'll probably want to create a 'log' directory. The sniff tool will automatically output to ./log/

To use the traffic logging, run the following:

bash sniff.sh [interface] [file name] [cap len sec]

The parameters are as follows:

interface: The interface to log. This should be the broadcast interface.
file name: The prefix for the logging files for this run.
cap len sec: How many seconds each cap file should cover.

Example run:

bash sniff.sh wlan1 day1 3600

This sniffs on the interface wlan1 (the broadcast), begins each file with day1, and each file is an hour of captures.

Notes

The sniff program outputs to the 'log' directory. Each file will begin with the file name chosen at run, followed by a timestamp relative to run. The files will be in the pcapng format, and can be opened with wireshark for reading.

Each script can be used on its own, so please steal my stuff.

For additional information on the nmcli commands, see: https://fedoraproject.org/wiki/Networking/CLI

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. See LICENCE.md
If not, see https://www.gnu.org/licenses/.

haltosan / ppap