prickly-pete
UPDATE Prickly Pete has been completely updated for 2021! I've switched to running the the offical version of cowrie, and dionaea, so those are up to date, with more services and configurations! Also added new services like gate (a NodeJS webserver), Udpot, a DNS honeypot, and HoneyPress, a Wordpress honeypot! So there are far more services now by default, new config/options, but with the same out of the box goodness if you just want to try it out to get your feet wet! Ping me with any questions.
What is this? This is a script that uses Docker to quickly bring up some honeypots exposing a bunch of services. For research, reconnaissance and fun. While originally built to run on a laptop during the DEF CON hacker conference to see how many pings and pokes we could attract, it's a useful tool for research, and reconnaissance to test networks for infestations. I've completely rewritten this (July 2017) to use Docker and Docker-Compose to containerize all the honeypot services, greatly speeding up deployment time while reducing system requirements.
Security?
While this project is designed to help identify security issues, and was culled from others who likely have security in mind, I would NOT recommend running this in production environment without a complete security audit... but then again, YOLO!
Honeypots
prickly-pete uses Docker and Docker-Compose to bring up the following honeypots, automatically, with no configuration or extra steps necessary.
- contpot - an ICS honeypot with the goal to collect intelligence about the motives and methods of adversaries targeting industrial control systems
- cowrie - an SSH/Telnet honeypot, originally based on Kippo, using the official DockerHub image cowrie/cowrie
- dionaea, the dionaea honeypot, using the official DockerHub image dinotools/dionaea
- HoneyPress, a WordPress honeypot using the DockerHub image from jondkelley/honeypress
- gate, NodeJS webserver and honeypot running on :3000 with a fake index.html copied from nodejs.org (you can create your own and put it in src/gate/ to have it use that instead) TODO: get logging working
- udpot a DNS honeypot which logs all requests to a SQLite database
Requirements
Prickly-Pete will run on any 64-bit computer that has git, Docker, and Docker-Compose installed and running. I've developed this in Linux, so it's been fully tested in Debian, Ubuntu, RHEL, and CentOS. I'd expect it to work pefectly under Mac OSX too, and while I haven't tried in Windows "it should work" since it all runs in Docker with no modifications. Give it a try and let me know if it works for you, pull requests welcome!
Usage
- Install Docker
- Install Docker-Compose
- Checkout
prickly-peteand change into the directory
git clone https://github.com/philcryer/prickly-pete.git && cd prickly-pete
- Start
Start all the honeypot services
./prickly-pete start
[+] Running 7/7
⠿ Network prickly-pete_default Created 0.3s
⠿ Container prickly-pete_cowrie_1 Started 1.8s
⠿ Container prickly-pete_dionaea_1 Started 4.6s
⠿ Container prickly-pete_gate_1 Started 2.5s
⠿ Container prickly-pete_conpot_1 Started 4.3s
⠿ Container prickly-pete_honeypress_1 Started 2.3s
⠿ Container prickly-pete_udpot_1 Started
- Status
Check the status of the services (normal docker ps stuff here)
./prickly-pete status
NAME COMMAND SERVICE STATUS PORTS
prickly-pete_conpot_1 "/home/conpot/.local…" conpot running :::8888->80/tcp, 0.0.0.0:8080->80/tcp, 0.0.0.0:8888->80/tcp, :::8080->80/tcp, :::102->102/tcp, 0.0.0.0:102->102/tcp, 0.0.0.0:162->161/udp, 0.0.0.0:161->161/udp, :::162->161/udp, :::161->161/udp, :::502->502/tcp, 0.0.0.0:502->502/tcp, :::623->623/tcp, 0.0.0.0:623->623/tcp, :::44818->44818/tcp, 0.0.0.0:44818->44818/tcp, :::47808->47808/tcp, 0.0.0.0:47808->47808/tcp
prickly-pete_cowrie_1 "cowrie start -n" cowrie running 0.0.0.0:2222->2222/tcp, :::2222->2222/tcp, 2223/tcp
prickly-pete_dionaea_1 "/usr/local/sbin/ent…" dionaea running :::21->21/tcp, 0.0.0.0:21->21/tcp, 0.0.0.0:42->42/tcp, :::42->42/tcp, :::69->69/udp, 0.0.0.0:69->69/udp, :::135->135/tcp, 0.0.0.0:135->135/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp, 0.0.0.0:445->445/tcp, :::445->445/tcp, :::1433->1433/tcp, 0.0.0.0:1433->1433/tcp, :::1723->1723/tcp, 0.0.0.0:1723->1723/tcp, :::1883->1883/tcp, 0.0.0.0:1883->1883/tcp, 0.0.0.0:1900->1900/udp, :::1900->1900/udp, :::3306->3306/tcp, 0.0.0.0:3306->3306/tcp, :::5060->5060/udp, 0.0.0.0:5060->5060/udp, :::5060->5060/tcp, 0.0.0.0:5060->5060/tcp, :::5061->5061/tcp, 0.0.0.0:5061->5061/tcp, 0.0.0.0:11211->11211/tcp, :::11211->11211/tcp
prickly-pete_gate_1 "docker-entrypoint.s…" gate running 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp
prickly-pete_honeypress_1 "/usr/bin/supervisor…" honeypress running 0.0.0.0:80->80/tcp, :::80->80/tcp
prickly-pete_udpot_1 "/bin/sh -c 'python …" udpot running 0.0.0.0:5053->5053/tcp, :::5053->5053/tcp, 0.0.0.0:5053->5053/udp, :::5053->5053/udp
- Logs
Tail all the logs in realtime
./prickly-pete logs
- Stopping
Stop all services
./prickly-pete stop
Output
All logs, and any downloaded malware or other bits, can be found in script created var directory, which will persist after the process ends. Note that restarting the script will use the same directories and will include all new logs/downloads.
Issues
- If you get any errors when you're first running prickly-pete, they'll likely look something like this:
ERROR: for pricklypete_conpot_1 Cannot start service conpot: driver failed programming external connectivity on endpoint pricklypete_conpot_1 (cc7d3b484bcf24a08b63792c5188deddb19fd9809eaf35df15fa92ac024e4a99): Error starting userland proxy: listen udp 0.0.0.0:161: bind: address already in use
Errors like this means that the port (in this case 161) is already taken, and something, in this case SNMP, is listening on the port. To fix this just open docker-compose.yml in a text editor, comment out the offending port, and try to use one of the alternative ones I have listed by uncommenting them. I have options for 22, 80, 161 since those tend to be the ones that are running, but for more fun, turn off those services on your localhost and let prickly-pete use them for the time being!
-
Another issue could be that you're running a firewall blocking access to ports, you'll want to stop or turn off any firewalls on the host that you're running prickly-pete on so that everything gets through! Another idea if you're inside a network (like at home) set your router to forward all traffic to a DMZ, and then set that DMZ to be the IP of the host running prickly-pete, this is an easy way to begin to understand all the noise that is contantly being broadcast on the internet, and why an active defense is neccessary.
-
If you're having issues outside of these basic things, feel free to open an issue, or ping me on Twitter where I'm @fak3r.
-
Of course if you've fixed something yourself, or have an improvement you'd like to suggest, pull requests are always welcome!
Testing
Once up, see what you can see using various system tools, which should be installed on most Unix-like systems.
- ssh
ssh localhost -p 2222 -l root
- nmap
$ sudo nmap -p- localhost
Starting Nmap 7.91 ( https://nmap.org ) at 2021-08-03 19:39 CDT
Nmap scan report for localhost (127.0.0.1)
Host is up (0.00017s latency).
Other addresses for localhost (not scanned): ::1
Not shown: 65505 closed ports
PORT STATE SERVICE
21/tcp open ftp
42/tcp open nameserver
53/tcp open domain
80/tcp open http
102/tcp open iso-tsap
135/tcp open msrpc
443/tcp open https
445/tcp open microsoft-ds
502/tcp open mbap
623/tcp open oob-ws-http
1433/tcp open ms-sql-s
1723/tcp open pptp
1883/tcp open mqtt
2222/tcp open EtherNetIP-1
3000/tcp open ppp
3306/tcp open mysql
5053/tcp open rlm
5060/tcp open sip
5061/tcp open sip-tls
8080/tcp open http-proxy
8888/tcp open sun-answerbook
11211/tcp open memcache
44818/tcp open EtherNetIP-2
47808/tcp open bacnet
49288/tcp open unknown
51413/tcp open unknown
55650/tcp open unknown
57621/tcp open unknown
57622/tcp open unknown
61500/tcp filtered unknown
Nmap done: 1 IP address (1 host up) scanned in 5.33 seconds
- curl
curl localhost:80
- netstat
sudo netstat -plunt | grep docker
License
- prickly-pete is open source, via the permissive MIT License
Acknowledgements
Software, existing projects, and ideas that I used to create this project
- Docker, Docker-Compose, and Docker Hub for prebuilt images
- Alpine Linux, a small Linux base image for Docker images that you should use if you're building your own
- mushorg/conpot, a ICS/SCADA honeypot
- cowrie an SSH/Telnet honeypot
- dionaea the dionaea honeypot
- HoneyPress a WordPress honeypot
- gate NodeJS webserver and honeypot
- udpot a DNS honeypot
Older bits that are now legacy, but got us to where we are now
- andrewmichaelsmith/manuka, Docker based honeypot (Dionaea & Kippo)
- DinoTools/dionaea-docker, Dionaea running in Docker
- kost/docker-cowrie, a version of Cowrie running in Docker
- glastopf - Glastopf is a Python web application honeypot founded by Lukas Rist.
- honeypot-for-tcp-32764 - a first try to mock the router backdoor "TCP32764" found in several router firmwares at the end of 2013. The POC of the backdoor is included with the project.
- nepenthes- a honeypot that works by emulating widespread vulns and then catches and stores viruses worms using these vulns (working to implement Dionaea to take its place)"
Prickly-Pete?
George, driving in the car with the Rosses: "And that leads into the master bedroom."
Mrs. Ross: "Tell us more."
George: "You want to hear more? The master bedroom opens into the solarium."
Mr. Ross: "Another solarium?"
George: "Yes, two solariums. Quite a find. And I have horses, too."
Mr. Ross: "What are their names?"
George: "Snoopy and Prickly Pete. Should I keep driving?"
Mrs. Ross: "Oh, look, an antique stand. Pull over. We'll buy you a housewarming gift."
George, chuckling to himself: "Housewarming gift."
George, swerving the car to go to the antique stand: "All right, we're taking it up a notch!"