Details
Description
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"/>
Attachments
Issue Links
- is cloned from
-
JRASERVER-74250 SSL Documentation for server.xml Connector is incorrect
-
- Closed
-
- Mentioned in