System Configuration
Enabling or Disabling TLS Versions
To allow (or restrict) specific TLS protocols for the application to use:
- Stop Cascade CMS.
- Edit the file
tomcat/conf/server.xml
. - Locate your existing SSL/TLS Connector.
- Add the
sslEnabledProtocols
attribute along with TLS protocols that you wish to allow/restrict. For example:sslEnabledProtocols="TLSv1.2"
- to force TLSv1.2 onlysslEnabledProtocols="TLSv1.2+TLSv1.3"
- to allow both TLSv1.2 and TLSv1.3
- Save the file
- Start Cascade CMS
A sample Connector that allows for TLSv1.2 and TLSv1.3 can be seen below:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
keystorePass="keystorePass"
keystoreFile="pathToKeystore"
maxThreads="256"
maxPostSize="40000000"
maxParameterCount="1000000"
connectionTimeout="20000"
maxSwallowSize="-1"
SSLEnabled="true"
sslEnabledProtocols="TLSv1.2+TLSv1.3"
scheme="https"
secure="true"
clientAuth="false"
sslProtocol="TLS"
compression="on"
compressionMinSize="1024"
noCompressionUserAgents="gozilla, traviata"
compressibleMimeType="application/javascript,application/json,application/rss+xml,application/vnd.ms-fontobject,application/font-sfnt,application/font-woff,font/opentype,font/woff2,application/x-javascript,application/xhtml+xml,application/xml,font/eot,font/opentype,image/svg+xml,image/vnd.microsoft.icon,image/x-icon,text/css,text/html,text/javascript,text/plain,text/xml" />
See the official Apache Tomcat documentation for additional information.
Tip: Be sure to document any changes you make to the
server.xml
file so that you can put them back in place after any future upgrades to the application.