suricata
detect-transform-md5.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 Victor Julien <victor@inliniac.net>
22  *
23  * Implements the to_md5 transformation keyword
24  */
25 
26 #include "suricata-common.h"
27 
28 #include "detect.h"
29 #include "detect-engine.h"
31 #include "detect-parse.h"
32 #include "detect-transform-md5.h"
33 
34 #include "util-unittest.h"
35 #include "util-print.h"
36 #include "rust.h"
37 
38 static int DetectTransformToMd5Setup (DetectEngineCtx *, Signature *, const char *);
39 #ifdef UNITTESTS
40 static void DetectTransformToMd5RegisterTests(void);
41 #endif
42 static void TransformToMd5(InspectionBuffer *buffer, void *options);
43 
45 {
48  "convert to md5 hash of the buffer";
50  "/rules/transforms.html#to-md5";
52  DetectTransformToMd5Setup;
54  TransformToMd5;
55 #ifdef UNITTESTS
57  DetectTransformToMd5RegisterTests;
58 #endif
60 }
61 
62 /**
63  * \internal
64  * \brief Apply the nocase keyword to the last pattern match, either content or uricontent
65  * \param det_ctx detection engine ctx
66  * \param s signature
67  * \param nullstr should be null
68  * \retval 0 ok
69  * \retval -1 failure
70  */
71 static int DetectTransformToMd5Setup (DetectEngineCtx *de_ctx, Signature *s, const char *nullstr)
72 {
73  SCEnter();
74  if (g_disable_hashing) {
75  SCLogError(SC_ERR_HASHING_DISABLED, "MD5 hashing has been disabled, "
76  "needed for to_md5 keyword");
77  SCReturnInt(-1);
78  }
80  SCReturnInt(r);
81 }
82 
83 static void TransformToMd5(InspectionBuffer *buffer, void *options)
84 {
85  const uint8_t *input = buffer->inspect;
86  const uint32_t input_len = buffer->inspect_len;
87  uint8_t output[SC_MD5_LEN];
88 
89  //PrintRawDataFp(stdout, input, input_len);
90  SCMd5HashBuffer(input, input_len, output, sizeof(output));
91  InspectionBufferCopy(buffer, output, sizeof(output));
92 }
93 
94 #ifdef UNITTESTS
95 static int DetectTransformToMd5Test01(void)
96 {
97  const uint8_t *input = (const uint8_t *)" A B C D ";
98  uint32_t input_len = strlen((char *)input);
99 
100  InspectionBuffer buffer;
101  InspectionBufferInit(&buffer, 8);
102  InspectionBufferSetup(NULL, -1, &buffer, input, input_len);
103  PrintRawDataFp(stdout, buffer.inspect, buffer.inspect_len);
104  TransformToMd5(&buffer, NULL);
105  PrintRawDataFp(stdout, buffer.inspect, buffer.inspect_len);
106  InspectionBufferFree(&buffer);
107  PASS;
108 }
109 
110 static void DetectTransformToMd5RegisterTests(void)
111 {
112  UtRegisterTest("DetectTransformToMd5Test01",
113  DetectTransformToMd5Test01);
114 }
115 #endif
SigTableElmt_::url
const char * url
Definition: detect.h:1238
detect-engine.h
SigTableElmt_::desc
const char * desc
Definition: detect.h:1237
SigTableElmt_::name
const char * name
Definition: detect.h:1235
UtRegisterTest
void UtRegisterTest(const char *name, int(*TestFn)(void))
Register unit test.
Definition: util-unittest.c:103
InspectionBuffer
Definition: detect.h:337
SigTableElmt_::flags
uint16_t flags
Definition: detect.h:1229
DetectEngineCtx_
main detection engine ctx
Definition: detect.h:784
SC_MD5_LEN
#define SC_MD5_LEN
Definition: rust.h:31
rust.h
SigTableElmt_::Setup
int(* Setup)(DetectEngineCtx *, Signature *, const char *)
Definition: detect.h:1220
detect-engine-prefilter.h
util-unittest.h
InspectionBufferInit
void InspectionBufferInit(InspectionBuffer *buffer, uint32_t initial_size)
Definition: detect-engine.c:1425
PASS
#define PASS
Pass the test.
Definition: util-unittest.h:105
de_ctx
DetectEngineCtx * de_ctx
Definition: fuzz_siginit.c:17
util-print.h
detect-transform-md5.h
SCEnter
#define SCEnter(...)
Definition: util-debug.h:298
detect.h
PrintRawDataFp
void PrintRawDataFp(FILE *fp, const uint8_t *buf, uint32_t buflen)
Definition: util-print.c:143
DETECT_TRANSFORM_MD5
@ DETECT_TRANSFORM_MD5
Definition: detect-engine-register.h:316
SC_ERR_HASHING_DISABLED
@ SC_ERR_HASHING_DISABLED
Definition: util-error.h:370
InspectionBufferCopy
void InspectionBufferCopy(InspectionBuffer *buffer, uint8_t *buf, uint32_t buf_len)
Definition: detect-engine.c:1496
suricata-common.h
sigmatch_table
SigTableElmt sigmatch_table[DETECT_TBLSIZE]
Definition: detect-parse.c:76
SigTableElmt_::Transform
void(* Transform)(InspectionBuffer *, void *context)
Definition: detect.h:1216
SCLogError
#define SCLogError(err_code,...)
Macro used to log ERROR messages.
Definition: util-debug.h:255
InspectionBuffer::inspect_len
uint32_t inspect_len
Definition: detect.h:340
InspectionBuffer::inspect
const uint8_t * inspect
Definition: detect.h:338
InspectionBufferSetup
void InspectionBufferSetup(DetectEngineThreadCtx *det_ctx, const int list_id, InspectionBuffer *buffer, const uint8_t *data, const uint32_t data_len)
setup the buffer with our initial data
Definition: detect-engine.c:1449
detect-parse.h
Signature_
Signature container.
Definition: detect.h:539
DetectSignatureAddTransform
int DetectSignatureAddTransform(Signature *s, int transform, void *options)
Definition: detect-parse.c:1468
SIGMATCH_NOOPT
#define SIGMATCH_NOOPT
Definition: detect.h:1420
SCReturnInt
#define SCReturnInt(x)
Definition: util-debug.h:302
DetectTransformMd5Register
void DetectTransformMd5Register(void)
Definition: detect-transform-md5.c:44
InspectionBufferFree
void InspectionBufferFree(InspectionBuffer *buffer)
Definition: detect-engine.c:1467
SigTableElmt_::RegisterTests
void(* RegisterTests)(void)
Definition: detect.h:1227
g_disable_hashing
bool g_disable_hashing
Definition: suricata.c:203