@@ -17,7 +17,10 @@ The Splunk SIEM App is available in Splunkbase. You can download it from [here](
1717
1818- Complete the App setup by providing your API Key
1919
20- ** N.B** : If you wish to change your key at a later date, you can do so on this same page.
20+ ::: info
21+ The batching option cannot be used with free CTI API keys. Batching allows to query up to 100 IPs at a time and is needed for any larger scale enrichments.
22+ :::
23+
2124
2225![ Setup View] ( /img/splunk_siem/splunk_siem_api_key_setup.png )
2326
@@ -26,87 +29,107 @@ The Splunk SIEM App is available in Splunkbase. You can download it from [here](
2629
2730![ Example Output] ( /img/splunk_siem/splunk_siem_example.png )
2831
32+
33+ ## Fields filtering
34+
35+ ` cssmoke ` supports a ` fields ` argument to restrict outputed fields, separated by commas.
36+
37+ ```
38+ cssmoke ipfield="ip" fields="confidence,reputation,cves"
39+ ```
40+
2941![ Example Output (2)] ( /img/splunk_siem/splunk_siem_example_2.png )
3042
43+ ## Multiple IP fields
44+
45+ All output fields have the prefix ` crowdsec_{field}_ ` . For event with multiple IPs (ie. ` ipsrc ` , ` ipdst ` ), the outputs will be in ` crowdsec_ipsrc_reputation ` , ` crowdsec_ipdst_reputation ` etc.
46+
47+ ![ Example Output (3)] ( /img/splunk_siem/splunk_siem_multiple_ips.png )
48+
49+
3150## Enriched Data
3251
3352The following fields are automatically enriched using ** CrowdSec** intelligence:
3453
3554(Please refer to the [ CrowdSec CTI API documentation] ( https://docs.crowdsec.net/u/cti_api/taxonomy/cti_object/ ) for more details on each field.)
3655
56+ ::: info
57+
58+ All output fields are prefixed with ` crowdsec_{field}_ ` .
59+ :::
3760
3861### Reputation & Classification
3962
40- * ` crowdsec_reputation ` : IP reputation
41- * ` crowdsec_confidence ` : Confidence level
42- * ` crowdsec_ip_range_score ` : The malevolence score of the IP range the IP belongs to
43- * ` crowdsec_ip ` : Original IP address
44- * ` crowdsec_ip_range ` : IP range
45- * ` crowdsec_ip_range_24 ` : /24 range of the IP address
46- * ` crowdsec_ip_range_24_reputation ` : Reputation of the range
47- * ` crowdsec_ip_range_24_score ` : Score for the range
48- * ` crowdsec_as_name ` : Autonomous system (AS) name
49- * ` crowdsec_as_num ` : Autonomous system (AS) number
50- * ` crowdsec_false_positives ` : Historical false positives
51- * ` crowdsec_classifications ` : Classifications associated with the IP
63+ * ` reputation ` : IP reputation
64+ * ` confidence ` : Confidence level
65+ * ` ip_range_score ` : The malevolence score of the IP range the IP belongs to
66+ * ` ip ` : Original IP address
67+ * ` ip_range ` : IP range
68+ * ` ip_range_24 ` : /24 range of the IP address
69+ * ` ip_range_24_reputation ` : Reputation of the range
70+ * ` ip_range_24_score ` : Score for the range
71+ * ` as_name ` : Autonomous system (AS) name
72+ * ` as_num ` : Autonomous system (AS) number
73+ * ` false_positives ` : Historical false positives
74+ * ` classifications ` : Classifications associated with the IP
5275
5376### Geolocation
5477
55- * ` crowdsec_country ` : Country
56- * ` crowdsec_city ` : City
57- * ` crowdsec_latitude ` : Latitude
58- * ` crowdsec_longitude ` : Longitude
59- * ` crowdsec_reverse_dns ` : Reverse DNS result
78+ * ` country ` : Country
79+ * ` city ` : City
80+ * ` latitude ` : Latitude
81+ * ` longitude ` : Longitude
82+ * ` reverse_dns ` : Reverse DNS result
6083
6184### Behavioral & Threat Intelligence
6285
63- * ` crowdsec_behaviors ` : A list of the attack categories for which the IP was reported
64- * ` crowdsec_mitre_techniques ` : A list of Mitre techniques associated with the IP
65- * ` crowdsec_cves ` : A list of CVEs for which the IP has been reported for
66- * ` crowdsec_attack_details ` : A more exhaustive list of the scenarios for which a given IP was reported
67- * ` crowdsec_target_countries ` : The top 10 countries targeted by the IP
68- * ` crowdsec_background_noise ` : The level of background noise of an IP address is an indicator of its internet activity intensity
69- * ` crowdsec_background_noise_score ` : CrowdSec intelligence calculated score
70- * ` crowdsec_references ` : A list of the CrowdSec Blockists the IP belongs to
86+ * ` behaviors ` : A list of the attack categories for which the IP was reported
87+ * ` mitre_techniques ` : A list of Mitre techniques associated with the IP
88+ * ` cves ` : A list of CVEs for which the IP has been reported for
89+ * ` attack_details ` : A more exhaustive list of the scenarios for which a given IP was reported
90+ * ` target_countries ` : The top 10 countries targeted by the IP
91+ * ` background_noise ` : The level of background noise of an IP address is an indicator of its internet activity intensity
92+ * ` background_noise_score ` : CrowdSec intelligence calculated score
93+ * ` references ` : A list of the CrowdSec Blockists the IP belongs to
7194
7295### Activity History
7396
74- * ` crowdsec_first_seen ` : Date of the first time this IP was reported
75- * ` crowdsec_last_seen ` : Date of the last time this IP was reported
76- * ` crowdsec_full_age ` : Delta in days between first seen and today
77- * ` crowdsec_days_age ` : Delta in days between first and last seen timestamps
97+ * ` first_seen ` : Date of the first time this IP was reported
98+ * ` last_seen ` : Date of the last time this IP was reported
99+ * ` full_age ` : Delta in days between first seen and today
100+ * ` days_age ` : Delta in days between first and last seen timestamps
78101
79102### Threat Scores Over Time
80103
81104#### Overall
82105
83- * ` crowdsec_overall_aggressiveness `
84- * ` crowdsec_overall_threat `
85- * ` crowdsec_overall_trust `
86- * ` crowdsec_overall_anomaly `
87- * ` crowdsec_overall_total `
106+ * ` overall_aggressiveness `
107+ * ` overall_threat `
108+ * ` overall_trust `
109+ * ` overall_anomaly `
110+ * ` overall_total `
88111
89112#### Last Day
90113
91- * ` crowdsec_last_day_aggressiveness `
92- * ` crowdsec_last_day_threat `
93- * ` crowdsec_last_day_trust `
94- * ` crowdsec_last_day_anomaly `
95- * ` crowdsec_last_day_total `
114+ * ` last_day_aggressiveness `
115+ * ` last_day_threat `
116+ * ` last_day_trust `
117+ * ` last_day_anomaly `
118+ * ` last_day_total `
96119
97120#### Last Week
98121
99- * ` crowdsec_last_week_aggressiveness `
100- * ` crowdsec_last_week_threat `
101- * ` crowdsec_last_week_trust `
102- * ` crowdsec_last_week_anomaly `
103- * ` crowdsec_last_week_total `
122+ * ` last_week_aggressiveness `
123+ * ` last_week_threat `
124+ * ` last_week_trust `
125+ * ` last_week_anomaly `
126+ * ` last_week_total `
104127
105128#### Last Month
106129
107- * ` crowdsec_last_month_aggressiveness `
108- * ` crowdsec_last_month_threat `
109- * ` crowdsec_last_month_trust `
110- * ` crowdsec_last_month_anomaly `
111- * ` crowdsec_last_month_total `
130+ * ` last_month_aggressiveness `
131+ * ` last_month_threat `
132+ * ` last_month_trust `
133+ * ` last_month_anomaly `
134+ * ` last_month_total `
112135
0 commit comments