# Rate Limit

CloudGuard WAF agents have the ability to limit the number of requests to a matched URI within a configured time scope, according to the source identifier.

### How to set up rate limit 

#### Step 1: Activate Rate Limit from the Practices tab when editing an asset

Browse to **Policy->Assets** and edit the relevant Web Application / API asset. 

Once the asset edit window opens, select the **Rate Limit** tab and click on **Click to add a new Rate Limit Practice**.

<figure><img src="/files/BBwn1p4ten6iK4YA0aCg" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Pay attention to the configuration of **Source Identity**. When counting requests to see if a limit was exceeded, the source identity is the key according to which they are counted.

i.e. "X requests from the same source identifier..."

If the source identity configuration doesn't match a value, the source IP address is used instead for the purposes of counting the request.
{% endhint %}

#### Step 2: Add a New Rate Limit Rule

Click on **Click to add a new Rate Limit rule.** When creating a new rule or editing an existing rule, a configuration window will open:

<figure><img src="/files/m9qgeWiGTOLSJTgIcwsd" alt=""><figcaption></figcaption></figure>

A rate limit rule consists of:

* **Action** configuration. there are 3 options:
  1. **According to practice** - The action will be determined by the practice mode previously configured.
  2. **Detect** - Only logs will be issued if the rate limit for this rule is reached. This will override the practice mode unless it is Inactive.
  3. **Prevent** - Rate limit for this rule is enforced. This will override the practice mode unless it is Inactive.

<figure><img src="/files/9Ev2ekQvzdcjTe8B36fw" alt=""><figcaption></figcaption></figure>

* Match conditions:
  * **URI** - A string written in this field is concatenated as a suffix to all defined URLs of the Web Application or Web API asset. The concatenation result is considered the prefix for all requests that will match this rule. \
    While the URI field does not accept a regular expression, it does support usage of '\*' wildcard character.\
    \&#xNAN;*Example -* If the Asset's defined URLs are "**<http://www.myapp.com>**" and "**<https://www.mysecureapp.com>**" and the URI in the rule is "**/docs**", it will be matched on all requests starting with either **<http://www.myapp.com/docs>** or **<https://www.mysecureapp.com/docs>**.

    Use "**/**" to match all requests to the asset's domains.
  * **Additional Conditions** - An optional logical expression in addition to the main URI regular expression. The logical expression can use AND/OR/NOT between matching key-value pairs to decide what traffic should be counted to determine if rate of requests has exceeded. There are several keys that can be used:
    * **URI** - A regular expression that is matched on the URI field. Since the main URI field already creates an initial prefix match of the URI path, the regular expression is usually used to match specific states if a wildcard was used, or strings in the full URI beyond the prefix.&#x20;
    * **Source Identifier** - A regular expression matching the source identifier values according to Source Identity configuration of the asset. If source identifier is not detected in traffic according to configuration, the value will be matched vs the source IP address.
    * **Source IP** - A network IP address in X.X.X.X format or CIDR (e.g. 11.22.33.44/24).&#x20;

<figure><img src="/files/SPhbWBs6rqT0Qlux8b86" alt=""><figcaption></figcaption></figure>

* Limit configuration:
  * **Limit** - the maximum number of requests in a specific time scope.
  * **Time Unit** - the time scope in which the limit is enforced.

{% hint style="info" %}
If **Limit** is set to 7000 and **Unit** is set to "Minute" then an Active Rate Limit practice will prevent requests to the matched URI if they exceed 7000 requests from the same source identifier, in a single minute.
{% endhint %}

* Trigger configuration:\
  Configure the trigger (usually the log trigger) that will activate when a Rate Limit rule is fully matched by URI as well as requests rate.<br>

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>In <strong>Detect/Learn</strong> mode, the Trigger is the only action that will occur if the rate of matched URIs from the same source identifier has exceeded configured limits.</p></div>

After clicking OK, you will see the full rule:

<figure><img src="/files/maeAitdcRfWTi11idiwP" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Match priority** - The rate is enforced according to a single matched rule. When the URI of the request matches multiple URIs in multiple rules, the longest match takes precedence and determines the rate limit count.&#x20;

*Example* - if there are 2 rules - one limiting the URI "/docs" for 10000 requests from the same source identifier in one minute, and the second limiting "/docs/external" for 3000 requests from the same source identifier in one minute, then requests to /docs/external/latest will be blocked if they exceed 3000 requests from the same source identifier in one minute, as this rule creates a longer match.
{% endhint %}

#### Step 4: Enforce Policy

Click **Enforce** on the top banner of the Infinity Portal.

### Advanced option in CloudGuard WAF's AppSec Gateways - Limit only according to IP addresses

CloudGuard WAF's [AppSec Gateway](/getting-started/deploy-enforcement-point/gateway-virtual-machine.md) deployments provide a Check Point-managed reverse proxy as part of the deployment. It is possible to configure a CloudGuard WAF AppSec Gateway to enforce rate limit by using the reverse proxy settings. As the Reverse Proxy server does not have access to the agent's parsing capabilities, the rate limit in this case is done only using source IP addresses as the key to count requests.

To configure rate limit using this enforcement method, go to your CloudGuard WAF AppSec Gateway profile in **Policy**->**Profiles** and open the Advanced tab.\
In the Advanced Settings table add the following key-value:\
**agent.rpmanager.enableNginxRateLimit** : **true**

Click "Enforce Policy".

<figure><img src="/files/oEmXGki42LcmRsCu7oyW" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://waf-doc.inext.checkpoint.com/additional-security-engines/rate-limit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.