SnortSam Install

1) Compile and install SnortSam.

2) Patch and recompile Snort.

3) Configure SnortSam.

4) Configure Snort.

5) Firewall dependent configs.

1) To build SnortSam from source, download the sources from the SnortSam web site at You can download it at Alternatively, you can check the sources out from CVS with:

cvs -d co snortsam

Once you have the source (which you should since you are reading this file), just flag the make script '' as executable with:

chmod +x

Then just run the script:


This should compile Snortsam, which has been successfully compiled and run under FreeBSD?, Linux, Solaris, and Windows.

To compile Snortsam under Windows, open the SnortSam.dsp file with Microsoft's Visual C++. Then just select your Project (Normal or Debug, with OPSEC or without).

| Please see README.opsec for additional requirements when using the OPSEC | API with Checkpoints OPSEC SDK.

Now that SnortSam is compiled, simply copy the binary into a folder, for example /usr/local/bin.

You can also download one of the precompiled versions from the SnortSam web site.

2) To add the SnortSam plugin into Snort, download the snortsam-patch.tar.gz file from the SnortSam web or FTP site. You can also check it out of CVS:

cvs -d co snort-plugin

After you extract the tar ball, you should see following files:

Set the executable flag on the patch script:

chmod +x

and then run the script with the directory to Snort as the parameter, for example:

./ /usr/local/src/snort

Then recompile Snort.

Recompiling Snort can be done in two ways. If you retrieved the source of Snort via CVS, simply run snort/, and then run ./configure and make as usual.

If you built Snort from tarball, and you don't have the file in the snort directory, then change into /snort and run following commands manually:

cp ./m4/libprelude.m4 /usr/share/aclocal
automake --add-missing

Then run ./configure and make as usual.

3) SnortSam only takes one program argument which is the path and name of the configuration file. If not specified, SnortSam will use /etc/snortsam.conf. (under Windows, SnortSam will use snortsam.cfg from the same directory that SnortSam was started from).

This configuration file contains a variety of options. A sample configuration file snortsam.conf.sample is provided and contains a full description of the options.

At a very minimum, you need to specify what hosts (running Snort) are allowed to connect to SnortSam. This is done with the ACCEPT option.

accept for example will accept connections from the whole 10. network.

Then configure the firewall you want to block on. See the README. for options. Once configured, just run SnortSam with the path and name of the config file, for example:

./snortsam /usr/local/etc/snortsam.conf

4) Now that you have SnortSam running and listening, you need to configure Snort. The configuration is done in two places.

First you need to add the output plugin that let's Snort send blocking requests to SnortSam. Open your snort.conf file and add:

output alert_fwsam: {snortsambox}

is the name or IP address of the host running SnortSam. Other options can be set, for example if you configured SnortSam to use a different port than the default port (tcp 898), and set a password, or key, you would use:

output alert_fwsam: :/

If you have more than one SnortSam host (for example in a remote location), just add them on the same line, separated by a space. For example:

output alert_fwsam: localhost/myhostpass

Now that you have the output plugin configured, you need to configure the Snort rules that should invoke a block on the firewall. To do that, simply add an fwsam: statement in the rule. For example:

alert tcp $EXTERNAL_NET any -> $HTTP_SERVERS $HTTP_PORTS (msg:"WEB-ATTACKS /bin/ps command attempt"; flow:to_server,established; uricontent:"ps%20"; nocase; sid:1329; classtype:web-application-attack; rev:4;)

Add a 'fwsam: {who}, {duration};' so that the line reads:

alert tcp $EXTERNAL_NET any -> $HTTP_SERVERS $HTTP_PORTS (msg:"WEB-ATTACKS /bin/ps command attempt"; flow:to_server,established; uricontent:"ps%20"; nocase; sid:1329; classtype:web-application-attack; rev:4; fwsam: src, 5 minutes;)

Please read README.rules for a more detailed description of the fwsam parameters.

5) Depending on the type of firewall you want to block on, please read the README. documentation for required configuration changes on that particular firewall. These files should also list the firewall dependent options for the snortsam.conf file. See also README.conf for a summary of configuration options.

-- MattJonkman - 30 Oct 2007

Topic revision: r3 - 2007-10-30 - MattJonkman
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © Emerging Threats