virtual honeypots
C Python Perl Shell C++ Tcl Other
Latest commit a0f3d64 Dec 20, 2013 @awaldow awaldow Merge pull request #88 from aleno/master
Fix null dereference of pointers
Permalink
Failed to load latest commit information.
compat Fixed compiler warnings in sha1.h on non-OpenBSD systems Jul 19, 2012
debian DEBIAN: Bump debian package version Jul 3, 2013
doc Update example config files to use 'closed' instead of 'block' termin… Feb 12, 2013
dpkt Fix double directory structure by moving files up a folder Apr 6, 2012
os-test OSTEST: Use the -p flag to set honeyd to same fingerprints file as os… Jan 4, 2013
pypcap PYPCAP: Rebuild the pyx file with new version of pyrexc so it works w… Jul 6, 2012
regress Additional changes to port terminology update Nov 6, 2012
sample-config Update example config files to use 'closed' instead of 'block' termin… Feb 12, 2013
scripts Fix script alert not working on the telnet script because of invalid … Jul 9, 2013
subsystems Merge branch 'integration' of ssh://helios/home/git/repositories/hone… Jan 21, 2013
webserver Remove references to update.c vars in the python extension code Sep 7, 2012
.gitignore Fix bug where InitializeDb had to be called twice before database cam… Mar 25, 2013
ChangeLog Fix double directory structure by moving files up a folder Apr 6, 2012
LICENSE Fix double directory structure by moving files up a folder Apr 6, 2012
Makefile.am Create init.py script for db, make sure ~/.config/honey exists, call … Mar 25, 2013
README BUILD: Bump version to 1.6d for tagging Aug 5, 2013
analyze.c Fix for memory leaks in repeated libevent timers Mar 25, 2013
analyze.h Fix double directory structure by moving files up a folder Apr 6, 2012
arp.c Merge branch 'integration' of ssh://helios/home/git/repositories/hone… Jan 21, 2013
arp.h Merge branch 'integration' of ssh://helios/home/git/repositories/hone… Jan 21, 2013
atomicio.c Fix double directory structure by moving files up a folder Apr 6, 2012
autogen.sh Fix double directory structure by moving files up a folder Apr 6, 2012
command.c Fix segfault if using proxy feature in honeyd Jul 19, 2013
condition.c Fix double directory structure by moving files up a folder Apr 6, 2012
condition.h Fix double directory structure by moving files up a folder Apr 6, 2012
config.c Fix bug where honeyd was trying to ARP for the interface bcast addresses Sep 26, 2013
config.ethernet Change terminology of port behavior from "reset, block" to "closed, f… Nov 6, 2012
config.sample Change terminology of port behavior from "reset, block" to "closed, f… Nov 6, 2012
configure BUILD: Bump version to 1.6d for tagging Aug 5, 2013
configure.in BUILD: Bump version to 1.6d for tagging Aug 5, 2013
daemon.c Fix double directory structure by moving files up a folder Apr 6, 2012
debug.h Fix double directory structure by moving files up a folder Apr 6, 2012
dhcpclient.c More work on getting DHCP renewals to work properly Sep 25, 2013
dhcpclient.h More work on getting DHCP renewals to work properly Sep 25, 2013
err.c Swapped out err and errx function calls with syslog calls Jan 3, 2013
ethernet.c replaced err() and errx() with syslog Jan 18, 2013
ethernet.h Changed install location of mac file and CLI arguments Jan 4, 2013
fdpass.c Fix for merge errors and compiler warnings Jan 21, 2013
fdpass.h Fix for merge errors and compiler warnings Jan 21, 2013
filter.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
filter.h Fix double directory structure by moving files up a folder Apr 6, 2012
generateDebs DEB: Update package version number Mar 18, 2013
generate_assoc.py Fix double directory structure by moving files up a folder Apr 6, 2012
getopt_long.c Fix double directory structure by moving files up a folder Apr 6, 2012
gre.c Fix double directory structure by moving files up a folder Apr 6, 2012
gre.h Fix double directory structure by moving files up a folder Apr 6, 2012
histogram.c Fix for memory leaks in repeated libevent timers Mar 25, 2013
histogram.h Fix double directory structure by moving files up a folder Apr 6, 2012
honeyd.8 Fix man page for broadcast entry format Jun 28, 2013
honeyd.c Fix null dereference of pointers Dec 20, 2013
honeyd.h Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
honeyd_overload.c replaced err() and errx() with syslog Jan 18, 2013
honeyd_overload.h Fix double directory structure by moving files up a folder Apr 6, 2012
honeydctl.1 Fix double directory structure by moving files up a folder Apr 6, 2012
honeydctl.c replaced err() and errx() with syslog Jan 18, 2013
honeydstats.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
honeydstats.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
honeydstats_main.c Merge branch 'integration' of ssh://helios/home/git/repositories/hone… Jan 21, 2013
hooks.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
hooks.h Fix double directory structure by moving files up a folder Apr 6, 2012
hsniff.c Fixed merge conflicts within hsniff.c Mar 4, 2013
hsniff.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
install-sh Fix double directory structure by moving files up a folder Apr 6, 2012
interface.c Fix bug where honeyd was trying to ARP for the interface bcast addresses Sep 26, 2013
interface.h Fix bug where honeyd was trying to ARP for the interface bcast addresses Sep 26, 2013
ipfrag.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
ipfrag.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
keycount.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
keycount.h Fix double directory structure by moving files up a folder Apr 6, 2012
lex.c Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
lex.l Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
log.c replaced err() and errx() with syslog Jan 18, 2013
log.h Fix double directory structure by moving files up a folder Apr 6, 2012
ltmain.sh Fix double directory structure by moving files up a folder Apr 6, 2012
missing Fix double directory structure by moving files up a folder Apr 6, 2012
mkinstalldirs Fix double directory structure by moving files up a folder Apr 6, 2012
network.c fixed syslog errors Jan 18, 2013
network.h Fix double directory structure by moving files up a folder Apr 6, 2012
nmap-mac-prefixes Added nmap-mac-prefixes to the makefile install Jan 4, 2013
nmap-os-db Update nmap-os-db and nmap-assoc files to newest versions Aug 24, 2012
nmap.assoc Update nmap-os-db and nmap-assoc files to newest versions Aug 24, 2012
osfp.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
osfp.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
parse.c Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
parse.h Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
parse.y Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
parser.h Fix double directory structure by moving files up a folder Apr 6, 2012
personality.c Fix for memory leaks in repeated libevent timers Mar 25, 2013
personality.h Ignore the "Match Points" section of nmap-os-db when parsing it Jan 4, 2013
pf.os Fix double directory structure by moving files up a folder Apr 6, 2012
pf_osfp.c Fixes for many compiler warnings Jul 19, 2012
pfctl_osfp.c replaced err() and errx() with syslog Jan 18, 2013
pfvar.h Fix double directory structure by moving files up a folder Apr 6, 2012
plugins.c Fix double directory structure by moving files up a folder Apr 6, 2012
plugins.h Fix double directory structure by moving files up a folder Apr 6, 2012
plugins_config.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
plugins_config.h Fix double directory structure by moving files up a folder Apr 6, 2012
pool.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
pool.h Finished copying the MAC prefix file to honeyd added Jan 7, 2013
pydatahoneyd.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
pydatahoneyd.h Fix double directory structure by moving files up a folder Apr 6, 2012
pydataprocessing.c pydataprocessing.c error on Compiling Feb 14, 2013
pydataprocessing.h Fix double directory structure by moving files up a folder Apr 6, 2012
pyextend.c Merge branch 'integration' of ssh://helios/home/git/repositories/hone… Jan 21, 2013
pyextend.h Fix double directory structure by moving files up a folder Apr 6, 2012
router.c fixed syslog errors Jan 18, 2013
router.h Fix double directory structure by moving files up a folder Apr 6, 2012
rrdtool.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
rrdtool.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
sha1.c Fix double directory structure by moving files up a folder Apr 6, 2012
stamp-h.in Fix double directory structure by moving files up a folder Apr 6, 2012
stats.c Fix for merge errors and compiler warnings Jan 21, 2013
stats.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
strlcat.c Fix double directory structure by moving files up a folder Apr 6, 2012
strlcpy.c Fix double directory structure by moving files up a folder Apr 6, 2012
strsep.c Fix double directory structure by moving files up a folder Apr 6, 2012
subsystem.c Pass a HONEYD_INTERFACE variable to honeypot scripts (eg, "eth0") May 10, 2013
subsystem.h Replace few magic numbers with macros and some confusing function names Jan 19, 2013
tagging.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
tagging.h Remove hardcoded libevent code, replace with calls to actual libevent Aug 22, 2012
tcp.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
tcp.h Fix double directory structure by moving files up a folder Apr 6, 2012
template.h Add ability to have honeypots do periodic UDP broadcasts Jun 20, 2013
udp.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
udp.h Fix double directory structure by moving files up a folder Apr 6, 2012
ui.c Pass a HONEYD_INTERFACE variable to honeypot scripts (eg, "eth0") May 10, 2013
ui.h Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
untagging.c Updated deprecated libevent 1.0 calls to libevent 2.x Jan 21, 2013
untagging.h Remove hardcoded libevent code, replace with calls to actual libevent Aug 22, 2012
util.c Finished copying the MAC prefix file to honeyd added Jan 7, 2013
util.h Fixes for many compiler warnings Jul 19, 2012
xprobe2.conf Fix double directory structure by moving files up a folder Apr 6, 2012
xprobe_assoc.c Fix double directory structure by moving files up a folder Apr 6, 2012
xprobe_assoc.h Fix double directory structure by moving files up a folder Apr 6, 2012

