Skip to content

Commit 3042135

Browse files
author
jdv
committed
concepts page updates
1 parent 654942c commit 3042135

File tree

1 file changed

+20
-17
lines changed

1 file changed

+20
-17
lines changed

crowdsec-docs/docs/concepts.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,27 @@ sidebar_position: 1
77

88
# Global overview
99

10+
# Security Engine
11+
12+
> The Security Engine is CrowdSec's IDS/IPS (Intrusion Detection System/Intrusion Prevention System)
13+
> It is a rules and behavior detection engine comprised of Log Processor and the Local API.
14+
15+
A Security Engine can operate [independently](/intro#architecture) or in a [distributed manner](/intro#deployment-options), adapting to the specific needs and constraints of your infrastructure. For more information on CrowdSec's distributed approach, visit our documentation on collaborative operations and distributed deployments.
16+
17+
1018
# Log Processor (LP)
1119

12-
> The Log Processor is in charge of the detection of bad behaviors, based on your logs or your HTTP trafic.
20+
> The Log Processor is the part of the Security Engine in charge of the detection of bad behaviors, based on your logs or your HTTP trafic.
1321
1422
The Log Processor (abreviated as `LP`) detects bad behaviors via two main functions:
1523
- [Acquire](/log_processor/data_sources/introduction.md) logs, [parse](/log_processor/parsers/introduction.mdx), [enrich](/log_processor/parsers/enricher.md) and match them against [Scenarios](/log_processor/scenarios/introduction.mdx).
16-
- Receive [HTTP Requests](/log_processor/data_sources/appsc.md) and match them against the [Appsec Rules](/appsec/intro.md).
24+
- Receive [HTTP Requests](/log_processor/data_sources/appsec.md) and match them against the [Appsec Rules](/appsec/intro.md).
1725

1826
Alerts resulting from Scenarios or Appsec Rules being triggered are sent to the `LAPI`.
1927

2028
# Local API (LAPI)
2129

22-
> The Local API is the middleman between the Log Processors, the Remediation Components and the Central API.
30+
> The Local API is the part of the Security Engine acting as the middleman between the Log Processors, the Remediation Components and the Central API.
2331
2432
The Local API (abreviated as `LAPI`) has several functions:
2533
- Receive alerts from Log Processors and create Decisions based on configured [Profiles](/local_api/profiles/intro.md)
@@ -29,33 +37,28 @@ The Local API (abreviated as `LAPI`) has several functions:
2937

3038
# Remediation Components (Bouncers)
3139

32-
> The Remediation Components (also called `Bouncers`) are in charge of enforcing decisions.
40+
> The Remediation Components (also called `Bouncers`) are external components in charge of enforcing decisions.
3341
34-
Remediation Components rely on the Local API to receive decisions about malevolent IPs to be blocked.
42+
Remediation Components rely on the Local API to receive decisions about malevolent IPs to be blocked *(or other supported types or remediations such as Captcha, supported by some of our Bouncers).*
43+
*Note that they also support [CrowdSec's Blocklist as a Service](/u/integrations/intro).*
3544

3645
Those Decisions can be based on behavioral detection made by the `LP` or from Blocklists.
3746

38-
[Remediations components](https://app.crowdsec.net/hub/remediation-components) laverage existing components of your infrastructure to block malevolent IPs where it matters most.
47+
Remediations components leverage existing components of your infrastructure to block malevolent IPs where it matters most. You can find them on our [Remediation Components' HUB](https://app.crowdsec.net/hub/remediation-components)
3948

4049
# Central API (CAPI)
4150

42-
> The Central API (CAPI) in CrowdSec serves as a pivotal component for aggregating and disseminating threat intelligence across its user community.
51+
> The Central API (CAPI) serves as the gateway for network participants to connect and communicate with CrowdSec's network.
4352
44-
45-
The Central API (abreviated as `CAPI`) receives signal from Crowdsec instances and partner networks and will compute them to ultimately create [Cyber Threat Intelligence](/u/cti_api/intro) and [Blocklists](/u/blocklists/intro).
53+
The Central API (abreviated as `CAPI`) receives attack signals from all participating Security Engines and signal partners, then re-distribute them curated community decisions ([Community Blocklist](/central_api/community_blocklist/)).
54+
It's also at the heart of CrowdSec centralized [Blocklist services](/u/blocklists/intro).
4655

4756
# Console
4857

49-
> The CrowdSec Console is a web-based interface that enhances the functionality of the CrowdSec security engine.
58+
> The CrowdSec Console is a web-based interface providing reporting, alerting, management and QoL features to CrowdSec's products usages: from your park of Security Engines to the management of CTI related actions
5059
5160
The [Console](https://app.crowdsec.net) allows you to:
5261
- [Manage alerts](/u/console/alerts/intro) of your security stack
5362
- [Manage decisions](/u/console/decisions/decisions_intro) in real-time
5463
- View and use [blocklists and integrations](/u/blocklists/intro)
55-
- Manage your API keys ([CTI API](/u/cti_api/intro), [Service API](/u/service_api/getting_started))
56-
57-
# Security Engine
58-
59-
> The Security Engine is a concept that encompasses the Log Processor and the Local API.
60-
61-
The Security Engine is the generic term to describe a Log Processor coupled to a Local API.
64+
- Manage your API keys ([CTI API](/u/cti_api/intro), [Service API](/u/service_api/getting_started))

0 commit comments

Comments
 (0)