Project

General

Profile


This documentation is no longer maintained and exists for historical purposes. The current documentation is located at http://suricata.readthedocs.io/.


Suricata Rules

Introduction

Signatures play a very important role in Suricata. In most occasions people are using existing rulesets. The most used are Emerging Threats, Emerging Threats Pro and source fire's VRT. A way to install rules is described in Rule Management with Oinkmaster.
This Suricata Rules document explains all about signatures; how to read-, adjust-and create them.

A rule/signature consists of the following:
The action, header and rule-options.

Example of a signature:

Action

For more information read 'Action Order' in the suricata.yaml wiki.

Example:

In this example the red, bold-faced part is the action.

Protocol

This keyword in a signature tells Suricata which protocol it concerns. You can choose between four settings. tcp (for tcp-traffic), udp, icmp and ip. ip stands for 'all' or 'any'.
Suricata adds a few protocols : http, ftp, tls (this includes ssl), smb and dns (from v2.0). These are the so-called application layer protocols or layer 7 protocols.
If you have a signature with for instance a http-protocol, Suricata makes sure the signature can only match if it concerns http-traffic.

Example:

In this example the red, bold-faced part is the protocol.

Source and destination

In source you can assign IP-addresses; IPv4 and IPv6 combined as well as separated. You can also set variables such as HOME_NET. (For more information see 'Rule-vars' at Suricata.yaml in the user guide.)
In the Yaml-file you can set IP-addresses for variables such as EXTERNAL_NET and HOME_NET. These settings will be used when you use these variables in a rule.
In source and destination you can make use of signs like ! And [ ].

For example:

! 1.1.1.1                       (Every IP address but 1.1.1.1)
![1.1.1.1, 1.1.1.2]             (Every IP address but 1.1.1.1 and 1.1.1.2)    
$HOME_NET                       (Your setting of HOME_NET in yaml)
[$EXTERNAL_NET, !$HOME_NET]     (EXTERNAL_NET and not HOME_NET)
[10.0.0.0/24, !10.0.0.5]        (10.0.0.0/24 except for 10.0.0.5) 
[…..,[....]]
[…. ,![.....]]

Pay attention to the following:

If your settings in Yaml are:

HOME_NET: any
EXTERNAL_NET: ! $HOME_NET
You can not write a signature using EXTERNAL_NET because it stands for 'not any'. This is a invalid setting.

Example of source and destination in a signature:

The red, bold-faced part is the source.

The red, bold-faced part is the destination.

Ports (source-and destination-port)

Traffic comes in and goes out through ports. Different ports have different port-numbers. The HTTP-port for example is 80 while 443 is the port for HTTPS and MSN makes use of port 1863. Commonly the Source port will be set as 'any'. This will be influenced by the protocol. The source port is designated at random by the operating system. Sometimes it is possible to filter/screen on the source
In setting ports you can make use of special signs as well, like described above at 'source'. Signs like:

!       exception/negation
:       range
[]      signs to make clear which parts belong together
,       separation

Example:

[80, 81, 82]    (port 80, 81 and 82)
[80: 82]        (Range from 80 till 82)
[1024: ]        (From 1024 till the highest port-number)
!80             (Every port but 80)
[80:100,!99]    (Range from 80 till 100 but 99 excluded)
[1:80,![2,4]]
[….[.....]]

Example of ports in a signature:

In this example, the red, bold-faced part is the port.

Direction

The direction tells in which way the signature has to match. Nearly every signature has an arrow to the right. This means that only packets with the same direction can match.

source -> destination
source <> destination  (both directions)

Example:

alert tcp 1.2.3.4 1024 - > 5.6.7.8 80

Example 1 tcp-session

In this example there will only be a match if the signature has the same order/direction as the payload.

Example of direction in a signature:

In this example the red, bold-faced part is the direction.

Rule options

Keywords have a set format:

name: settings;

Sometimes it is just the name of the setting followed by ; . Like nocase;

There are specific settings for:
  • meta-information.
  • headers
  • payloads
  • flows

For more information about these settings, you can click on the following headlines:

Meta-settings

Payload keywords

HTTP-keywords

DNS-keywords

Flow-keywords

IP Reputation keyword

TCP-session.png View (36.3 KB) Anne-Fleur Koolstra, 12/16/2010 07:49 AM

action.png View (39.9 KB) Anne-Fleur Koolstra, 01/11/2011 09:00 AM

protocol.png View (38.1 KB) Anne-Fleur Koolstra, 01/11/2011 09:00 AM

Source.png View (39.1 KB) Anne-Fleur Koolstra, 01/11/2011 09:02 AM

destination.png View (41.1 KB) Anne-Fleur Koolstra, 01/11/2011 09:02 AM

Source-port.png View (39.2 KB) Anne-Fleur Koolstra, 01/11/2011 09:02 AM

Dest_port.png View (40.5 KB) Anne-Fleur Koolstra, 01/11/2011 09:03 AM

Direction.png View (40 KB) Anne-Fleur Koolstra, 01/11/2011 09:04 AM

intro_sig.png View (42.5 KB) Anne-Fleur Koolstra, 01/11/2011 09:54 AM