Update CTI documentation

crowdsecurity · Oct 17, 2023 · 93b8aa5 · 93b8aa5
1 parent f9c8610
commit 93b8aa5
Show file tree

Hide file tree

Showing 8 changed files with 324 additions and 81 deletions.
diff --git a/crowdsec-docs/docs/cti_api/getting_started.mdx b/crowdsec-docs/docs/cti_api/getting_started.mdx
@@ -26,113 +26,146 @@ And the default output looks something like this:
 ```json
 {
   "ip_range_score": 5,
-  "ip": "185.7.214.104",
-  "ip_range": "185.7.214.0/24",
-  "as_name": "Chang Way Technologies Co. Limited",
-  "as_num": 57523,
+  "ip": "[CENSURED]",
+  "ip_range": "[CENSURED]",
+  "as_name": "[CENSURED]",
+  "as_num": [CENSURED],
   "location": {
-    "country": "RU",
-    "city": null,
-    "latitude": 55.7386,
-    "longitude": 37.6068
+    "country": "FR",
+    "city": "",
+    "latitude": 0.0,
+    "longitude": 0.0
   },
-  "reverse_dns": null,
+  "reverse_dns": "[CENSURED]",
   "behaviors": [
+    {
+      "name": "http:scan",
+      "label": "HTTP Scan",
+      "description": "IP has been reported for performing actions related to HTTP vulnerability scanning and discovery."
+    },
+    {
+      "name": "ssh:bruteforce",
+      "label": "SSH Bruteforce",
+      "description": "IP has been reported for performing brute force on ssh services."
+    },
     {
       "name": "http:exploit",
       "label": "HTTP Exploit",
       "description": "IP has been reported for attempting to exploit a vulnerability in a web application."
     },
     {
-      "name": "http:scan",
-      "label": "HTTP Scan",
-      "description": "IP has been reported for performing actions related to HTTP vulnerability scanning and discovery."
+      "name": "generic:exploit",
+      "label": "Exploitation attempt",
+      "description": "IP has been reported trying to exploit known vulnerability/CVE on unspecified protocols."
     }
   ],
   "history": {
-    "first_seen": "2022-06-14T21:30:00+00:00",
-    "last_seen": "2022-07-22T11:45:00+00:00",
-    "full_age": 39,
-    "days_age": 38
+    "first_seen": "2022-05-28T16:00:00+00:00",
+    "last_seen": "2023-10-15T05:45:00+00:00",
+    "full_age": 507,
+    "days_age": 505
   },
   "classifications": {
     "false_positives": [],
-    "classifications": [
-      {
-        "name": "community-blocklist",
-        "label": "CrowdSec Community Blocklist",
-        "description": "IP belong to the CrowdSec Community Blocklist"
-      }
-    ]
+    "classifications": []
   },
   "attack_details": [
     {
-      "name": "crowdsecurity/http-cve-2021-41773",
-      "label": "Apache CVE-2021-41773",
-      "description": "Detect Apache CVE-2021-41773 exploitation attemtps",
-      "references": [
-        "https://nvd.nist.gov/vuln/detail/CVE-2021-41773"
-      ]
+      "name": "crowdsecurity/http-probing",
+      "label": "HTTP Probing",
+      "description": "Detect site scanning/probing from a single ip",
+      "references": []
     },
     {
-      "name": "crowdsecurity/thinkphp-cve-2018-20062",
-      "label": "ThinkPHP CVE-2018-20062",
-      "description": "Detect ThinkPHP CVE-2018-20062 exploitation attemps",
+      "name": "crowdsecurity/ssh-bf",
+      "label": "SSH Bruteforce",
+      "description": "Detect ssh bruteforce",
       "references": []
     },
     {
-      "name": "crowdsecurity/modsecurity",
-      "label": "ModSecurity CRS",
-      "description": "Detect web exploitation via modsecurity",
+      "name": "crowdsecurity/ssh-slow-bf",
+      "label": "SSH Bruteforce",
+      "description": "Detect slow ssh bruteforce",
       "references": []
     },
     {
-      "name": "crowdsecurity/http-probing",
-      "label": "HTTP Scanner",
-      "description": "Detect site scanning/probing from a single ip",
+      "name": "crowdsecurity/http-bad-user-agent",
+      "label": "detection of bad user-agents",
+      "description": "Detect bad user-agents",
+      "references": []
+    },
+    {
+      "name": "crowdsecurity/suricata-major-severity",
+      "label": "Suricata Severity 1 Event",
+      "description": "Detect exploit attempts via emerging threat rules",
+      "references": []
+    },
+    {
+      "name": "crowdsecurity/modsecurity",
+      "label": "Modsecurity Alert",
+      "description": "Web exploitation via modsecurity",
       "references": []
     }
   ],
   "target_countries": {
-    "FR": 35,
-    "US": 19,
-    "DE": 18,
-    "NL": 6,
-    "GB": 5,
-    "CA": 4,
+    "AT": 0,
     "AU": 2,
-    "RU": 2,
-    "SE": 2,
-    "CH": 1
+    "BR": 0,
+    "CA": 4,
+    "CH": 0,
+    "CN": 0,
+    "DE": 79,
+    "DK": 0,
+    "ES": 0,
+    "FI": 12
   },
+  "background_noise_score": 10,
+  "mitre_techniques": [
+    {
+      "name": "T1595",
+      "label": "Active Scanning",
+      "description": "Adversaries may execute active reconnaissance scans to gather information that can be used during targeting. Active scans are those where the adversary probes victim infrastructure via network traffic, as opposed to other forms of reconnaissance that do not involve direct interaction.\n\nAdversaries may perform different forms of active scanning depending on what information they seek to gather. These scans can also be performed in various ways, including using native features of network protocols such as ICMP.(Citation: Botnet Scan)(Citation: OWASP Fingerprinting) Information from these scans may reveal opportunities for other forms of reconnaissance (ex: [Search Open Websites/Domains](https://attack.mitre.org/techniques/T1593) or [Search Open Technical Databases](https://attack.mitre.org/techniques/T1596)), establishing operational resources (ex: [Develop Capabilities](https://attack.mitre.org/techniques/T1587) or [Obtain Capabilities](https://attack.mitre.org/techniques/T1588)), and/or initial access (ex: [External Remote Services](https://attack.mitre.org/techniques/T1133) or [Exploit Public-Facing Application](https://attack.mitre.org/techniques/T1190))."
+    },
+    {
+      "name": "T1110",
+      "label": "Brute Force",
+      "description": "Adversaries may use brute force techniques to gain access to accounts when passwords are unknown or when password hashes are obtained. Without knowledge of the password for an account or set of accounts, an adversary may systematically guess the password using a repetitive or iterative mechanism. Brute forcing passwords can take place via interaction with a service that will check the validity of those credentials or offline against previously acquired credential data, such as password hashes.\n\nBrute forcing credentials may take place at various points during a breach. For example, adversaries may attempt to brute force access to [Valid Accounts](https://attack.mitre.org/techniques/T1078) within a victim environment leveraging knowledge gathered from other post-compromise behaviors such as [OS Credential Dumping](https://attack.mitre.org/techniques/T1003), [Account Discovery](https://attack.mitre.org/techniques/T1087), or [Password Policy Discovery](https://attack.mitre.org/techniques/T1201). Adversaries may also combine brute forcing activity with behaviors such as [External Remote Services](https://attack.mitre.org/techniques/T1133) as part of Initial Access."
+    },
+    {
+      "name": "T1190",
+      "label": "Exploit Public-Facing Application",
+      "description": "Adversaries may attempt to exploit a weakness in an Internet-facing host or system to initially access a network. The weakness in the system can be a software bug, a temporary glitch, or a misconfiguration.\n\nExploited applications are often websites/web servers, but can also include databases (like SQL), standard services (like SMB or SSH), network device administration and management protocols (like SNMP and Smart Install), and any other system with Internet accessible open sockets.(Citation: NVD CVE-2016-6662)(Citation: CIS Multiple SMB Vulnerabilities)(Citation: US-CERT TA18-106A Network Infrastructure Devices 2018)(Citation: Cisco Blog Legacy Device Attacks)(Citation: NVD CVE-2014-7169) Depending on the flaw being exploited this may also involve [Exploitation for Defense Evasion](https://attack.mitre.org/techniques/T1211). \n\nIf an application is hosted on cloud-based infrastructure and/or is containerized, then exploiting it may lead to compromise of the underlying instance or container. This can allow an adversary a path to access the cloud or container APIs, exploit container host access via [Escape to Host](https://attack.mitre.org/techniques/T1611), or take advantage of weak identity and access management policies.\n\nAdversaries may also exploit edge network infrastructure and related appliances, specifically targeting devices that do not support robust host-based defenses.(Citation: Mandiant Fortinet Zero Day)(Citation: Wired Russia Cyberwar)\n\nFor websites and databases, the OWASP top 10 and CWE top 25 highlight the most common web-based vulnerabilities.(Citation: OWASP Top 10)(Citation: CWE top 25)"
+    }
+  ],
+  "cves": [],
   "scores": {
     "overall": {
       "aggressiveness": 5,
-      "threat": 5,
-      "trust": 5,
-      "anomaly": 1,
-      "total": 5
+      "threat": 2,
+      "trust": 4,
+      "anomaly": 0,
+      "total": 4
     },
     "last_day": {
-      "aggressiveness": 5,
-      "threat": 5,
-      "trust": 5,
-      "anomaly": 1,
-      "total": 5
+      "aggressiveness": 0,
+      "threat": 0,
+      "trust": 0,
+      "anomaly": 0,
+      "total": 0
     },
     "last_week": {
       "aggressiveness": 5,
-      "threat": 5,
-      "trust": 5,
-      "anomaly": 1,
-      "total": 5
+      "threat": 2,
+      "trust": 4,
+      "anomaly": 0,
+      "total": 4
     },
     "last_month": {
       "aggressiveness": 5,
-      "threat": 5,
-      "trust": 5,
-      "anomaly": 1,
-      "total": 5
+      "threat": 2,
+      "trust": 4,
+      "anomaly": 0,
+      "total": 4
     }
   },
   "references": []

diff --git a/crowdsec-docs/docs/cti_api/taxonomy/behaviors.mdx b/crowdsec-docs/docs/cti_api/taxonomy/behaviors.mdx
@@ -1,6 +1,6 @@
 ---
 id: behaviors
-title: Behaviors Taxonomy
+title: Behaviors
 sidebar_position: 6
 ---
 

diff --git a/crowdsec-docs/docs/cti_api/taxonomy/classifications.mdx b/crowdsec-docs/docs/cti_api/taxonomy/classifications.mdx
@@ -1,6 +1,6 @@
 ---
 id: classifications
-title: Classifications Taxonomy
+title: Classifications
 sidebar_position: 5
 ---