Welcome to the public Honeysnap project site

The goal of this page is to provide you the latest documentation, source code, and information for Honeysnap. Honeysnap is designed to be a command-line tool for parsing single or multiple pcap data files and producing a 'first-cut' analysis report that identifies significant events within the processed data. This presents security analysts with a pre-prepared menu of high value network activity, aimed at focusing manual forensic analysis and saving significant incident investigation time. Once you have identified data that interests you, you can then employ other tools for more in depth analysis, such as the Walleye user interface to the Honeywall. Honeysnap is also suitable for manual operation or automation via cron.

Please provide any feedback or suggestions to the  Honeysnap public maillist. Bugs should be submitted as Trac Tickets, after registering a user account.

Examples of functionality include:

  • Packet and connection overview.
  • Flow extraction of ASCII based communications.
  • Protocol decode of the more common Internet communication protocols.
  • Binary file transfer extraction.
  • Flow summary of inbound and outbound connections.
  • Keystroke extraction of ver2 and ver 3 Sebek data.
  • Identification and analysis of IRC traffic, including keyword matching.

Documentation

Each distribution of Honeysnap comes with documentation on how to install, configure, and use Honeysnap. In addition, we highly recommend you join the  Honeysnap public maillist.

See the bottom of the page for the USAGE and INSTALL documents. The latest versions will always be in svn.

Functionality / Updates

Version 1.0.6 now decodes the following protocols.

  • DNS
  • FTP
  • HTTP
  • IRC
  • Socks
  • Sebek

In addtion, the new 1.0.6 version includes

  • Socks proxy traffic stats
  • User definable filters for the counts
  • Improved DNS output
  • Fixed bug in file extraction
  • A big speed increase in gzip decoding
  • Print querying IP for DNS decodes
  • Auto-spotting of IRC traffic on any port
  • SOCKS decoding
  • Fix to the truncation of extracted files
  • Includes magicpy in the distribution to solve the problems caused by the original website going away.

Distribution

Either download the .tar.gz file below (for Unix-like systems) or the .zip file (for windows) or checkout from svn.

To checkout the svn repository,

$ svn checkout  https://projects.honeynet.org/svn/honeysnap/trunk honeysnap

For CentOS 5/Fedora or Honeywall 1.3 or later, rpms are provided. You need to install all four.

Attachments