Edit Reverse Proxy Advanced Settings for a Web Asset

When configuring a Web API or a Web Application asset to be protected by CloudGuard WAF's AppSec Gateway, the wizard already configures the required reverse proxy settings of an upstream URL (the Protected web server's URL) and downstream URL (the exposed URL/s) for each asset.

However, there are additional advanced reverse proxy settings that can be set for the CloudGuard WAF per web asset.

Reverse Proxy Advanced Settings Location

Step 1: Edit the web API/application asset through Policy->Assets

Step 2: Click 'Advanced...' under Reverse Proxy in General tab

The following window will appear:

Validating the certificate of the internal server

The reverse proxy takes incoming HTTP/S requests and forwards them to an internal server.

When using HTTPS, the forwarded request to the internal server returns with a certificate which the best practice is to validate.

The below advanced proxy settings include the configuration option for "Trusted CA chain for protected server SSL verification". Use this option to configure the trusted CA chain that will validate the certificate presented by the internal server for enhanced security.

Advanced Proxy Settings

Setting	Explanation and comments
Redirect incoming HTTP requests to the same URL using HTTPS	Note - to use this option both an HTTP and a parallel HTTPS version of each web URL, used by this asset, need to be configured. A user using an HTTP wil always get a redirection to the parallel HTTPS URL before handling the request.
Activate access log on gateway	The reverse proxy logs every request through it after it is processed.
Add custom headers	When selecting this, the form will expand to show a table where you can redefine or append fields to the request header passed to the proxied server. Use text, variables, or a combination of both. The table will contain key:value records.

Setting

Explanation and comments

Redirect incoming HTTP requests to the same URL using HTTPS

Note - to use this option both an HTTP and a parallel HTTPS version of each web URL, used by this asset, need to be configured. A user using an HTTP wil always get a redirection to the parallel HTTPS URL before handling the request.

Activate access log on gateway

The reverse proxy logs every request through it after it is processed.

Add custom headers

When selecting this, the form will expand to show a table where you can redefine or append fields to the request header passed to the proxied server. Use text, variables, or a combination of both. The table will contain key:value records.

Additional Settings

Setting	Explanation and comments	Allowed Values
Additional location block instructions	Allows to upload a file with a set of instruction to be inserted into the location blocks of underlying NGINX configuration of the CloudGuard WAF AppSec Gateway	N/A
Additional server block instructions	Allows to upload g a file with a set of instruction to be inserted into the server blocks of the underlying NGINX configuration of the CloudGuard WAF AppSec Gateway	N/A
Trusted CA chain for protected server SSL verification	Provides the reverse proxy with a custom CA chain for SSL verification of the protected server URL.	N/A
Connect Timeout	Defines a timeout to establish a connection with a proxied server.	Positive number
Read Timeout	Defines a timeout to read a response from the proxied server. The timeout is set only between two successive read operations, not for the transmission of the whole response. If the proxied server does not transmit anything within this time, the connection is closed.	Positive number
Proxy Send Timeout	Sets a timeout to transmit a request to the proxied server. The timeout is set only between two successive write operations, not for the transmission of the whole request. If the proxied server does not receive anything within this time, the connection is closed.	Positive number
Proxy SSL Name	Allows overriding the server name used to verify the certificate of the proxied HTTPS server, and, allows it to pass through SNI when you establish a connection with the proxied HTTPS server	Server Name
Proxy SSL Verify	Enables or disables verification of the proxied HTTPS server certificate.	on/off
Keep Alive Timeout	Sets a timeout in which a keep-alive client connection stays open on the server side. The zero value disables keep-alive client connections.	Positive number
Health Check	Controls periodic health checks to verify NGINX is running (true by default).	true/false
DNS Server	Configures a domain name server's IP address used to resolve names of upstream URLs (the backend servers’ URL) into addresses.	IP address
Enable HSTS	Controls the activation of Strict Transport Security Response header on all responses coming from the CloudGuard WAF AppSec Gateway (false by default).	true/false
Enable Failed Requests Login	When set to "true", the CloudGuard WAF AppSec Gateway will also log all blocked traffic due to Reverse Proxy configuration (false by default).	true/false
Enable Web Socket Proxying	Controls the activation of a proxy tunnel for web socket requests through the CloudGuard WAF AppSec gateway (true by default).	true/false
SSL Ciphers	Allows the definition of an additional SSL ciphers' list that will be allowed by the CloudGuard WAF AppSec Gateway for HTTPS traffic.	String of SSL ciphers delimited by ':'

Setting

Explanation and comments

Allowed Values

Additional location block instructions

Allows to upload a file with a set of instruction to be inserted into the location blocks of underlying NGINX configuration of the CloudGuard WAF AppSec Gateway

N/A

Additional server block instructions

Allows to upload g a file with a set of instruction to be inserted into the server blocks of the underlying NGINX configuration of the CloudGuard WAF AppSec Gateway

N/A

Trusted CA chain for protected server SSL verification

Provides the reverse proxy with a custom CA chain for SSL verification of the protected server URL.

N/A

Connect Timeout

Defines a timeout to establish a connection with a proxied server.

Positive number

Read Timeout

Defines a timeout to read a response from the proxied server. The timeout is set only between two successive read operations, not for the transmission of the whole response. If the proxied server does not transmit anything within this time, the connection is closed.

Positive number

Proxy Send Timeout

Sets a timeout to transmit a request to the proxied server. The timeout is set only between two successive write operations, not for the transmission of the whole request. If the proxied server does not receive anything within this time, the connection is closed.

Positive number

Proxy SSL Name

Allows overriding the server name used to verify the certificate of the proxied HTTPS server, and, allows it to pass through SNI when you establish a connection with the proxied HTTPS server

Server Name

Proxy SSL Verify

Enables or disables verification of the proxied HTTPS server certificate.

on/off

Keep Alive Timeout

Sets a timeout in which a keep-alive client connection stays open on the server side. The zero value disables keep-alive client connections.

Positive number

Health Check

Controls periodic health checks to verify NGINX is running (true by default).

true/false

DNS Server

Configures a domain name server's IP address used to resolve names of upstream URLs (the backend servers’ URL) into addresses.

IP address

Enable HSTS

Controls the activation of Strict Transport Security Response header on all responses coming from the CloudGuard WAF AppSec Gateway (false by default).

true/false

Enable Failed Requests Login

When set to "true", the CloudGuard WAF AppSec Gateway will also log all blocked traffic due to Reverse Proxy configuration (false by default).

true/false

Enable Web Socket Proxying

Controls the activation of a proxy tunnel for web socket requests through the CloudGuard WAF AppSec gateway (true by default).

true/false

SSL Ciphers

Allows the definition of an additional SSL ciphers' list that will be allowed by the CloudGuard WAF AppSec Gateway for HTTPS traffic.

String of SSL ciphers delimited by ':'

PreviousAdd Data Loss Prevention (DLP) rules NextUpgrade your Reverse Proxy when a Linux/NGINX agent is installed

Last updated 2 months ago