Skip to content

Commit 1f4f562

Browse files
author
jdv
committed
section 4 first draft
1 parent 429b4e9 commit 1f4f562

1 file changed

Lines changed: 26 additions & 9 deletions

File tree

crowdsec-docs/unversioned/user_guides/interactive_se_install/04_remediation.mdx

Lines changed: 26 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,27 +10,44 @@ import CodeBlock from '@theme/CodeBlock';
1010

1111
# Remediation
1212

13-
blabla
13+
Now that the detection is setup, lets remediate those bad IPs. You can apply a remediation in many places.
14+
The job of a remediation component (aka RC or bouncer) is to keep the list of IPs up to date within the context you want to use: from the firewall of your host iptables/nftables to your edge appliances by exposing the list of IPs to it (mirror bouncer) through AWS WAF or Cloudflare... See full list of remediation components here[link]
15+
This list of IPs will be comprised of decisions taken by the security engine (based on scenarios), IPs from blocklists your Security Engine is subscribed to (by default the community blocklist), and manual additions you may do via various methods.
1416

1517
## Choosing and testing a remediation component
1618

19+
// Explain various ways and advantages (push to be able to appsec and has metrics)
20+
1721
### Instructions
1822
...
1923

24+
//Help connect to SE
25+
A remediation component can get its information from the security engine via a URL+TOKEN (some support Mutual TLS authentication)
26+
If installed on a host with a running security engine, they usually automatically pair (you can check with cscli bouncers list) to change the pairing, follow the steps described in the documentation
27+
2028
### Verification
2129

2230
Let's check ...
2331

24-
#### CrowdSec installation health
25-
26-
> [ ] Check ...
27-
32+
#### Bouncer connectivity
33+
> [ ] Check that the bouncer is connected to the Security Engine
34+
Check that the bouncer is registered properly and active (in cscli and in the console)
2835
```bash
29-
...
36+
cscli bouncers list
3037
```
31-
- You should see ...
32-
- ...
33-
38+
- You should see the bouncer you just installed in the list, with a recent heartbeat and a valid tick mark
3439

40+
> [ ] Check that the bouncing is effective
41+
- Have them add a decision for the IP of our canary automate (or use a free blocklist we use for the guide with 10 most aggressive IPs and one IP of our test automate canary)
42+
- Have them provide a URL that supposedly is protected
43+
- Have the canary try to reach and return a response
44+
- ??? How do we do this if we don't have a canary? without asking them to ban themselves
45+
// find an alternative while we don't have a canary system @thib @seb @laurence
3546

3647
### Troubleshooting
48+
49+
<details>
50+
<summary>Docker communication with bouncer</summary>
51+
52+
Docker bouncer: warning docker chain for example with firewall bouncer for docker user chain... ask for more precise phrasing @laurence
53+
</details>

0 commit comments

Comments
 (0)