Creating a custom WAF rule

Custom WAF rules let you write conditions Bunny Shield doesn’t cover out of the box. You pick the variables, operators, transformations, and response actions to target threats specific to your application.

What you’ll need

Before you dive in, make sure you have the following prerequisites in place:

A bunny.net account ( Log in or sign up for a free trial).
An existing Shield Zone.
Advanced Plan or above on the existing Shield Zone.
Your AccessKey or JWT for API authentication.

With these in place, you’ll have the access and permissions needed to create and manage custom WAF rules.

Before writing your first rule, read the Rule Engine documentation to understand how rules are structured.

This rule processes each HTTP request by extracting only the REQUEST_URI (Variable), converting it to lowercase, and removing whitespaces (Transformations). It then verifies if the transformed REQUEST_URI matches exactly (Operator) with ‘/blockedpath’ (Operator Value). If a match is found, our WAF Engine will block (Response Action) the request, halting further rule processing and intercepting the request. With the basics covered, you can write WAF rules that target the threats specific to your site.

Examples of custom WAF rules

To illustrate how you can implement custom WAF rules, here are some practical examples:

Block request by ASN

If you want to block requests that originate from a specific ASN, you can create a rule as follows:

Block request by country code

If you want to block requests that originate from a specific country code, you can create a rule as follows:

If you want to log requests that contain a specific cookie with a particular value, you can create a rule as follows:

Challenge request if a specific path is accessed

To challenge a user when they access a specific path, you can define a rule like this:

Block request if User-Agent is a known crawler

To block requests that have a User-Agent matching a known crawler, the rule would be:

Adapt these patterns to mitigate the threats and enforce the security policies that match your application.

Documentation

Protection Features

Reference

Creating a custom WAF rule

What you’ll need