Edit Reverse Proxy Advanced Settings for a Web Asset
When configuring a Web API or a Web Application asset to be protected by CloudGuard 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 AppSec 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.
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.
Explanation and comments
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 AppSec Gateway
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 AppSec Gateway
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.
Defines a timeout to establish a connection with a proxied server.
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.
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.
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
Proxy SSL Verify
Enables or disables verification of the proxied HTTPS server certificate.
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.
Controls periodic health checks to verify NGINX is running (true by default).
Configures a domain name server's IP address used to resolve names of upstream URLs (the backend servers’ URL) into addresses.
Controls the activation of Strict Transport Security Response header on all responses coming from the AppSec Gateway (false by default).
Enable Failed Requests Login
When set to "true", the AppSec Gateway will also log all blocked traffic due to Reverse Proxy configuration (false by default).
Enable Web Socket Proxying
Controls the activation of a proxy tunnel for web socket requests through the AppSec gateway (true by default).
Allows the definition of an additional SSL ciphers' list that will be allowed by the AppSec Gateway for HTTPS traffic.
String of SSL ciphers delimited by ':'