Go to the documentation of this file.
66 #define DEFAULT_LOG_FILENAME "eve.json"
67 #define MODULE_NAME "OutputJSON"
69 #define MAX_JSON_SIZE 2048
71 static void OutputJsonDeInitCtx(
OutputCtx *);
72 static void CreateEveCommunityFlowId(JsonBuilder *js,
const Flow *f,
const uint16_t seed);
73 static int CreateJSONEther(
76 static const char *TRAFFIC_ID_PREFIX =
"traffic/id/";
77 static const char *TRAFFIC_LABEL_PREFIX =
"traffic/label/";
78 static size_t traffic_id_prefix_len = 0;
79 static size_t traffic_label_prefix_len = 0;
87 traffic_id_prefix_len = strlen(TRAFFIC_ID_PREFIX);
88 traffic_label_prefix_len = strlen(TRAFFIC_LABEL_PREFIX);
101 json_t * retval = json_string(val);
103 if (retval == NULL) {
106 for (u = 0; u < strlen(val); u++) {
107 if (isprint(val[u])) {
116 retval = json_string(retbuf);
122 static int64_t sensor_id = -1;
126 jb_set_string_from_bytes(jb,
"filename", ff->
name, ff->
name_len);
129 jb_open_array(jb,
"sid");
130 for (uint32_t i = 0; ff->
sid != NULL && i < ff->
sid_cnt; i++) {
131 jb_append_uint(jb, ff->
sid[i]);
138 jb_set_string(jb,
"magic", (
char *)ff->magic);
145 jb_set_hex(jb,
"md5", (uint8_t *)ff->
md5, (uint32_t)
sizeof(ff->
md5));
148 jb_set_hex(jb,
"sha1", (uint8_t *)ff->
sha1, (uint32_t)
sizeof(ff->
sha1));
163 jb_set_hex(jb,
"sha256", (uint8_t *)ff->
sha256, (uint32_t)
sizeof(ff->
sha256));
178 jb_set_uint(jb,
"start", ff->
start);
179 jb_set_uint(jb,
"end", ff->
end);
181 jb_set_uint(jb,
"tx_id", tx_id);
184 static void EveAddPacketVars(
const Packet *p, JsonBuilder *js_vars)
186 if (p == NULL || p->
pktvar == NULL) {
192 if (pv->
key || pv->
id > 0) {
194 jb_open_array(js_vars,
"pktvars");
197 jb_start_object(js_vars);
199 if (pv->
key != NULL) {
201 uint8_t keybuf[pv->
key_len + 1];
204 uint8_t printable_buf[
len + 1];
207 jb_set_string(js_vars, (
char *)keybuf, (
char *)printable_buf);
211 uint8_t printable_buf[
len + 1];
214 jb_set_string(js_vars, varname, (
char *)printable_buf);
233 static bool SCStringHasPrefix(
const char *s,
const char *prefix)
235 if (strncmp(s, prefix, strlen(prefix)) == 0) {
241 static void EveAddFlowVars(
const Flow *f, JsonBuilder *js_root, JsonBuilder **js_traffic)
243 if (f == NULL || f->
flowvar == NULL) {
246 JsonBuilder *js_flowvars = NULL;
247 JsonBuilder *js_traffic_id = NULL;
248 JsonBuilder *js_traffic_label = NULL;
249 JsonBuilder *js_flowints = NULL;
250 JsonBuilder *js_flowbits = NULL;
259 if (js_flowvars == NULL) {
260 js_flowvars = jb_new_array();
261 if (js_flowvars == NULL)
266 uint8_t printable_buf[
len + 1];
271 jb_start_object(js_flowvars);
272 jb_set_string(js_flowvars, varname, (
char *)printable_buf);
273 jb_close(js_flowvars);
276 if (js_flowvars == NULL) {
277 js_flowvars = jb_new_array();
278 if (js_flowvars == NULL)
282 uint8_t keybuf[fv->
keylen + 1];
287 uint8_t printable_buf[
len + 1];
292 jb_start_object(js_flowvars);
293 jb_set_string(js_flowvars, (
const char *)keybuf, (
char *)printable_buf);
294 jb_close(js_flowvars);
299 if (js_flowints == NULL) {
300 js_flowints = jb_new_object();
301 if (js_flowints == NULL)
313 if (SCStringHasPrefix(varname, TRAFFIC_ID_PREFIX)) {
314 if (js_traffic_id == NULL) {
315 js_traffic_id = jb_new_array();
316 if (
unlikely(js_traffic_id == NULL)) {
320 jb_append_string(js_traffic_id, &varname[traffic_id_prefix_len]);
321 }
else if (SCStringHasPrefix(varname, TRAFFIC_LABEL_PREFIX)) {
322 if (js_traffic_label == NULL) {
323 js_traffic_label = jb_new_array();
324 if (
unlikely(js_traffic_label == NULL)) {
328 jb_append_string(js_traffic_label, &varname[traffic_label_prefix_len]);
330 if (js_flowbits == NULL) {
331 js_flowbits = jb_new_array();
335 jb_append_string(js_flowbits, varname);
342 jb_close(js_flowbits);
343 jb_set_object(js_root,
"flowbits", js_flowbits);
344 jb_free(js_flowbits);
347 jb_close(js_flowints);
348 jb_set_object(js_root,
"flowints", js_flowints);
349 jb_free(js_flowints);
352 jb_close(js_flowvars);
353 jb_set_object(js_root,
"flowvars", js_flowvars);
354 jb_free(js_flowvars);
357 if (js_traffic_id != NULL || js_traffic_label != NULL) {
358 *js_traffic = jb_new_object();
359 if (
likely(*js_traffic != NULL)) {
360 if (js_traffic_id != NULL) {
361 jb_close(js_traffic_id);
362 jb_set_object(*js_traffic,
"id", js_traffic_id);
363 jb_free(js_traffic_id);
365 if (js_traffic_label != NULL) {
366 jb_close(js_traffic_label);
367 jb_set_object(*js_traffic,
"label", js_traffic_label);
368 jb_free(js_traffic_label);
370 jb_close(*js_traffic);
378 JsonBuilder *js_vars = jb_new_object();
381 JsonBuilder *js_traffic = NULL;
382 EveAddFlowVars(f, js_vars, &js_traffic);
383 if (js_traffic != NULL) {
384 jb_set_object(js,
"traffic", js_traffic);
389 EveAddPacketVars(p, js_vars);
392 jb_set_object(js,
"metadata", js_vars);
405 CreateJSONEther(js, p, f, dir);
411 jb_set_uint(js,
"tenant_id", f->
tenant_id);
424 uint32_t max_len = max_length == 0 ?
GET_PKT_LEN(p) : max_length;
427 if (!jb_open_object(js,
"packet_info")) {
430 if (!jb_set_uint(js,
"linktype", p->
datalink)) {
461 char srcip[46] = {0}, dstip[46] = {0};
466 if (PacketIsIPv4(p)) {
468 srcip,
sizeof(srcip));
470 dstip,
sizeof(dstip));
471 }
else if (PacketIsIPv6(p)) {
473 srcip,
sizeof(srcip));
475 dstip,
sizeof(dstip));
486 if (PacketIsIPv4(p)) {
488 srcip,
sizeof(srcip));
490 dstip,
sizeof(dstip));
491 }
else if (PacketIsIPv6(p)) {
493 srcip,
sizeof(srcip));
495 dstip,
sizeof(dstip));
500 if (PacketIsIPv4(p)) {
502 srcip,
sizeof(srcip));
504 dstip,
sizeof(dstip));
505 }
else if (PacketIsIPv6(p)) {
507 srcip,
sizeof(srcip));
509 dstip,
sizeof(dstip));
517 if (PacketIsIPv4(p)) {
519 srcip,
sizeof(srcip));
521 dstip,
sizeof(dstip));
522 }
else if (PacketIsIPv6(p)) {
524 srcip,
sizeof(srcip));
526 dstip,
sizeof(dstip));
531 if (PacketIsIPv4(p)) {
533 srcip,
sizeof(srcip));
535 dstip,
sizeof(dstip));
536 }
else if (PacketIsIPv6(p)) {
538 srcip,
sizeof(srcip));
540 dstip,
sizeof(dstip));
570 snprintf(addr->
proto,
sizeof(addr->
proto),
"%" PRIu32, PacketGetIPProto(p));
574 #define COMMUNITY_ID_BUF_SIZE 64
576 static bool CalculateCommunityFlowIdv4(
const Flow *f,
577 const uint16_t seed,
unsigned char *base64buf)
589 uint32_t
src = f->
src.addr_data32[0];
590 uint32_t
dst = f->
dst.addr_data32[0];
592 if (f->
proto == IPPROTO_ICMP)
596 if (f->
proto == IPPROTO_ICMP)
600 ipv4.seed = htons(seed);
601 if (ntohl(
src) < ntohl(
dst) || (
src ==
dst && sp < dp)) {
612 ipv4.proto = f->
proto;
616 if (SCSha1HashBuffer((
const uint8_t *)&ipv4,
sizeof(ipv4), hash,
sizeof(hash)) == 1) {
619 if (Base64Encode(hash,
sizeof(hash), base64buf+2, &out_len) == SC_BASE64_OK) {
626 static bool CalculateCommunityFlowIdv6(
const Flow *f,
627 const uint16_t seed,
unsigned char *base64buf)
640 if (f->
proto == IPPROTO_ICMPV6)
644 if (f->
proto == IPPROTO_ICMPV6)
648 ipv6.seed = htons(seed);
649 int cmp_r = memcmp(&f->
src, &f->
dst,
sizeof(f->
src));
650 if ((cmp_r < 0) || (cmp_r == 0 && sp < dp)) {
651 memcpy(&ipv6.src, &f->
src.addr_data32, 16);
652 memcpy(&ipv6.dst, &f->
dst.addr_data32, 16);
656 memcpy(&ipv6.src, &f->
dst.addr_data32, 16);
657 memcpy(&ipv6.dst, &f->
src.addr_data32, 16);
661 ipv6.proto = f->
proto;
665 if (SCSha1HashBuffer((
const uint8_t *)&ipv6,
sizeof(ipv6), hash,
sizeof(hash)) == 1) {
668 if (Base64Encode(hash,
sizeof(hash), base64buf+2, &out_len) == SC_BASE64_OK) {
675 static void CreateEveCommunityFlowId(JsonBuilder *js,
const Flow *f,
const uint16_t seed)
679 if (CalculateCommunityFlowIdv4(f, seed, buf)) {
680 jb_set_string(js,
"community_id", (
const char *)buf);
683 if (CalculateCommunityFlowIdv6(f, seed, buf)) {
684 jb_set_string(js,
"community_id", (
const char *)buf);
694 int64_t flow_id = FlowGetId(f);
695 jb_set_uint(js,
"flow_id", flow_id);
697 jb_set_uint(js,
"parent_id", f->
parent_id);
704 (void) snprintf(eth_addr, 19,
"%02x:%02x:%02x:%02x:%02x:%02x",
705 val[0], val[1], val[2], val[3], val[4], val[5]);
707 jb_append_string(js, eth_addr);
709 jb_set_string(js, key, eth_addr);
718 static int MacSetIterateToJSON(uint8_t *val,
MacSetSide side,
void *data)
729 static int CreateJSONEther(
734 if (PacketIsEthernet(p)) {
735 const EthernetHdr *ethh = PacketGetEthernet(p);
736 jb_open_object(js,
"ether");
770 }
else if (f != NULL) {
775 jb_open_object(js,
"ether");
777 info.
dst = jb_new_array();
778 info.
src = jb_new_array();
791 jb_set_object(js,
"dest_macs", info.
src);
792 jb_set_object(js,
"src_macs", info.
dst);
795 jb_set_object(js,
"dest_macs", info.
dst);
796 jb_set_object(js,
"src_macs", info.
src);
812 JsonBuilder *js = jb_new_object();
819 jb_set_string(js,
"timestamp", timebuf);
824 if (sensor_id >= 0) {
825 jb_set_uint(js,
"sensor_id", sensor_id);
830 jb_set_string(js,
"in_iface", p->
livedev->
dev);
835 jb_set_uint(js,
"pcap_cnt", p->
pcap_cnt);
839 jb_set_string(js,
"event_type", event_type);
844 jb_open_array(js,
"vlan");
845 jb_append_uint(js, p->
vlan_id[0]);
847 jb_append_uint(js, p->
vlan_id[1]);
850 jb_append_uint(js, p->
vlan_id[2]);
861 if (addr->
src_ip[0] !=
'\0') {
862 jb_set_string(js,
"src_ip", addr->
src_ip);
865 jb_set_uint(js,
"src_port", addr->
sp);
867 if (addr->
dst_ip[0] !=
'\0') {
868 jb_set_string(js,
"dest_ip", addr->
dst_ip);
871 jb_set_uint(js,
"dest_port", addr->
dp);
873 if (addr->
proto[0] !=
'\0') {
874 jb_set_string(js,
"proto", addr->
proto);
880 if (PacketIsICMPv4(p)) {
881 jb_set_uint(js,
"icmp_type", p->
icmp_s.type);
882 jb_set_uint(js,
"icmp_code", p->
icmp_s.code);
886 if (PacketIsICMPv6(p)) {
887 jb_set_uint(js,
"icmp_type", PacketGetICMPv6(p)->
type);
888 jb_set_uint(js,
"icmp_code", PacketGetICMPv6(p)->code);
895 if (eve_ctx != NULL) {
910 jb_set_uint(js,
"tx_id", tx_id);
932 json_object_set_new(js,
"host",
975 MemBufferReset(*buffer);
981 size_t jslen = jb_len(js);
993 static inline enum LogFileType FileTypeFromConf(
const char *typestr)
997 if (typestr == NULL) {
999 }
else if (strcmp(typestr,
"file") == 0 || strcmp(typestr,
"regular") == 0) {
1001 }
else if (strcmp(typestr,
"unix_dgram") == 0) {
1003 }
else if (strcmp(typestr,
"unix_stream") == 0) {
1005 }
else if (strcmp(typestr,
"redis") == 0) {
1006 #ifdef HAVE_LIBHIREDIS
1009 FatalError(
"redis JSON output option is not compiled");
1012 SCLogDebug(
"type %s, file type value %d", typestr, log_filetype);
1013 return log_filetype;
1016 static int LogFileTypePrepare(
1027 #ifdef HAVE_LIBHIREDIS
1032 char hostname[1024];
1033 gethostname(hostname, 1023);
1040 if (SCConfLogOpenRedis(redis_node, json_ctx->
file_ctx) < 0) {
1080 SCLogDebug(
"could not create new OutputJsonCtx");
1087 if (sensor_name != NULL) {
1088 SCLogWarning(
"Found deprecated eve-log setting \"sensor-name\". "
1089 "Please set sensor-name globally.");
1092 (void)
ConfGet(
"sensor-name", &sensor_name);
1097 SCLogDebug(
"AlertJsonInitCtx: Could not create new LogFileCtx");
1111 if (
unlikely(output_ctx == NULL)) {
1115 output_ctx->
data = json_ctx;
1116 output_ctx->
DeInit = OutputJsonDeInitCtx;
1121 if (output_s == NULL) {
1125 enum LogFileType log_filetype = FileTypeFromConf(output_s);
1128 if (filetype != NULL) {
1132 FatalError(
"Invalid JSON output option: %s", output_s);
1138 SCLogInfo(
"Using prefix '%s' for JSON messages", prefix);
1142 FatalError(
"Failed to allocate memory for eve-log.prefix setting.");
1155 if (LogFileTypePrepare(json_ctx, log_filetype, conf) < 0) {
1160 if (sensor_id_s != NULL) {
1162 FatalError(
"Failed to initialize JSON output, "
1163 "invalid sensor-id: %s",
1180 SCLogConfig(
"Enabling Ethernet MAC address logging.");
1189 SCLogConfig(
"Enabling eve community_id logging.");
1195 if (cid_seed != NULL) {
1197 10, 0, cid_seed) < 0)
1199 FatalError(
"Failed to initialize JSON output, "
1200 "invalid community-id-seed: %s",
1222 SCLogDebug(
"returning output_ctx %p", output_ctx);
1224 result.
ctx = output_ctx;
1243 static void OutputJsonDeInitCtx(
OutputCtx *output_ctx)
1247 if (logfile_ctx->dropped) {
1248 SCLogWarning(
"%" PRIu64
" events were dropped due to slow or "
1249 "disconnected socket",
1250 logfile_ctx->dropped);
1252 if (json_ctx->
xff_cfg != NULL) {
#define PKT_IS_TOCLIENT(p)
void JSONFormatAndAddMACAddr(JsonBuilder *js, const char *key, const uint8_t *val, bool is_array)
union FlowVar_::@109 data
int SCRunmodeGet(void)
Get the current run mode.
void EvePacket(const Packet *p, JsonBuilder *js, uint32_t max_length)
Jsonify a packet.
void CreateIsoTimeString(const SCTime_t ts, char *str, size_t size)
OutputJsonCommonSettings cfg
LogFileCtx * LogFileNewCtx(void)
LogFileNewCtx() Get a new LogFileCtx.
int MemBufferExpand(MemBuffer **buffer, uint32_t expand_by)
expand membuffer by size of 'expand_by'
#define JSON_OUTPUT_BUFFER_SIZE
int StringParseUint16(uint16_t *res, int base, size_t len, const char *str)
bool SCProtoNameValid(uint16_t proto)
Function to check if the received protocol number is valid and do we have corresponding name entry fo...
const JsonAddrInfo json_addr_info_zero
#define COMMUNITY_ID_BUF_SIZE
bool include_community_id
void EveFileInfo(JsonBuilder *jb, const File *ff, const uint64_t tx_id, const uint16_t flags)
struct Flow_::@116::@122 icmp_d
const char * known_proto[256]
struct Packet_::@29::@36 icmp_s
struct JSONMACAddrInfo JSONMACAddrInfo
uint8_t sha1[SC_SHA1_LEN]
struct Flow_::@114::@120 icmp_s
#define GET_IPV6_DST_ADDR(p)
json_t * SCJsonString(const char *val)
int ConfValIsTrue(const char *val)
Check if a value is true.
void PrintStringsToBuffer(uint8_t *dst_buf, uint32_t *dst_buf_offset_ptr, uint32_t dst_buf_size, const uint8_t *src_buf, const uint32_t src_buf_len)
void OutputJsonRegister(void)
int SCConfLogOpenGeneric(ConfNode *conf, LogFileCtx *log_ctx, const char *default_filename, int rotate)
open a generic output "log file", which may be a regular file or a socket
size_t strlcpy(char *dst, const char *src, size_t siz)
enum @18 __attribute__
DNP3 application header.
void OutputRegisterFileRotationFlag(int *flag)
Register a flag for file rotation notification.
void EveAddMetadata(const Packet *p, const Flow *f, JsonBuilder *js)
int ConfGet(const char *name, const char **vptr)
Retrieve the value of a configuration node.
int LogFileWrite(LogFileCtx *file_ctx, MemBuffer *buffer)
#define JB_SET_STRING(jb, key, val)
struct GenericVar_ * next
#define GET_IPV4_DST_ADDR_PTR(p)
#define PKT_IS_TOSERVER(p)
#define DEFAULT_LOG_FILENAME
void OutputRegisterModule(const char *, const char *, OutputInitFunc)
JsonBuilder * CreateEveHeader(const Packet *p, enum OutputJsonLogDirection dir, const char *event_type, JsonAddrInfo *addr, OutputJsonCtx *eve_ctx)
Per thread variable structure.
const char * PrintInet(int af, const void *src, char *dst, socklen_t size)
void EveAddCommonOptions(const OutputJsonCommonSettings *cfg, const Packet *p, const Flow *f, JsonBuilder *js, enum OutputJsonLogDirection dir)
uint64_t FileTrackedSize(const File *file)
get the size of the file
void EveTcpFlags(const uint8_t flags, JsonBuilder *js)
jsonify tcp flags field Only add 'true' fields in an attempt to keep things reasonably compact.
const char * PktSrcToString(enum PktSrcEnum pkt_src)
#define JB_SET_TRUE(jb, key)
#define SCLogWarning(...)
Macro used to log WARNING messages.
void SyslogInitialize(void)
JsonBuilder * CreateEveHeaderWithTxId(const Packet *p, enum OutputJsonLogDirection dir, const char *event_type, JsonAddrInfo *addr, uint64_t tx_id, OutputJsonCtx *eve_ctx)
void NullLogInitialize(void)
void SCEveRunCallbacks(ThreadVars *tv, const Packet *p, Flow *f, JsonBuilder *jb)
struct LiveDevice_ * livedev
@ LOGFILE_TYPE_UNIX_DGRAM
FlowStorageId MacSetGetFlowStorageID(void)
bool SCLogOpenThreadedFile(const char *log_path, const char *append, LogFileCtx *parent_ctx)
@ LOGFILE_TYPE_UNIX_STREAM
#define SCLogInfo(...)
Macro used to log INFORMATIONAL messages.
void * FlowGetStorageById(const Flow *f, FlowStorageId id)
char proto[JSON_PROTO_LEN]
ConfNode * ConfNodeLookupChild(const ConfNode *node, const char *name)
Lookup a child configuration node by name.
OutputInitResult OutputJsonInitCtx(ConfNode *conf)
Create a new LogFileCtx for "fast" output style.
int StringParseUint64(uint64_t *res, int base, size_t len, const char *str)
#define GET_IPV4_SRC_ADDR_PTR(p)
#define PrintBufferData(buf, buf_offset_ptr, buf_size,...)
void(* DeInit)(struct OutputCtx_ *)
const char * VarNameStoreLookupById(const uint32_t id, const enum VarTypes type)
find name for id+type at packet time.
int MacSetSize(const MacSet *ms)
int OutputJsonBuilderBuffer(ThreadVars *tv, const Packet *p, Flow *f, JsonBuilder *js, OutputJsonThreadCtx *ctx)
int LogFileFreeCtx(LogFileCtx *lf_ctx)
LogFileFreeCtx() Destroy a LogFileCtx (Close the file and free memory)
uint8_t sha256[SC_SHA256_LEN]
#define JB_SET_FALSE(jb, key)
void CreateEveFlowId(JsonBuilder *js, const Flow *f)
struct SCLogConfig_ SCLogConfig
Holds the config state used by the logging api.
char src_ip[JSON_ADDR_LEN]
#define GET_IPV6_SRC_ADDR(p)
#define MEMBUFFER_SIZE(mem_buffer)
Get the MemBuffers current size.
int ConfValIsFalse(const char *val)
Check if a value is false.
int MacSetForEach(const MacSet *ms, MacSetIteratorFunc IterFunc, void *data)
char dst_ip[JSON_ADDR_LEN]
const char * PcapFileGetFilename(void)
int OutputJSONMemBufferCallback(const char *str, size_t size, void *data)
int OutputJSONBuffer(json_t *js, LogFileCtx *file_ctx, MemBuffer **buffer)
uint32_t MemBufferWriteRaw(MemBuffer *dst, const uint8_t *raw, const uint32_t raw_len)
Write a raw buffer to the MemBuffer dst.
SCEveFileType * SCEveFindFileType(const char *name)
void JsonAddrInfoInit(const Packet *p, enum OutputJsonLogDirection dir, JsonAddrInfo *addr)
void HttpXFFGetCfg(ConfNode *conf, HttpXFFCfg *result)
Function to return XFF configuration from a configuration node.
uint16_t vlan_id[VLAN_MAX_LAYERS]
int(* Init)(const ConfNode *conf, const bool threaded, void **init_data)
Function to initialize this filetype.
int(* ThreadInit)(const void *init_data, const ThreadId thread_id, void **thread_data)
Initialize thread specific data.
uint16_t community_id_seed
#define MEMBUFFER_OFFSET(mem_buffer)
Get the MemBuffers current offset.
#define DEBUG_VALIDATE_BUG_ON(exp)
Structure used to define an EVE output file type plugin.
const char * ConfNodeLookupChildValue(const ConfNode *node, const char *name)
Lookup the value of a child configuration node by name.