suricata
detect-frame.c
Go to the documentation of this file.
1 /* Copyright (C) 2021-2022 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 
22 #include "suricata-common.h"
23 #include "threads.h"
24 #include "decode.h"
25 #include "detect.h"
26 
27 #include "app-layer-frames.h"
28 #include "app-layer-parser.h"
29 
30 #include "detect-parse.h"
31 #include "detect-engine.h"
32 #include "detect-engine-mpm.h"
34 #include "detect-content.h"
36 #include "detect-frame.h"
37 
38 #include "flow.h"
39 #include "flow-util.h"
40 #include "flow-var.h"
41 
42 #include "conf.h"
43 #include "conf-yaml-loader.h"
44 
45 #include "util-debug.h"
46 #include "util-unittest.h"
47 #include "util-spm.h"
48 #include "util-print.h"
49 
50 static int DetectFrameSetup(DetectEngineCtx *, Signature *, const char *);
51 
52 /**
53  * \brief this function setup the sticky buffer used in the rule
54  *
55  * \param de_ctx Pointer to the Detection Engine Context
56  * \param s Pointer to the Signature to which the current keyword belongs
57  * \param str The frame name. Can be short name 'pdu' or full name 'sip.pdu'
58  *
59  * \retval 0 On success
60  * \retval -1 On failure
61  */
62 static int DetectFrameSetup(DetectEngineCtx *de_ctx, Signature *s, const char *str)
63 {
64  char value[256] = "";
65  strlcpy(value, str, sizeof(value));
66  char buffer_name[512] = ""; // for registering in detect API we always need <proto>.<frame>.
67 
68  const bool is_tcp = DetectProtoContainsProto(&s->proto, IPPROTO_TCP);
69  const bool is_udp = DetectProtoContainsProto(&s->proto, IPPROTO_UDP);
70  if (!(is_tcp || is_udp)) {
71  SCLogError("'frame' keyword only supported for TCP and UDP");
72  return -1;
73  }
74 
75  char *dot = strchr(value, '.');
76  if (dot != NULL)
77  *dot++ = '\0';
78  const char *val = dot ? dot : value;
79  const char *proto = dot ? value : NULL;
80 
81  bool is_short = false;
82  AppProto keyword_alproto = ALPROTO_UNKNOWN;
83  AppProto rule_alproto = s->alproto;
84 
85  if (proto != NULL) {
86  keyword_alproto = StringToAppProto(proto);
87  if (!AppProtoIsValid(keyword_alproto)) {
88  is_short = true;
89  keyword_alproto = rule_alproto;
90  }
91  } else {
92  is_short = true;
93  keyword_alproto = rule_alproto;
94  }
95 
96  if (is_short && rule_alproto == ALPROTO_UNKNOWN) {
97  SCLogError("rule protocol unknown, can't use shorthand notation for frame '%s'", str);
98  return -1;
99  } else if (rule_alproto == ALPROTO_UNKNOWN) {
100  if (DetectSignatureSetAppProto(s, keyword_alproto) < 0)
101  return -1;
102  } else if (!AppProtoEquals(rule_alproto, keyword_alproto)) {
103  SCLogError("frame '%s' protocol '%s' mismatch with rule protocol '%s'", str,
104  AppProtoToString(keyword_alproto), AppProtoToString(s->alproto));
105  return -1;
106  }
107 
108  const char *frame_str = is_short ? str : val;
109  int raw_frame_type = -1;
110  if (is_tcp) {
111  if (strcmp(frame_str, "stream") == 0) {
112  raw_frame_type = FRAME_STREAM_TYPE;
113  } else {
114  raw_frame_type =
115  AppLayerParserGetFrameIdByName(IPPROTO_TCP, keyword_alproto, frame_str);
116  }
117  }
118  if (is_udp && raw_frame_type < 0)
119  raw_frame_type = AppLayerParserGetFrameIdByName(IPPROTO_UDP, keyword_alproto, frame_str);
120  if (raw_frame_type < 0) {
121  SCLogError("unknown frame '%s' for protocol '%s'", frame_str, proto);
122  return -1;
123  }
124  BUG_ON(raw_frame_type > UINT8_MAX);
125 
126  if (is_short) {
127  snprintf(buffer_name, sizeof(buffer_name), "%s.%s", AppProtoToString(s->alproto), str);
128  SCLogDebug("short name: %s", buffer_name);
129  } else {
130  strlcpy(buffer_name, str, sizeof(buffer_name));
131  SCLogDebug("long name: %s", buffer_name);
132  }
133 
134  uint8_t frame_type = (uint8_t)raw_frame_type;
135  /* TODO we can have TS and TC specific frames */
136  const int buffer_id = DetectEngineBufferTypeRegisterWithFrameEngines(de_ctx, buffer_name,
137  SIG_FLAG_TOSERVER | SIG_FLAG_TOCLIENT, keyword_alproto, frame_type);
138  if (buffer_id < 0)
139  return -1;
140 
141  if (DetectBufferSetActiveList(de_ctx, s, buffer_id) < 0)
142  return -1;
143 
144  FrameConfigEnable(keyword_alproto, frame_type);
145  return 0;
146 }
147 
148 #ifdef UNITTESTS
149 
150 static int DetectFrameTestBadRules(void)
151 {
154 
155  const char *sigs[] = {
156  "alert tcp-pkt any any -> any any (frame:tls.pdu; content:\"a\"; sid:1;)",
157  "alert udp any any -> any any (frame:tls.pdu; content:\"a\"; sid:2;)",
158  "alert smb any any -> any any (frame:tls.pdu; content:\"a\"; sid:3;)",
159  "alert tcp any any -> any any (frame:tls; content:\"a\"; sid:4;)",
160  "alert tls any any -> any any (content:\"abc\"; frame:tls.pdu; content:\"a\"; sid:5;)",
161  "alert tls any any -> any any (tls.version:1.0; frame:tls.pdu; content:\"a\"; sid:6;)",
162  "alert tls any any -> any any (frame:smb1.pdu; content:\"a\"; sid:7;)",
163  NULL,
164  };
165 
166  const char **sig = sigs;
167  while (*sig) {
168  SCLogDebug("sig %s", *sig);
170  FAIL_IF_NOT_NULL(s);
171  sig++;
172  }
173 
175  PASS;
176 }
177 
178 static void DetectFrameRegisterTests(void)
179 {
180  UtRegisterTest("DetectFrameTestBadRules", DetectFrameTestBadRules);
181 }
182 #endif
183 
184 /**
185  * \brief Registration function for keyword: ja3_hash
186  */
188 {
189  sigmatch_table[DETECT_FRAME].name = "frame";
190  sigmatch_table[DETECT_FRAME].desc = "sticky buffer for inspecting app-layer frames";
191  sigmatch_table[DETECT_FRAME].Setup = DetectFrameSetup;
193 #ifdef UNITTESTS
194  sigmatch_table[DETECT_FRAME].RegisterTests = DetectFrameRegisterTests;
195 #endif
196 }
DetectSignatureSetAppProto
int DetectSignatureSetAppProto(Signature *s, AppProto alproto)
Definition: detect-parse.c:1753
detect-content.h
detect-engine.h
FAIL_IF_NULL
#define FAIL_IF_NULL(expr)
Fail a test if expression evaluates to NULL.
Definition: util-unittest.h:89
SIGMATCH_INFO_STICKY_BUFFER
#define SIGMATCH_INFO_STICKY_BUFFER
Definition: detect.h:1497
SigTableElmt_::desc
const char * desc
Definition: detect.h:1295
flow-util.h
SigTableElmt_::name
const char * name
Definition: detect.h:1293
UtRegisterTest
void UtRegisterTest(const char *name, int(*TestFn)(void))
Register unit test.
Definition: util-unittest.c:103
Signature_::alproto
AppProto alproto
Definition: detect.h:598
SCLogDebug
#define SCLogDebug(...)
Definition: util-debug.h:269
AppProto
uint16_t AppProto
Definition: app-layer-protos.h:80
DetectBufferSetActiveList
int DetectBufferSetActiveList(DetectEngineCtx *de_ctx, Signature *s, const int list)
Definition: detect-engine.c:1382
threads.h
AppProtoToString
const char * AppProtoToString(AppProto alproto)
Maps the ALPROTO_*, to its string equivalent.
Definition: app-layer-protos.c:74
SigTableElmt_::flags
uint16_t flags
Definition: detect.h:1287
DetectEngineCtx_
main detection engine ctx
Definition: detect.h:836
DetectEngineCtxFree
void DetectEngineCtxFree(DetectEngineCtx *)
Free a DetectEngineCtx::
Definition: detect-engine.c:2580
DETECT_FRAME
@ DETECT_FRAME
Definition: detect-engine-register.h:110
proto
uint8_t proto
Definition: decode-template.h:0
DetectEngineAppendSig
Signature * DetectEngineAppendSig(DetectEngineCtx *, const char *)
Parse and append a Signature into the Detection Engine Context signature list.
Definition: detect-parse.c:2620
SIG_FLAG_TOCLIENT
#define SIG_FLAG_TOCLIENT
Definition: detect.h:264
SigTableElmt_::Setup
int(* Setup)(DetectEngineCtx *, Signature *, const char *)
Definition: detect.h:1278
detect-engine-prefilter.h
util-unittest.h
strlcpy
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: util-strlcpyu.c:43
SIG_FLAG_TOSERVER
#define SIG_FLAG_TOSERVER
Definition: detect.h:263
decode.h
FAIL_IF_NOT_NULL
#define FAIL_IF_NOT_NULL(expr)
Fail a test if expression evaluates to non-NULL.
Definition: util-unittest.h:96
util-debug.h
PASS
#define PASS
Pass the test.
Definition: util-unittest.h:105
de_ctx
DetectEngineCtx * de_ctx
Definition: fuzz_siginit.c:17
StringToAppProto
AppProto StringToAppProto(const char *proto_name)
Maps a string to its ALPROTO_* equivalent.
Definition: app-layer-protos.c:94
util-print.h
detect-engine-mpm.h
detect.h
app-layer-parser.h
BUG_ON
#define BUG_ON(x)
Definition: suricata-common.h:300
detect-frame.h
conf-yaml-loader.h
conf.h
detect-engine-content-inspection.h
DetectEngineBufferTypeRegisterWithFrameEngines
int DetectEngineBufferTypeRegisterWithFrameEngines(DetectEngineCtx *de_ctx, const char *name, const int direction, const AppProto alproto, const uint8_t frame_type)
Definition: detect-engine.c:1172
app-layer-frames.h
Signature_::proto
DetectProto proto
Definition: detect.h:612
suricata-common.h
AppLayerParserGetFrameIdByName
int AppLayerParserGetFrameIdByName(uint8_t ipproto, AppProto alproto, const char *name)
Definition: app-layer-parser.c:1614
sigmatch_table
SigTableElmt sigmatch_table[DETECT_TBLSIZE]
Definition: detect-parse.c:127
util-spm.h
FRAME_STREAM_TYPE
#define FRAME_STREAM_TYPE
Definition: app-layer-frames.h:30
str
#define str(s)
Definition: suricata-common.h:291
SCLogError
#define SCLogError(...)
Macro used to log ERROR messages.
Definition: util-debug.h:261
detect-parse.h
Signature_
Signature container.
Definition: detect.h:593
FrameConfigEnable
void FrameConfigEnable(const AppProto p, const uint8_t type)
Definition: app-layer-frames.c:54
ALPROTO_UNKNOWN
@ ALPROTO_UNKNOWN
Definition: app-layer-protos.h:29
DetectEngineCtxInit
DetectEngineCtx * DetectEngineCtxInit(void)
Definition: detect-engine.c:2541
flow.h
flow-var.h
SigTableElmt_::RegisterTests
void(* RegisterTests)(void)
Definition: detect.h:1285
DetectProtoContainsProto
int DetectProtoContainsProto(const DetectProto *dp, int proto)
see if a DetectProto contains a certain proto
Definition: detect-engine-proto.c:135
DetectFrameRegister
void DetectFrameRegister(void)
Registration function for keyword: ja3_hash.
Definition: detect-frame.c:187