Restricting Forwarding and Retrieval of External Content
For some functions, WebOffice 10.9 R5 retrieves content from other servers via the WebOffice server or forwards to them, e.g. the result page of a query on a WMS service with credentials or an integrated external application. To make sure that only addresses you know and need are used, enable the check in the security settings of the application configuration and restrict the allowed addresses.
As delivered, the check is switched off. This default is designed for compatibility and is not recommended for production. Agree on the setting with your IT department or your CISO. As long as the check is off or allows any address, WebOffice 10.9 R5 writes a notice to the log file at every start.
Which addresses are affected
The check only applies to addresses that WebOffice 10.9 R5 retrieves via the WebOffice server or forwards to. Map display, queries and printing with ArcGIS services do not go through it.
Used in your projects |
Add to the allow list? |
|---|---|
WMS services with credentials (user name and password) |
Yes. The result page of a query on such a service is retrieved via the WebOffice server. |
Integrated external applications and external pages opened from WebOffice 10.9 R5 (e.g. via external applications, modules or tools) |
Yes, if the call is forwarded via the WebOffice server. The log file shows which addresses these are (see below). |
ArcGIS Server services (map services, feature services), including secured ones, as well as ArcGIS Online and ArcGIS Enterprise portal |
No. These services are not retrieved via forwarding. |
ArcGIS Server integrated as a WMS service with credentials |
Yes. The same applies as for any other WMS service with credentials. |
|
When the check is switched on, services configured in your projects are not allowed automatically. Only your own WebOffice server and the entries in URL Redirect Parameter allow list are allowed. |
Settings
You find the settings in WebOffice Author under Application Configuration > Security > Open Redirects.
Property |
Recommendation for production |
|---|---|
Check Open Redirects? |
Set to Yes. Then only addresses of your own WebOffice server (same host) and the addresses in URL Redirect Parameter allow list are allowed. |
URL Redirect Parameter allow list |
Regular expression with the allowed addresses. It must match the host (including the port, if the address contains one) and the path completely; the protocol (http/https) is not compared. An entry with the host name only (e.g. gis\.example\.com) therefore matches no address; add the path (e.g. gis\.example\.com/.*). Enter only the addresses you actually need; do not allow any address (e.g. .*). |
Determining suitable values for your environment
1.On a test or staging system, set Check Open Redirects? to Yes and reload the application.
2.Go through the workflows used in production, in particular queries on WMS services with credentials (result as HTML page) and opening integrated external applications and external pages from your projects.
3.Search the WebOffice log file for the message Redirect URL is not allowed. It names the rejected address (host, port and path).
4.Add the required addresses to URL Redirect Parameter allow list, as narrowly as possible: host and beginning of the path, followed by /.* (see examples).
5.Repeat these steps until no required workflow is rejected any more. Then apply the setting to production.
A good starting point are the addresses of the WMS services with credentials configured in your projects and of the integrated external applications. You do not need to enter ArcGIS Server services (see Which addresses are affected).
Examples
URL Redirect Parameter allow list |
Meaning |
|---|---|
(gis\.example\.com|wms\.example\.org)/.* |
All paths of both hosts. Escape dots in host names with \. |
geodaten\.example\.net:8443/wms/.* |
Only paths below /wms/ of this host on port 8443. |
Web Application Firewall (WAF)
A web application firewall in front of the WebOffice server protects incoming requests. This setting, in contrast, defines where WebOffice 10.9 R5 itself forwards to or what it retrieves. A WAF therefore only replaces the setting if it specifically checks the forwarding target in the requests. If in doubt, switch on the check in addition.
Changes to the application configuration take effect after the application is reloaded or Apache Tomcat is restarted. As with all hardening measures, change only one setting at a time and then test the workflows used in production.