Skip to content
Spencer McIntyre edited this page Jul 24, 2015 · 11 revisions

The King Phisher client utilizes matplotlib when available to provide visual representation of campaign data in the form of various graphs. These graphs appear on the dashboard and can be created individually through the tools menu.

Maps With Basemap

The King Phisher client supports showing the geographic location of client visits on map view. These maps are created with the Matplotlib Basemap Toolkit. Because of this, the basemap package is required in addition to matplotlib specifically for graphing data onto maps. Without basemap, the other graphs will still be available from matplotlib.

Basemap requires GEOS to be installed. This package can be obtained by installing libgeos++-dev on Debian based systems (including Ubuntu and Kali) and geos-devel on Fedora. The Basemap project includes detailed documentation on how it can be installed.

Installing Basemap With pip

Basemap can be installed with pip however at this time additional options need to be specified. The basemap python package is externally hosted from the standard pip packages. The King Phisher install script does not assume that the user is comfortable with installing external packages automatically. As such, pip is used in an attempt to install the basemap package aware that it will most likely fail. If users would like to install basemap with pip instead of doing it manually they need to specify the additional --allow-external basemap and --allow-unverified basemap options.

The final complete command is:

user@localhost:~$ pip install --allow-external basemap --allow-unverified basemap basemap

Available Graphs

Graph Name Graph Description
Campaign Overview Stats on messages sent, visits and messages received
Message Results Percentages of messages which resulted in visits and credentials
Password Complexity Percentages of submitted passwords that meet complexity requirements
Visit Locations The geographic locations that visits originated from
Visitor OS Information Information on the visitors OS based on their User Agent
Visits Timeline The times that visits were received