SSHoney is an SSH honeypot designed purely to log the SSH connection attempts on a given port. It does not go any further than that.
It is inspired by https://github.com/Scalingo/go-ssh-examples/blob/master/server_complex.go (thanks @max107 :))
SSHoney works by listening on a non-privileged port (2222 by default) and pretends to be an SSH
server. When an SSH client connects, SSHoney logs the connection details (IP, username, password and SSH clienr version) to stdout and/or syslog, a log file of your choosing (e.g /var/log/sshoney.log
).
Install the source and binary:
go get -u github.com/ashmckenzie/sshoney
Ensure ${GOPATH}/bin
is in your ${PATH}
(so you can run sshoney
from any directory):
export PATH:${PATH}:${GOPATH}/bin
Run it and you will be asked to generate a host.key
:
$ cd /tmp
$ sshoney
time="2015-08-28T08:48:35 10:00" level=fatal msg="Failed to load private key ./host.key. Run make gen_ssh_key"
That's cool, let's generate one!:
$ cd /tmp
$ make -f ${GOPATH}/src/github.com/ashmckenzie/sshoney/Makefile gen_ssh_key
ssh-keygen -f ./host.key -N ''
Generating public/private rsa key pair.
Your identification has been saved in ./host.key.
Your public key has been saved in ./host.key.pub.
The key fingerprint is:
SHA256:5QH4ForyXNVRuUPPuKtyg2//swPLtw4c3DyS0idTpUk ash@ashmckenzie
The key's randomart image is:
---[RSA 2048]----
| ....o..E .|
| . o.. o. |
| . .o. = |
| . . o oo =o |
| . .S o Oo= |
| o oo* . |
| . .o |
| o . |
| =o . == |
----[SHA256]-----
Let's run it again:
$ sshoney
time="2015-08-28T08:59:58 10:00" level=info msg="listening on 2222"
SSHoney is now logging to stdout and listening on port 2222 which is not the standard SSH port (22 is). This is deliberately setup this way to ensure:
- You are not locked out of a remote server by default
- The SSHoney service is not running as root
Proceed to the Running live section for the best way to run this on a real server.
SSHoney listens on port 2222 by default. This can be changed by prefixing the sshoney
command with PORT=<PORT>
:
e.g.
$ PORT=2223 sshoney
time="2015-08-28T09:11:13 10:00" level=info msg="listening on 2223"
Once you have SSHoney running (ideally as the least privileged user, e.g. nobody
) it's time to setup an IPTables rule to redirect the traffic. The easiest way to do this is to run the provided helper in the Makefile
:
$ make -f ${GOPATH}/src/github.com/ashmckenzie/sshoney/Makefile show_iptables_rule
==========================================================================================
WARNING: Please, please be very careful when adding this rule you don't lock yourself out!
==========================================================================================
sudo iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 22 -j REDIRECT --to-port 2222
This can again, be customised by prefixing the make
command with PORT=<PORT>
:
$ PORT=2223 make -f ${GOPATH}/src/github.com/ashmckenzie/sshoney/Makefile show_iptables_rule
==========================================================================================
WARNING: Please, please be very careful when adding this rule you don't lock yourself out!
==========================================================================================
sudo iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 22 -j REDIRECT --to-port 2223
By default, all logs are sent to stdout. You should also log to syslog:
$ sshoney --log-to-syslog
and/or a log file:
$ sshoney --log-file /var/log/sshoney.log
Logging is handled using the very awesome https://github.com/Sirupsen/logrus library.
General format:
time="<TIMESTAMP>" level="<LEVEL>" msg="<MSG>"
e.g.
time="2015-08-28T08:59:58 10:00" level=info msg="listening on 2222"
Specific format for SSH connection attempts:
time="<TIMESTAMP>" level="<LEVEL>" msg="SSH connection from ip=[<IP>], username=[<USERNAME>], password=[<PASSWORD>], version=[<SSH_CLIENT_VERSION>)"
e.g.
time="2015-08-28T09:01:23 10:00" level=info msg="SSH connection from ip=[127.0.0.1], username=[root], password=[password], version=[SSH-2.0-OpenSSH_6.2]"
Logstash is a killer app, so I included a config and pattern helper in this repo to make it easier to ingest SSHoney log entries into Logstash!
Included is logstash/filter.conf
that defines a filter and logstash/patterns/sshoney.pattern
to make parsing easier.