Enabling SSL (Linux/*nix)
- Shut down Cascade Server
- Create a keystore (from http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html) by executing the following command: $JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA
Once created, the .keystore file can typically be found in the home directory of the user who created it; eg, /home/user).
- Edit the file tomcat/conf/server.xml
- Uncomment the area for SSL/TLS Connector configuration:
<!-- Define a SSL HTTP/1.1 Connector on port 8443
This connector uses the JSSE configuration, when using APR, the
connector should be using the OpenSSL style configuration
described in the APR documentation -->
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true" clientAuth="false"
sslProtocol="TLS" />
- Add the keystoreFile and keystorePass
attributes to the
<Connector>
element and specify the location of the keystore along with the password:
<!-- Define a SSL HTTP/1.1 Connector on port 8443
This connector uses the JSSE configuration, when using APR, the
connector should be using the OpenSSL style configuration
described in the APR documentation -->
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true" clientAuth="false"
sslProtocol="TLS" keystoreFile="/path/to/keystore"
keystorePass="somePassword" />
- Start Cascade Server
The application should now be accessible through https://{host}:8443.
See this article for instructions on forcing connections to use SSL.