openbsd-ports/net/snort/pkg
lteo 53898bf3e1 Make various improvements to the Snort port:
* Add an rc.d script.

* In snort.conf, provide the URL to the official Snort rules so that
  users know where to get them.

* In snort.conf, provide the URL to the Emerging Threats rules along
  with a commented include line to allow users to easily load the
  Emerging Threats rules if they wish.

* Revise pkg/README with details on where to obtain Snort rules, the
  differences between the official Snort rules and Emerging Threats
  rules, how to download them, and provide some guidance on setting up
  Snort.

snort.conf and README changes OK Markus Lude (maintainer), sthen@
rc.d script OK sthen@
2012-10-11 02:40:48 +00:00
..
DESCR Update Snort to 2.9.3.1. 2012-09-26 02:11:05 +00:00
PLIST Make various improvements to the Snort port: 2012-10-11 02:40:48 +00:00
README Make various improvements to the Snort port: 2012-10-11 02:40:48 +00:00
snort.rc Make various improvements to the Snort port: 2012-10-11 02:40:48 +00:00

$OpenBSD: README,v 1.2 2012/10/11 02:40:48 lteo Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

An up-to-date set of rules is needed for Snort to be useful as an IDS.
By default, these rules are expected to be present in the
${SYSCONFDIR}/snort/rules directory as defined by RULE_PATH in
${SYSCONFDIR}/snort/snort.conf.

The two most common sources of Snort rules are the official Snort rules
and the Emerging Threats rules.  To download the official Snort rules,
you will first need to sign up for an "oinkcode" at
https://www.snort.org/signup since they are distributed under a
commercial license.  Emerging Threats rules can be downloaded without
signing up.

The easiest way to download these rules is to use a rule manager such as
the oinkmaster package.  You can set up oinkmaster's config file to
download one or more Snort rulesets and extract them automatically.
Please refer to the documentation in the oinkmaster package for more
details.

If you prefer to obtain the rules manually without using a rule manager,
you can use the following example commands to download and extract them
to the correct directory:

* Official Snort rules (replace <oinkcode> with yours):

    ftp -o snortrules-snapshot-${V}.tar.gz \
        http://www.snort.org/reg-rules/snortrules-snapshot-${V}.tar.gz/<oinkcode>
    tar -C /etc/snort -xzf snortrules-snapshot-${V}.tar.gz rules preproc_rules

* Emerging Threats rules:

    ftp http://rules.emergingthreats.net/open/snort-2.9.0/emerging.rules.tar.gz
    tar -C /etc/snort -xzf emerging.rules.tar.gz

  If you use Emerging Threats rules, you will need to uncomment its
  include line in ${SYSCONFDIR}/snort/snort.conf and edit
  ${SYSCONFDIR}/snort/rules/emerging.conf for Snort to load them.

It is important that you review the rules carefully to ensure that you
use the rules that apply to your environment.  You should also modify
${SYSCONFDIR}/snort/snort.conf to define the relevant variables such as
HOME_NET to match your network.

It is recommended that Snort be run as an unprivileged chrooted user.
A _snort user/group and a log directory have been created for this
purpose. You should start Snort with the ${RCDIR}/snort script to take
advantage of this.

For more details on setting up Snort, please refer to its user manual at
${TRUEPREFIX}/share/doc/snort/snort_manual.pdf