A simple to install and run Honey Pot.
Running and developing
To install the necessary packages, do:
pip install -r requirements.txt
To run the honeypot itself, do:
python3 -m hpotter
To run the SQL to JSON webserver, do:
python3 -m hpotter.jsonserver
Once the jsonserver is running, you can see the current data by loading the ajax.html file that is in the directory above into your web browser.
To see the current contents of the database, do: sqlite3 -list main.db .dump
The JSON API is easy to query. To get all the data, go to localhost:8080:
If you're interested in a particular table, reference that:
If you want to use JSONP, pass a callback:
To get JSON in the form to use with jTables, do:
The default database is SQLite and requires no configuration. The tables are written into the default ("main.db") database.
If you'd like to use a different database, there are some environment variables that need setting.
HPOTTER_DB -- the name of the database type, e.g.: "mysql". Defaults to "sqlite".
HPOTTER_DB_PASSWORD -- e.g.: "my-secret-pw". Defaults to "".
HPOTTER_DB_HOST Defaults to "127.0.0.1".
HPOTTER_DB_PORT -- e.g.: 3306 Defaults to "".
HPOTTER_DB_DB -- The database where the tables are placed e.g.: hpotter. Created if not present. Defaults to "hpotter".
This is the main honeypot executable. It looks in plugins and runs all the plugins found there.
This is where the protocol-specific plugins reside. They are based on https://docs.python.org/3/library/socketserver.html The generic.py file is a good place to start for creating your own plugins.
Where the SQL to JSON web server resides.
This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.