Symptoms

In most cases URLs running over HTTP work fine, but not when using HTTPS (i.e. over SSL). This usually results in Unicode (non-ASCII) characters in an HTTPS URL appearing incorrect in the URL, and the served page containing numerous errors.

Cause

This occurs when the useBodyEncodingForURI="true" flag is not defined in the HTTPS connector definition in conf/server.xml of the Apache Tomcat application server running JIRA. This flag is set as such by default in 'recommended' distribution installations of JIRA, however, in JIRA WAR setups, this might not be the case.

Resolution

  • Ensure that the useBodyEncodingForURI="true" flag is included in the following element of the conf/server.xml file of your Apache Tomcat installation running JIRA. This forces the encoding to match the encoding of the request, which should be in UTF-8:

    <Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol"  maxHttpHeaderSize="8192" SSLEnabled="true"  maxThreads="150" minSpareThreads="25"  enableLookups="false" disableUploadTimeout="true"  acceptCount="100" scheme="https" secure="true"  clientAuth="false" sslProtocol="TLS" useBodyEncodingForURI="true"/>
    XML
  • Alternatively you can set the flag URIEncoding="UTF-8", which will set the default URL encoding to UTF-8:

    <Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol"  maxHttpHeaderSize="8192" SSLEnabled="true"  maxThreads="150" minSpareThreads="25"  enableLookups="false" disableUploadTimeout="true"  acceptCount="100" scheme="https" secure="true"  clientAuth="false" sslProtocol="TLS" URIEncoding="UTF-8"/>
    XML