WiFi Pineapple Mark VII
  • WiFi Pineapple Mark VII
  • Setup
    • Connecting the WiFi Pineapple
    • Setting up your WiFi Pineapple
    • Connecting to the WiFi Pineapple on Linux
    • Connecting to the WiFi Pineapple on Windows
    • Setting up the WiFi Pineapple over WiFi
    • Setup by USB Disk
  • UI Overview
    • Introduction to the UI
    • Dashboard
    • Campaigns
    • PineAP
    • Recon
    • Handshakes
    • Modules
    • Settings
    • Cloud C²
  • Developer Documentation
    • Developer Resources
    • Contributing to the Module Repository
  • WiFi Basics
    • Introduction to WiFi
    • Radios and Chipsets
    • Stations and APs
    • Transmit Power
    • Antennas
    • Channels and Regions
    • Protocols
    • Modes of Operation
    • Logical Configurations
    • MAC Addresses
    • Broadcast and Multicast MAC Addresses
    • SSIDs
    • 802.11 Frame Types
    • 802.11 Frame Structure
    • Management Frames
    • Frame Injection
    • Association and State
  • FAQ / Troubleshooting
    • MacOS Support
    • Establishing an Internet Connection
      • Configuring a Client Mode Connection
      • ICS on Linux
      • Configuring ICS on Windows
      • Configuring a USB Ethernet Adapter
    • Password Reset
    • Factory Reset and Recovery
    • WiFi Pineapple Updates
    • WiFi Pineapple Beta Updates
    • Compatible 802.11ac Adapters
  • Extras
    • MK7 LED Mod Installation
    • MK7 Kismet Case Installation
Powered by GitBook
On this page
  • Manage
  • Campaign Modes
  • Editing Campaigns
  • Reports
  • Storage and Transmission
  • Formats
  • Review

Was this helpful?

  1. UI Overview

Campaigns

Campaigns enable automatic configuration to simplify an engagement, with automatic report generation.

Last updated 2 years ago

Was this helpful?

Manage

Campaigns that have been created are listed in a table, showing the current status, name, creation date and campaign type. You can enable or disable your campaigns with the Enable/Disable toggle, and edit or remove them by clicking the "..." menu button.

Campaign Modes

Reconnaissance - Monitor Only

Passively monitor client device and access point activity within a defined region of the WiFi environment.

Client Device Assessment - Passive

Identify client devices susceptible to basic rogue access points or evil twin attacks. Uses a passive PineAP mode to mimic access points only upon direct request. Depending on filter configuration, client devices may be allowed to associate with the WiFi Pineapple.

Client Device Assessment - Active

Identify client devices susceptible to advanced rogue access points or evil twin attacks. Uses an active PineAP mode to broadcast an SSID pool, mimicking all access points listed. New access points may be dynamically added to the pool. Depending on filter configuration, client devices may be allowed to associate with the WiFi Pineapple.

Editing Campaigns

The campaign shell script may be modified and extended upon by opening the campaign script editor from the campaign's "..." menu. Campaigns reside in /etc/pineapple/campaigns/ and are generated using the /etc/pineapple/campaign-template.sh base script file.

Reports

Storage and Transmission

By default, reports are saved to the local disk under /root/loot/. Additionally, reports may be sent to a connected Cloud C² server, or by email with a configured SMTP server.

Email Reporting

Reports sent by email require SMTP configuration. Emails are sent via msmtp with optional support for TLS and STARTTLS.

Cloud C² Exfiltration

The campaigns system may be configured to use the C2EXFIL utility to exfiltrate reports to a configured Cloud C² server. The reports will reside within Cloud C² from the device's loot tab.

Formats

Reports may be generated in either JSON or HTML format.

  • JSON: Report data in JSON format, for parsing with other tools.

  • HTML: A full HTML report, containing tables and formatting.

Captured handshakes may be included in HTML reports as downloadable base64 links.

Review

From the Reports tab, you can download and delete the reports that have been generated by your campaigns.

Gmail users: to use Google's SMTP server, the account must have 2FA enabled, an App Password, and IMAP enabled. See: and

https://support.google.com/mail/answer/7126229
https://support.google.com/accounts/answer/185833
Campaign script editor
Email Reporting with SMTP configuration for Gmail