Skip to content

Commit 9aba1ee

Browse files
committed
improve how the scores are described
1 parent 53f2f99 commit 9aba1ee

1 file changed

Lines changed: 7 additions & 8 deletions

File tree

  • crowdsec-docs/unversioned/cti_api/taxonomy

crowdsec-docs/unversioned/cti_api/taxonomy/scores.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,16 @@ sidebar_position: 3
88

99
The scores are indicators of malevolence associated with an IP address, computed over several periods of time : 1 day, 1 week, 1 month and overall.
1010

11-
For a given period, the indicator of malevolence is summarized under the `total` key with a value ranging from **0** (no reports) to **5** (high malevolence).
12-
13-
This value is a summary based on 4 components (see below) also ranging from **0** (Not Applicable/ Missing) to **5** (High), comparing to all the the signals reported by the community.
11+
For a given period, each indicator is provided with a value ranging from **0** (lowest value) to **5** (highest value). The following table describes the indicators in more detail.
1412

1513
| indicator | explaination |
1614
|-----------|--------------|
17-
|Aggressiveness | _What is the intensity of the attack?_ This component measures the number of attacks reported over a period of time. |
18-
|Threat Level | _How serious is the type of threats reported?_ The category of attacks reported by the community defines the danger induced by the attacks. An IP known for crawling and scanning will have a lower threat level than an IP reported for brute-force and exploits. This score ranges from 1 (mainly crawling) to 5 (exploit). 0 is the default for unknown scenarios |
19-
|Trust| _What is the level of confidence in the actors which reported the IP address?_ This component is based on the reputation (age, number of reports) and the diversity (number of IP ranges, AS Numbers) of all the actors reporting the IP. It ranges from **0** (low\_confidence) to **5** (high confidence). |
20-
| Anomaly | _What are the red flags associated with this IP address?_ It analyses the static description of the reported IP address and checks for red flags which can be linked to evidence of malicious activities |
21-
| Total | Aggregation of 4 component calculated on threats reported by the community and described below. |
15+
|Aggressiveness | _What is the intensity of the attack?_ <br /> This component measures the number of attacks reported over a period of time. |
16+
|Threat | _How dangerous are the attacks?_ <br /> This component measures how dangerous an IP is based on the type of attacks we usually see it attempt. An IP known for crawling and scanning will have a lower threat level than an IP reported for brute-force and exploits. This score ranges from 1 (mainly crawling) to 5 (exploit). 0 is the default for unknown scenarios |
17+
|Trust| _What is the level of confidence in the actors which reported the IP address?_ <br /> This component is measures the degree of trust we have in the reports we have about this IP. It is based on the reputation (age, number of reports) and the diversity (number of IP ranges, AS Numbers) of all the actors reporting the IP. |
18+
| Anomaly | _What are the red flags associated with this IP address?_ <br /> This score is based on static properties of the machine behind the IP. For instance a machine publically exposing old and vulnerable software will have a high anomaly score. |
19+
| Total | Aggregation of the 4 components above. |
2220

21+
For a more in-depth explanation on how we compute these scores, refer to our [blog article](https://www.crowdsec.net/blog/crowdsec-cti-scoring-system)
2322

2423
The `ip_range_score` is the score of malevolence associated with an IP range, ranging from *0* (No IP reported) to *5* (massively reported). It is calculated based on the number of IPs belonging to this range that were reported by the community as malicious

0 commit comments

Comments
 (0)