Edit Reverse Proxy Advanced Settings for a Web Asset
Last updated
Last updated
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.
The following window will appear:
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.
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 | 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 ':' |