suricata
output-json-metadata.c
Go to the documentation of this file.
1 /* Copyright (C) 2013-2021 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  * Logs vars in JSON format.
24  *
25  */
26 
27 #include "suricata-common.h"
28 #include "detect.h"
29 #include "flow.h"
30 #include "conf.h"
31 
32 #include "threads.h"
33 #include "tm-threads.h"
34 #include "threadvars.h"
35 #include "util-debug.h"
36 
37 #include "util-misc.h"
38 #include "util-unittest-helper.h"
39 
40 #include "detect-parse.h"
41 #include "detect-engine.h"
42 #include "detect-engine-mpm.h"
43 #include "detect-reference.h"
44 #include "app-layer-parser.h"
45 #include "app-layer-dnp3.h"
46 #include "app-layer-htp.h"
47 #include "app-layer-htp-xff.h"
49 #include "util-syslog.h"
50 #include "util-logopenfile.h"
51 
52 #include "output.h"
53 #include "output-json.h"
54 #include "output-json-metadata.h"
55 
56 #include "util-byte.h"
57 #include "util-privs.h"
58 #include "util-print.h"
59 #include "util-proto-name.h"
60 #include "util-buffer.h"
61 
62 #define MODULE_NAME "JsonMetadataLog"
63 
64 static int MetadataJson(ThreadVars *tv, OutputJsonThreadCtx *aft, const Packet *p)
65 {
66  SCJsonBuilder *js = CreateEveHeader(p, LOG_DIR_PACKET, "metadata", NULL, aft->ctx);
67  if (unlikely(js == NULL))
68  return TM_ECODE_OK;
69 
70  /* If metadata is not enabled for eve, explicitly log it here as this is
71  * what logging metadata is about. */
72  if (!aft->ctx->cfg.include_metadata) {
73  EveAddMetadata(p, p->flow, js);
74  }
75  OutputJsonBuilderBuffer(tv, p, p->flow, js, aft);
76 
77  SCJbFree(js);
78  return TM_ECODE_OK;
79 }
80 
81 static int JsonMetadataLogger(ThreadVars *tv, void *thread_data, const Packet *p)
82 {
83  OutputJsonThreadCtx *aft = thread_data;
84 
85  return MetadataJson(tv, aft, p);
86 }
87 
88 static bool JsonMetadataLogCondition(ThreadVars *tv, void *data, const Packet *p)
89 {
90  return p->pktvar != NULL;
91 }
92 
94 {
95  OutputPacketLoggerFunctions output_logger_functions = {
96  .LogFunc = JsonMetadataLogger,
97  .ConditionFunc = JsonMetadataLogCondition,
98  .ThreadInitFunc = JsonLogThreadInit,
99  .ThreadDeinitFunc = JsonLogThreadDeinit,
100  .ThreadExitPrintStatsFunc = NULL,
101  };
102 
103  OutputRegisterPacketSubModule(LOGGER_JSON_METADATA, "eve-log", MODULE_NAME, "eve-log.metadata",
104  OutputJsonLogInitSub, &output_logger_functions);
105 
106  /* Kept for compatibility. */
108  OutputJsonLogInitSub, &output_logger_functions);
109 }
SCJsonBuilder
struct SCJsonBuilder SCJsonBuilder
Definition: detect-engine-helper.h:83
util-byte.h
tm-threads.h
detect-engine.h
OutputJsonThreadCtx_::ctx
OutputJsonCtx * ctx
Definition: output-json.h:86
OutputJsonCtx_::cfg
OutputJsonCommonSettings cfg
Definition: output-json.h:80
unlikely
#define unlikely(expr)
Definition: util-optimize.h:35
CreateEveHeader
SCJsonBuilder * CreateEveHeader(const Packet *p, enum SCOutputJsonLogDirection dir, const char *event_type, JsonAddrInfo *addr, OutputJsonCtx *eve_ctx)
Definition: output-json.c:816
JsonLogThreadInit
TmEcode JsonLogThreadInit(ThreadVars *t, const void *initdata, void **data)
Definition: output-json-common.c:90
threads.h
util-syslog.h
util-privs.h
p
Packet * p
Definition: fuzz_dataset.c:30
OutputJsonBuilderBuffer
void OutputJsonBuilderBuffer(ThreadVars *tv, const Packet *p, Flow *f, SCJsonBuilder *js, OutputJsonThreadCtx *ctx)
Definition: output-json.c:1018
util-unittest-helper.h
TM_ECODE_OK
@ TM_ECODE_OK
Definition: tm-threads-common.h:81
app-layer-htp-xff.h
OutputJsonThreadCtx_
Definition: output-json.h:85
detect-reference.h
OutputJsonLogInitSub
OutputInitResult OutputJsonLogInitSub(SCConfNode *conf, OutputCtx *parent_ctx)
Definition: output-json-common.c:73
app-layer-htp.h
util-debug.h
Packet_::pktvar
PktVar * pktvar
Definition: decode.h:612
app-layer-dnp3.h
output-json.h
util-print.h
detect-engine-mpm.h
detect.h
ThreadVars_
Per thread variable structure.
Definition: threadvars.h:57
app-layer-parser.h
MODULE_NAME
#define MODULE_NAME
Definition: output-json-metadata.c:62
Packet_
Definition: decode.h:516
conf.h
util-proto-name.h
EveAddMetadata
void EveAddMetadata(const Packet *p, const Flow *f, SCJsonBuilder *js)
Definition: output-json.c:369
OutputJsonCommonSettings_::include_metadata
bool include_metadata
Definition: output-json.h:63
Packet_::flow
struct Flow_ * flow
Definition: decode.h:564
LOGGER_JSON_METADATA
@ LOGGER_JSON_METADATA
Definition: suricata-common.h:512
suricata-common.h
OutputPacketLoggerFunctions_::LogFunc
PacketLogger LogFunc
Definition: output.h:87
util-classification-config.h
OutputRegisterPacketSubModule
void OutputRegisterPacketSubModule(LoggerId id, const char *parent_name, const char *name, const char *conf_name, OutputInitSubFunc InitFunc, OutputPacketLoggerFunctions *output_logger_functions)
Register a packet output sub-module.
Definition: output.c:230
tv
ThreadVars * tv
Definition: fuzz_decodepcapfile.c:34
JsonMetadataLogRegister
void JsonMetadataLogRegister(void)
Definition: output-json-metadata.c:93
threadvars.h
output-json-metadata.h
util-logopenfile.h
detect-parse.h
util-buffer.h
LOG_DIR_PACKET
@ LOG_DIR_PACKET
Definition: output-eve-bindgen.h:34
JsonLogThreadDeinit
TmEcode JsonLogThreadDeinit(ThreadVars *t, void *data)
Definition: output-json-common.c:123
util-misc.h
flow.h
OutputPacketLoggerFunctions_
Definition: output.h:86
output.h