README

Honeyd 1.6d
Copyright (c) 2002 - 2007 Niels Provos <provos@citi.umich.edu>
-------------------------------------------------------------------------

About Honeyd:
-------------

Honeyd is a small daemon that creates virtual hosts on a network.  The
hosts can be configured to run arbitrary services, and their TCP
personality can be adapted so that they appear to be running certain
versions of operating systems.  Honeyd enables a single host to claim
multiple addresses - I have tested up to 65536 - on a LAN for network
simulation.

It is possible to ping the virtual machines, or to traceroute them.
Any type of service on the virtual machine can be simulated according
to a simple configuration file.  Instead of simulating a service, it
is also possible to proxy it to another machine.

Installation:
-------------

Honeyd depends on several libraries:

 - libevent  - event notification
 - libdnet   - packet creation
 - libpcap   - packet sniffing
 - libpcre   - perl regular expression library (optional; for subsystems)

Make sure that you have them installed.



To install dependencies in Ubuntu:

$ sudo apt-get install libevent-dev libdumbnet-dev libpcap-dev libpcre3-dev libedit-dev bison flex libtool automake

To install dependencies in ArchLinux:

# First get these packages
$ pacman -S libdnet libpcap libevent pcre libedit bison flex libtool automake

For the regression framework to run, you need to install the Python
module for libdnet.  You might need Python 2.4 for the best results.

