suricata
detect-tcp-window.c
Go to the documentation of this file.
1 /* Copyright (C) 2007-2020 Open Information Security Foundation
2  *
3  * You can copy, redistribute or modify this Program under the terms of
4  * the GNU General Public License version 2 as published by the Free
5  * Software Foundation.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * version 2 along with this program; if not, write to the Free Software
14  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
15  * 02110-1301, USA.
16  */
17 
18 /**
19  * \file
20  *
21  * \author Pablo Rincon Crespo <pablo.rincon.crespo@gmail.com>
22  *
23  * Implements the window keyword.
24  */
25 
26 #include "suricata-common.h"
27 #include "debug.h"
28 #include "decode.h"
29 
30 #include "detect.h"
31 #include "detect-parse.h"
32 
33 #include "detect-tcp-window.h"
34 #include "flow.h"
35 #include "flow-var.h"
36 
37 #include "util-debug.h"
38 #include "util-unittest.h"
39 #include "util-unittest-helper.h"
40 #include "util-byte.h"
41 
42 /**
43  * \brief Regex for parsing our window option
44  */
45 #define PARSE_REGEX "^\\s*([!])?\\s*([0-9]{1,9}+)\\s*$"
46 
47 static DetectParseRegex parse_regex;
48 
49 static int DetectWindowMatch(DetectEngineThreadCtx *, Packet *,
50  const Signature *, const SigMatchCtx *);
51 static int DetectWindowSetup(DetectEngineCtx *, Signature *, const char *);
52 #ifdef UNITTESTS
53 static void DetectWindowRegisterTests(void);
54 #endif
55 void DetectWindowFree(DetectEngineCtx *, void *);
56 
57 /**
58  * \brief Registration function for window: keyword
59  */
61 {
62  sigmatch_table[DETECT_WINDOW].name = "tcp.window";
64  sigmatch_table[DETECT_WINDOW].desc = "check for a specific TCP window size";
65  sigmatch_table[DETECT_WINDOW].url = "/rules/header-keywords.html#window";
66  sigmatch_table[DETECT_WINDOW].Match = DetectWindowMatch;
67  sigmatch_table[DETECT_WINDOW].Setup = DetectWindowSetup;
69 #ifdef UNITTESTS
70  sigmatch_table[DETECT_WINDOW].RegisterTests = DetectWindowRegisterTests;
71 #endif
72  DetectSetupParseRegexes(PARSE_REGEX, &parse_regex);
73 }
74 
75 /**
76  * \brief This function is used to match the window size on a packet
77  *
78  * \param t pointer to thread vars
79  * \param det_ctx pointer to the pattern matcher thread
80  * \param p pointer to the current packet
81  * \param m pointer to the sigmatch that we will cast into DetectWindowData
82  *
83  * \retval 0 no match
84  * \retval 1 match
85  */
86 static int DetectWindowMatch(DetectEngineThreadCtx *det_ctx, Packet *p,
87  const Signature *s, const SigMatchCtx *ctx)
88 {
89  const DetectWindowData *wd = (const DetectWindowData *)ctx;
90 
91  if ( !(PKT_IS_TCP(p)) || wd == NULL || PKT_IS_PSEUDOPKT(p)) {
92  return 0;
93  }
94 
95  if ( (!wd->negated && wd->size == TCP_GET_WINDOW(p)) || (wd->negated && wd->size != TCP_GET_WINDOW(p))) {
96  return 1;
97  }
98 
99  return 0;
100 }
101 
102 /**
103  * \brief This function is used to parse window options passed via window: keyword
104  *
105  * \param de_ctx Pointer to the detection engine context
106  * \param windowstr Pointer to the user provided window options (negation! and size)
107  *
108  * \retval wd pointer to DetectWindowData on success
109  * \retval NULL on failure
110  */
111 static DetectWindowData *DetectWindowParse(DetectEngineCtx *de_ctx, const char *windowstr)
112 {
113  DetectWindowData *wd = NULL;
114  int ret = 0, res = 0;
115  int ov[MAX_SUBSTRINGS];
116 
117  ret = DetectParsePcreExec(&parse_regex, windowstr, 0, 0, ov, MAX_SUBSTRINGS);
118  if (ret < 1 || ret > 3) {
119  SCLogError(SC_ERR_PCRE_MATCH, "pcre_exec parse error, ret %" PRId32 ", string %s", ret, windowstr);
120  goto error;
121  }
122 
123  wd = SCMalloc(sizeof(DetectWindowData));
124  if (unlikely(wd == NULL))
125  goto error;
126 
127  if (ret > 1) {
128  char copy_str[128] = "";
129  res = pcre_copy_substring((char *)windowstr, ov, MAX_SUBSTRINGS, 1,
130  copy_str, sizeof(copy_str));
131  if (res < 0) {
132  SCLogError(SC_ERR_PCRE_GET_SUBSTRING, "pcre_copy_substring failed");
133  goto error;
134  }
135 
136  /* Detect if it's negated */
137  if (copy_str[0] == '!')
138  wd->negated = 1;
139  else
140  wd->negated = 0;
141 
142  if (ret > 2) {
143  res = pcre_copy_substring((char *)windowstr, ov, MAX_SUBSTRINGS, 2,
144  copy_str, sizeof(copy_str));
145  if (res < 0) {
146  SCLogError(SC_ERR_PCRE_GET_SUBSTRING, "pcre_copy_substring failed");
147  goto error;
148  }
149 
150  /* Get the window size if it's a valid value (in packets, we
151  * should alert if this doesn't happend from decode) */
152  if (StringParseUint16(&wd->size, 10, 0, copy_str) < 0) {
153  goto error;
154  }
155  }
156  }
157 
158  return wd;
159 
160 error:
161  if (wd != NULL)
163  return NULL;
164 
165 }
166 
167 /**
168  * \brief this function is used to add the parsed window sizedata into the current signature
169  *
170  * \param de_ctx pointer to the Detection Engine Context
171  * \param s pointer to the Current Signature
172  * \param windowstr pointer to the user provided window options
173  *
174  * \retval 0 on Success
175  * \retval -1 on Failure
176  */
177 static int DetectWindowSetup (DetectEngineCtx *de_ctx, Signature *s, const char *windowstr)
178 {
179  DetectWindowData *wd = NULL;
180  SigMatch *sm = NULL;
181 
182  wd = DetectWindowParse(de_ctx, windowstr);
183  if (wd == NULL) goto error;
184 
185  /* Okay so far so good, lets get this into a SigMatch
186  * and put it in the Signature. */
187  sm = SigMatchAlloc();
188  if (sm == NULL)
189  goto error;
190 
191  sm->type = DETECT_WINDOW;
192  sm->ctx = (SigMatchCtx *)wd;
193 
196 
197  return 0;
198 
199 error:
200  if (wd != NULL) DetectWindowFree(de_ctx, wd);
201  if (sm != NULL) SCFree(sm);
202  return -1;
203 
204 }
205 
206 /**
207  * \brief this function will free memory associated with DetectWindowData
208  *
209  * \param wd pointer to DetectWindowData
210  */
212 {
213  DetectWindowData *wd = (DetectWindowData *)ptr;
214  SCFree(wd);
215 }
216 
217 #ifdef UNITTESTS /* UNITTESTS */
218 
219 /**
220  * \test DetectWindowTestParse01 is a test to make sure that we set the size correctly
221  * when given valid window opt
222  */
223 static int DetectWindowTestParse01 (void)
224 {
225  int result = 0;
226  DetectWindowData *wd = NULL;
227  wd = DetectWindowParse(NULL, "35402");
228  if (wd != NULL &&wd->size==35402) {
229  DetectWindowFree(NULL, wd);
230  result = 1;
231  }
232 
233  return result;
234 }
235 
236 /**
237  * \test DetectWindowTestParse02 is a test for setting the window opt negated
238  */
239 static int DetectWindowTestParse02 (void)
240 {
241  int result = 0;
242  DetectWindowData *wd = NULL;
243  wd = DetectWindowParse(NULL, "!35402");
244  if (wd != NULL) {
245  if (wd->negated == 1 && wd->size==35402) {
246  result = 1;
247  } else {
248  printf("expected wd->negated=1 and wd->size=35402\n");
249  }
250  DetectWindowFree(NULL, wd);
251  }
252 
253  return result;
254 }
255 
256 /**
257  * \test DetectWindowTestParse03 is a test to check for an empty value
258  */
259 static int DetectWindowTestParse03 (void)
260 {
261  int result = 0;
262  DetectWindowData *wd = NULL;
263  wd = DetectWindowParse(NULL, "");
264  if (wd == NULL) {
265  result = 1;
266  } else {
267  printf("expected a NULL pointer (It was an empty string)\n");
268  }
269  DetectWindowFree(NULL, wd);
270 
271  return result;
272 }
273 
274 /**
275  * \test DetectWindowTestParse03 is a test to check for a big value
276  */
277 static int DetectWindowTestParse04 (void)
278 {
279  int result = 0;
280  DetectWindowData *wd = NULL;
281  wd = DetectWindowParse(NULL, "1235402");
282  if (wd != NULL) {
283  printf("expected a NULL pointer (It was exceeding the MAX window size)\n");
284  DetectWindowFree(NULL, wd);
285  }else
286  result=1;
287 
288  return result;
289 }
290 
291 /**
292  * \test DetectWindowTestPacket01 is a test to check window with constructed packets
293  */
294 static int DetectWindowTestPacket01 (void)
295 {
296  int result = 0;
297  uint8_t *buf = (uint8_t *)"Hi all!";
298  uint16_t buflen = strlen((char *)buf);
299  Packet *p[3];
300  p[0] = UTHBuildPacket((uint8_t *)buf, buflen, IPPROTO_TCP);
301  p[1] = UTHBuildPacket((uint8_t *)buf, buflen, IPPROTO_TCP);
302  p[2] = UTHBuildPacket((uint8_t *)buf, buflen, IPPROTO_ICMP);
303 
304  if (p[0] == NULL || p[1] == NULL ||p[2] == NULL)
305  goto end;
306 
307  /* TCP wwindow = 40 */
308  p[0]->tcph->th_win = htons(40);
309 
310  /* TCP window = 41 */
311  p[1]->tcph->th_win = htons(41);
312 
313  const char *sigs[2];
314  sigs[0]= "alert tcp any any -> any any (msg:\"Testing window 1\"; window:40; sid:1;)";
315  sigs[1]= "alert tcp any any -> any any (msg:\"Testing window 2\"; window:41; sid:2;)";
316 
317  uint32_t sid[2] = {1, 2};
318 
319  uint32_t results[3][2] = {
320  /* packet 0 match sid 1 but should not match sid 2 */
321  {1, 0},
322  /* packet 1 should not match */
323  {0, 1},
324  /* packet 2 should not match */
325  {0, 0} };
326  result = UTHGenericTest(p, 3, sigs, sid, (uint32_t *) results, 2);
327 
328  UTHFreePackets(p, 3);
329 end:
330  return result;
331 }
332 
333 /**
334  * \brief this function registers unit tests for DetectWindow
335  */
336 void DetectWindowRegisterTests(void)
337 {
338  UtRegisterTest("DetectWindowTestParse01", DetectWindowTestParse01);
339  UtRegisterTest("DetectWindowTestParse02", DetectWindowTestParse02);
340  UtRegisterTest("DetectWindowTestParse03", DetectWindowTestParse03);
341  UtRegisterTest("DetectWindowTestParse04", DetectWindowTestParse04);
342  UtRegisterTest("DetectWindowTestPacket01", DetectWindowTestPacket01);
343 }
344 #endif /* UNITTESTS */
util-byte.h
SigTableElmt_::url
const char * url
Definition: detect.h:1213
StringParseUint16
int StringParseUint16(uint16_t *res, int base, uint16_t len, const char *str)
Definition: util-byte.c:336
SigTableElmt_::desc
const char * desc
Definition: detect.h:1212
SigTableElmt_::Free
void(* Free)(DetectEngineCtx *, void *)
Definition: detect.h:1200
SigTableElmt_::name
const char * name
Definition: detect.h:1210
PKT_IS_PSEUDOPKT
#define PKT_IS_PSEUDOPKT(p)
return 1 if the packet is a pseudo packet
Definition: decode.h:1142
MAX_SUBSTRINGS
#define MAX_SUBSTRINGS
unlikely
#define unlikely(expr)
Definition: util-optimize.h:35
UtRegisterTest
void UtRegisterTest(const char *name, int(*TestFn)(void))
Register unit test.
Definition: util-unittest.c:103
results
struct DetectRfbSecresult_ results[]
DetectEngineCtx_
main detection engine ctx
Definition: detect.h:766
DetectWindowFree
void DetectWindowFree(DetectEngineCtx *, void *)
this function will free memory associated with DetectWindowData
Definition: detect-tcp-window.c:211
UTHBuildPacket
Packet * UTHBuildPacket(uint8_t *payload, uint16_t payload_len, uint8_t ipproto)
UTHBuildPacket is a wrapper that build packets with default ip and port fields.
Definition: util-unittest-helper.c:337
SC_ERR_PCRE_GET_SUBSTRING
@ SC_ERR_PCRE_GET_SUBSTRING
Definition: util-error.h:34
DetectWindowData_
Definition: detect-tcp-window.h:24
SigTableElmt_::Setup
int(* Setup)(DetectEngineCtx *, Signature *, const char *)
Definition: detect.h:1195
util-unittest.h
util-unittest-helper.h
TCP_GET_WINDOW
#define TCP_GET_WINDOW(p)
Definition: decode-tcp.h:114
PKT_IS_TCP
#define PKT_IS_TCP(p)
Definition: decode.h:257
decode.h
util-debug.h
SC_ERR_PCRE_MATCH
@ SC_ERR_PCRE_MATCH
Definition: util-error.h:32
de_ctx
DetectEngineCtx * de_ctx
Definition: fuzz_siginit.c:17
DetectWindowRegister
void DetectWindowRegister(void)
Registration function for window: keyword.
Definition: detect-tcp-window.c:60
DetectEngineThreadCtx_
Definition: detect.h:1009
res
PoolThreadReserved res
Definition: stream-tcp-private.h:0
DetectSetupParseRegexes
void DetectSetupParseRegexes(const char *parse_str, DetectParseRegex *detect_parse)
Definition: detect-parse.c:2476
DetectWindowData_::negated
uint8_t negated
Definition: detect-tcp-window.h:25
detect.h
detect-tcp-window.h
DETECT_SM_LIST_MATCH
@ DETECT_SM_LIST_MATCH
Definition: detect.h:89
SigMatch_::ctx
SigMatchCtx * ctx
Definition: detect.h:322
Signature_::flags
uint32_t flags
Definition: detect.h:528
DetectParsePcreExec
int DetectParsePcreExec(DetectParseRegex *parse_regex, const char *str, int start_offset, int options, int *ovector, int ovector_size)
Definition: detect-parse.c:2406
Packet_
Definition: decode.h:412
SigTableElmt_::Match
int(* Match)(DetectEngineThreadCtx *, Packet *, const Signature *, const SigMatchCtx *)
Definition: detect.h:1178
PARSE_REGEX
#define PARSE_REGEX
Regex for parsing our window option.
Definition: detect-tcp-window.c:45
SigMatchAlloc
SigMatch * SigMatchAlloc(void)
Definition: detect-parse.c:235
DetectWindowData_::size
uint16_t size
Definition: detect-tcp-window.h:26
SigMatch_::type
uint8_t type
Definition: detect.h:320
SigMatchCtx_
Used to start a pointer to SigMatch context Should never be dereferenced without casting to something...
Definition: detect.h:314
SigTableElmt_::alias
const char * alias
Definition: detect.h:1211
suricata-common.h
Packet_::tcph
TCPHdr * tcph
Definition: decode.h:529
sigmatch_table
SigTableElmt sigmatch_table[DETECT_TBLSIZE]
Definition: detect-parse.c:73
DetectParseRegex_
Definition: detect-parse.h:42
SCLogError
#define SCLogError(err_code,...)
Macro used to log ERROR messages.
Definition: util-debug.h:257
UTHGenericTest
int UTHGenericTest(Packet **pkt, int numpkts, const char *sigs[], uint32_t sids[], uint32_t *results, int numsigs)
UTHGenericTest: function that perfom a generic check taking care of as maximum common unittest elemen...
Definition: util-unittest-helper.c:604
SCMalloc
#define SCMalloc(sz)
Definition: util-mem.h:47
SCFree
#define SCFree(p)
Definition: util-mem.h:61
detect-parse.h
Signature_
Signature container.
Definition: detect.h:527
SigMatch_
a single match condition for a signature
Definition: detect.h:319
DETECT_WINDOW
@ DETECT_WINDOW
Definition: detect-engine-register.h:38
flow.h
flow-var.h
SigMatchAppendSMToList
void SigMatchAppendSMToList(Signature *s, SigMatch *new, int list)
Append a SigMatch to the list type.
Definition: detect-parse.c:349
debug.h
SigTableElmt_::RegisterTests
void(* RegisterTests)(void)
Definition: detect.h:1202
SIG_FLAG_REQUIRE_PACKET
#define SIG_FLAG_REQUIRE_PACKET
Definition: detect.h:223
UTHFreePackets
void UTHFreePackets(Packet **p, int numpkts)
UTHFreePackets: function to release the allocated data from UTHBuildPacket and the packet itself.
Definition: util-unittest-helper.c:468