Skip to content

Commit 6dc5639

Browse files
committed
improve doc, refresh screenshots
1 parent 55a96de commit 6dc5639

File tree

5 files changed

+73
-50
lines changed

5 files changed

+73
-50
lines changed
-189 KB
Loading
4.8 KB
Loading
116 KB
Loading
105 KB
Loading

crowdsec-docs/unversioned/cti_api/api_integration/integration_splunk_siem.md

Lines changed: 73 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -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

3352
The 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

Comments
 (0)