Struts Apache 2 based honeypot as well as a detection module for Apache 2 servers
PHP Python C CSS Makefile ApacheConf
Switch branches/tags
Nothing to show

README.md

StrutsHoneypot

Cymmetria Research, 2017.

https://www.cymmetria.com/

Written by: Nir Krakowski (@nirkrakowksi), Imri Goldberg (@lorgandon)

Contact: research@cymmetria.com Contact: research@cymmetria.com

StrutsHoneypot is an Apache 2 based honeypot that includes a seperate detection module (apache mod) for Apache 2 servers that detects and/or blocks the sturts CVE 2017-5638 exploit. It is released under the MIT license for the use of the community.

Please consider trying out the MazeRunner Community Edition, the free version of our cyber deception platform.
https://community.cymmetria.com/

Honeypot Installation, Running and Monitoring

  • Now with added support (Honeypot only) for content disposition filename parsing vulnerability.

Installation (Ubuntu)

  • apt-get update
  • apt-get install docker.io
  • docker build -t struts_honeypot strutspot_docker/

Running the Honeypot

docker run -p 80:80 --name "mystrutspot_docker" -d struts_honeypot

Accessing the logs

Run 'docker ps' to validate the docker name: "mystrutspot_docker"

Then run 'docker exec -t -i mystrutspot_docker cat /var/log/apache2/error.log'

Testing

Prerequisites

  • apt-get install python2.7 python-pip
  • pip install requests

Rebuilding the Honeypot

docker kill mystrutspot_docker docker rm mystrutspot_docker docker build -t struts_honeypot strutspot_docker/

Then use test-struts2.py like below:

Usage:

./test-struts2.py

e.g: ./test-struts2.py http://localhost/

  • This will test for both vulnerabilities. You should be able to see

Detailed Info

The Honeypot uses mod_rewrite (see strutspot_docker/src/.htaccess) RewriteRule directive to redirect all requests to the same url. To avoid redirection for cover.css, apache.png, and struts.svg it has seperate rule for it. The Honeypot uses error_log() to send a JSON comment containing the connection info and other data to the apache default error log file. mod_headers is used to avoid default parsing by php for multipart/form-data. so it is modified to mmultipart/form-data before reaching the php parser.

Editing the Honeypot Website

Edit strutspot_docker/src/index.php and related ehtml files to add your own flavor to the honeypot itself. Inside the index.php as <?php code. This code must remain intact, anything else is completely independent and can be modified.

mod_contentrap Installation, and Running

This is a very simple Apache module implementation filter intended for a linux server with a running Apache2 server.

Installing

  • apt-get install apache2-dev
  • cd mod_contentrap/
  • make
  • make install

Running

  • server apache2 restart

Testing

One can use the same python test script as before.

Important note

This has currently only been tested on Amazon's Ubuntu 16.04 LTS image, but should work on many other platforms (including previous versions of linux/ubuntu).

See also

Check out our Mirai honeypot (MTPot):