Skip to content

Commit 8ca2714

Browse files
author
jdv
committed
adding links an mini desc in bouncer page
1 parent 4e2c687 commit 8ca2714

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

crowdsec-docs/docs/contributing/bouncers.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,32 @@ Sharing on the hub allows other users to find and use it. While increasing your
1414

1515
### How ?
1616

17+
#### Specs
18+
19+
Remediation components have mandatory and optional features, they are described in the following sub pages:
20+
- [Specifications for Remediation Component and AppSec Capabilities](/contributing/specs/bouncer_appsec_specs)
21+
- [Remediation Component Metrics](/contributing/specs/bouncer_metrics_specs)
22+
23+
*Don't hesitate to get in touch with us via discord if anything is unclear to you*
24+
25+
Those specs describe how the Remediation component interacts with the Security Engine Local API as well as how each feature should behave.
26+
27+
Main features are:
28+
- **Mode**: How the bouncer retrieves decisions
29+
- **Stream**: Pulls them periodically and stores them locally (preferred for low latency remediation)
30+
- **Live**: Queries the LAPI upon request reception (easier to implement)
31+
- Both available ideally, but **Stream** preferred in most cases
32+
- **AppSec**: Ability to forward requests to the Security Engine to eval appsec rules
33+
- Optional but if the remediation component has access to the request this features is a big plus
34+
- **Metrics**: Keep track of what was remediated
35+
- Optional but very useful for the users to be able to evaluate the efficiency of the protection
36+
- Ideally with details on the source of the decision (blocklist, manual block, a scenario triggering a decision 'crowdsec'...)
37+
38+
Other optional features are:
39+
- **MTLS** support
40+
- Exposing metrics to **Prometheus**
41+
42+
#### Publish on Github
1743

1844
To have it published on the hub, please simply [open a new issue on the hub](https://github.com/crowdsecurity/hub/issues/new), requesting "remediation component inclusion". The remediation component will then be reviewed by the team, and published directly on the hub, for everyone to find & use it!
1945

0 commit comments

Comments
 (0)