Skip to content

Commit fc76c2e

Browse files
authored
Merge pull request #150 from 1991-mirec/feature/DEF-35723
DEF-35723: update enhanced dos docs with action configuration
2 parents 383de02 + 6ae4473 commit fc76c2e

1 file changed

Lines changed: 12 additions & 1 deletion

File tree

docs/dashboard/README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1230,7 +1230,7 @@ Click <span class="notranslate">_Save changes_</span> button on the bottom of th
12301230

12311231
The Enhanced DOS Protection feature forms an additional layer of protection, increasing the stability of servers facing DOS attacks. It takes a different approach than our existing [DOS Protection feature](/dashboard/#dos-protection), which focuses on monitoring the number of simultaneous connections. Enhanced DOS Protection, on the other hand, monitors the rate of requests originating from attacker IP addresses per unit of time.
12321232

1233-
The new feature works better against attacks based on short-living connections and against attacks where the number of requests grows fast (hundreds of requests per second). As Enhanced DOS Protection monitors the number of requests in real-time, it reacts to the threats almost instantly, greylisting the detected IPs and redirecting their requests to the Anti-Bot challenge.
1233+
The new feature works better against attacks based on short-living connections and against attacks where the number of requests grows fast (hundreds of requests per second). As Enhanced DOS Protection monitors the number of requests in real-time, it reacts to the threats almost instantly, greylisting the detected IPs and redirecting their requests to the Anti-Bot challenge. However, it can also be configured to blacklist the IP immediately, completely dropping all further packets.
12341234

12351235
Standard DoS protection, in turn, will block attacks that use long-lived connections (e.g. Slowloris attacks), so these functions complement each other perfectly.
12361236

@@ -1248,6 +1248,17 @@ The feature is switched off by default. You can activate Enhanced DOS Protection
12481248
imunify360-agent config update '{"ENHANCED_DOS":{"enabled":true}}'
12491249
```
12501250

1251+
<h4>Configure the Protective Action</h4>
1252+
1253+
You can define the action taken against an attacking IP. The default action is graylist.
1254+
```
1255+
imunify360-agent config update '{"ENHANCED_DOS":{"action":"blacklist"}}'
1256+
```
1257+
* `"graylist"` (Default): The attacker's IP is added to the Graylist. Their requests are redirected to a splashscreen challenge, and they can regain access by solving it.
1258+
* `"blacklist"`: The attacker's IP is added to the Blacklist, completely blocking them from accessing the server. They will not be presented with a challenge.
1259+
1260+
<h4>Adjust Thresholds and Timeframe</h4>
1261+
12511262
The default timeframe (seconds) and threshold of request (number) could be changed by the following CLI commands:
12521263

12531264
```

0 commit comments

Comments
 (0)