Using an IIS Reverse Proxy

Describes how to use Oxygen XML Web Author behind an IIS reverse proxy.

If you want to use Oxygen XML Web Author with IIS as a reverse proxy, follow this procedure:
  1. Configure IIS to allow double escaping in URLs. See the following examples:
    • For Microsoft Azure, the applicationHost.xdt file should contain the following:
      <?xml version="1.0" encoding="utf-8"?>
       <configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
          <system.webServer>
           <security>
            <requestFiltering allowDoubleEscaping="true" 
      xdt:Transform="SetAttributes(allowDoubleEscaping)" />
           </security>
          </system.webServer>
      </configuration>
    • For other types, insert the following fragment inside the applicationHost.config file:
      <security>
        <requestFiltering allowDoubleEscaping="true"/>
      </security>
  2. Configure Tomcat to allow escaped slashes. Append the following line in the tomcat\conf\catalina.properties file:
    org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
  3. Set an environment variable to instruct Oxygen XML Web Author that the URL path is already decoded. Insert the following line in the [OXYGEN_WEBAUTHOR_INSTALL_DIR]\tomcat\bin\catalina.bat file:
    set "URL_DECODING_PROXY=true"