Setup Web User Response Pages

CloudGuard WAF protects web servers from attacks when set to Prevent mode. It is possible to determine the response returned to the client who initiated the blocked traffic. The response can be a simple HTTP error code, an HTTP redirect message, or a Block page that a user can view in their browser.

Setup a Web User Response Object

Step 1: Go to Policy->Behaviors and create a new Web User Response

If no behavior objects were configured yet you will see the following screen:

Alternatively the following screen with a "New" button at the top is shown:

Step 2: Select the type of the Web User Response and fill the form

Create a unique name for your Web User Response object and select a Type.

There are 3 types of Web User Response objects:

Block Page

This option is not a recommended option for CloudGuard WAF protecting Web API assets as it is designed to be seen by human users.

• Message title: The title of the web page to be shown to the user sending the malicious traffic

• Message body: The Body of the message to be shown to the user.

• HTTP Response Code: It is recommended to use a 403 (Forbidden) as a response code.

Different browsers behave differently upon receiving different error codes.

Using the Response code 444 will in fact reset the connection and the Message title and body will not be seen by the user.

Redirect

• Redirect URL: the client will be redirected to the provided URL where you can provide any customized web page.

• Add X-Event-Id to header: When selected the redirect message will include this header with a value that provides an internal reference ID that will match a security log generated by the incident, if log triggers are configured.

Response Code Only

This option is recommended for CloudGuard WAF protecting Web API assets.

• HTTP Response Code: It is recommended to use a 403 (Forbidden) as a response code.

  Different clients may behave differently upon receiving different error codes.

Custom Block Page

The Custom Block Page option allows you to define a fully customized response that is returned to users when a request is blocked by the WAF. This is useful for branding, user guidance, or providing additional context about the block event.

Unlike the default block page, this option enables you to upload your own HTML content and control the exact user experience.

Note: This option is primarily intended for browser-based applications. For Web APIs, consider using Response Code Only or as API clients do not render HTML pages.

Parameters

• Name – Unique name for the response configuration.

• Content Type – Response format (recommended: text/html).

• Upload File – Custom HTML file to display; include a placeholder for an CHECK_POINT_INCIDENT_ID that will be embedded in the response.

• HTTP Response Code – Status code returned to the client (default: 403 Forbidden).

Configure your CloudGuard WAF practice to use the new Web User Response

Step 1: Select the assets you wish to use this Web User Response upon event detection

Go to Policy->Assets and edit the asset you wish to modify.

Select the relevant practice tab and scroll to the bottom.

Step 2: Select the Web User Response object

Once selected, you will see the object shown as part of CloudGuard WAF Security Practice configuration:

Step 3: Enforce Policy

Policy is enforced after clicking Enforce in the top banner of the portal.