JasperReports Server exposes some URLs to itself through the UI and when using the scheduler to send emails. When using a proxy, those URLs must be rewritten so that they expose the proxy URL, not actual URL of the server instance. This can be done on the proxy or using a t JasperReports Server setting.
The preferred method is to configure your proxy or load balancer to set X-Forwarded-* headers (X-Forwarded-For, X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port) headers. If X-Forwarded-* headers are not configured on your proxy, configure the properties described below. If you are using multiple proxies, X-Forwarded-* headers on all intermediate proxies should be set to the address of the proxy receiving requests from the user's UI.
When using a proxy, make sure that the proxy is set up to allow special symbols in URLs. In Apache httpd, this option is called AllowEncodedSlashes On. See the documentation for your application server for more information. |
Change the following settings so that JasperReports Server exposes the proxy URL.
Configuration for Using Proxies | |
Configuration File | |
.../WEB-INF/js.config.properties | |
Property | Description |
deploy.base.url | Set this property to the full URL to expose the JasperReports Server UI through the proxy. This URL must include the application name. For example: http://bi.example.com/jasperserver-pro Specify http or https in your URL. |
deploy.base.local.url | Set this property to the localhost URL to expose the JasperReports Server UI through the proxy. This URL must include the application name. For example: http://localhost:8080/jasperserver-pro Specify http or https in your URL. |
Configuration File | |
.../WEB-INF/js.quartz.properties | |
Property | Description |
report.scheduler.web.deployment.uri | This is the base URL used by the scheduler to generate links to reports in emails. Set this property to the full URL, including application name, that you expose through your proxy. It should be the same as deploy.base.url. |
Recommended Comments
There are no comments to display.