Issue Summary
The documentation for Integrating Jira with Apache using SSL is missing the relaxedQueryCharacters attribute that was added as part of Jira 7.13 era changes as required in Tomcat's <Connector> specification.
Invalid specification
<Service name="Catalina"> <!-- Apache Proxy Connector with values for scheme, proxyName and proxyPort --> <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true" scheme="https" proxyName="jira.atlassian.com" proxyPort="443"/> <!-- Standard HTTP Connector --> <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8081" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>
This will result in the following error on startup:
2018-12-22 14:01:10,680 JIRA-Bootstrap ERROR [c.a.j.health.checks.TomcatConfigurationHealthCheck]
Required path chars: [ ] |
Configured path chars: null []|
Required query chars: [ ] | { } ^ \ ` " < >
Configured query chars: null []|{}^\`"<>
2018-12-22 14:01:10,704 JIRA-Bootstrap ERROR [c.a.jira.health.HealthChecks] Tomcat is misconfigured
2018-12-22 14:01:10,704 JIRA-Bootstrap ERROR [c.a.jira.health.HealthChecks] The server.xml file is missing parameters needed by Jira to handle requests that contain special characters.
Correct Specification
<Service name="Catalina"> <!-- Apache Proxy Connector with values for scheme, proxyName and proxyPort --> <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1" relaxedQueryChars="[]|{}^\`"<>" redirectPort="8443" useBodyEncodingForURI="true" scheme="https" proxyName="jira.atlassian.com" proxyPort="443"/> <!-- Standard HTTP Connector --> <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8081" protocol="HTTP/1.1" relaxedQueryChars="[]|{}^\`"<>" redirectPort="8443" useBodyEncodingForURI="true"/>
- is cloned from
-
JRASERVER-74250 SSL Documentation for server.xml Connector is incorrect
-
- Closed
-
- Mentioned in