To build honeyd, run the following commands:

$ ./autogen.sh
$ ./configure
$ make
$ sudo make install

If your compilation stops due to Python related errors, you can try to
run configure as

$ ./configure --without-python

If you get compilation warnings on Linux bitch to the people responsible
for the conditional header file idioticy.

Documentation:
--------------

You can find documentation as part of this release.  The manual
page can be accessed with the following commands:

$ man honeyd

or in the source directory

$ nroff -mdoc honeyd.8

More information can be found at http://www.honeyd.org/ and https://github.com/DataSoft/Honeyd

Running:
--------

Honeyd requires root-privileges for execution.  Normally, you run it
with arguments similiar to the following:

$ sudo ./honeyd -d -f config.sample 10.0.0.0/8

It is strongly recommend that you run Honeyd in a chroot environment
under a sandbox like systrace.  If possible, Honeyd drops privileges
after creating its raw sockets.  This depends on your configuration
file.  You can force privileges to be dropped by setting Honeyd's uid
and gid via the -u <uid> and -g <gid> flags.

Testing
-------

To empirically verify the quality of OS scan results, a bash script named
ostest is included. There are a few "gotcha"s with this, however. Normally,
honeyd ignores packets coming from the same machine that it's running on
so as to avoid routing loops. (or so it claims, at least) So scanning
yourself doesn't work.

An ugly hack to make this work is to use a separate hardware ethernet
interface such as a cheap usb-ethernet adapter. You then have two eth adapters,
call them eth0 and eth1. Set up a route so that the IP address given to 
ostest is routing to eth0. You then set up honeyd to listen on eth1. 

Honeyd will see packets coming from eth0 and assume that it is a different
machine than ours, and not drop them.

License:
--------

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Acknowledgments:
----------------

The following people have helped with suggestions, ideas or code:

  Dug Song <dugsong@monkey.org>
  Jamie Van Randwyk <jvanran@sandia.gov>
  Eric Thomas <edthoma@sandia.gov>
  Christopher Kolina
  Derek Cotton
  Yuqing Mai
  Lance Spitzner <lance@honeynet.org>
  Christian Kreibich <christian.kreibich@cl.cam.ac.uk>
  Bill Cheswick <ches@lumeta.com>
  Lauren Oudot <oudot@rstack.org>
  Jon Oberheide <jonojono@merit.edu>
  David Clark <david.clark@datasoft.com>
  Dan Petro <dan.petro@datasoft.com>
  David Scott <david.scott@datasoft.com>
  Addison Waldow <addison.waldow@datasoft.com>
  Rami Rashid <RamiRashid959@msn.com>