Installing an SSL Certificate in Tomcat 4.x/5.x/6.x
After your certificate request is approved, you can download your SSL and intermediate certificate from within the SSL application. For more information see Downloading Your SSL Certificate. Both of these files must be installed on your Web server.
You may install the certificates in one of two ways: Install, signed certificate and root certificate bundle (sf_bundle.crt) or install signed certificate and two intermediate certificates (sf_intermediate.crt and sf_cross_intermediate.crt).
NOTE: Java 2 SDK 1.2 or above must be installed as the following describes how to install a certificate using keytool.
Installation Option One: Install the SSL Certificate and CA Bundle (sf_bundle.crt) Implementing a PKCS12 Keystore
Before you install your SSL certificate you must download our root certificate bundle (sf_bundle.crt) on your Web server. You may download the bundle from the repository.
Use the following OpenSSL command to combine the ca bundle sf_bundle.crt and your SSL certificate:
Updating the server.xml Configuration File
When you have completed installing your certificate, you must configure your Tomcat server.xml configuration file to point to the correct pkcs12 keystore file:
- Open the server.xml file.
- After uncommenting the SSL/TLS connector from server.xml, locate the following Factory tag section and COMMENT IT OUT:
<Factory className="org.apache.coyote.tomcat4.CoyoteServerSocketFactory" clientAuth="false" protocol="TLS" />
- Add the following directives to the Connector tag:
keystoreFile=<path to>\keystore.tomcat
keystorePass="changeit"
keystoreType="PKCS12"
- Restart Tomcat.
Installation Option Two: Install the SSL Certificate and Intermediate Certificate Separately
Installing Root and Intermediate Certificates
Once you have downloaded the certificates to your local machine, please use the following keytool commands to import them:
Root:
First intermediate (sf_cross_intermediate.crt):
Second intermediate (sf_intermediate.crt):
Installing SSL Certificate
Use the following command to import the issued certificate into your keystore.
Updating the server.xml Configuration File
When you have completed installing your certificate, you must configure your Tomcat server.xml configuration file to point to the correct keystore file:
- Open the server.xml file.
- After uncommenting the SSL/TLS connector from server.xml, locate the following text section:
<Factory className="org.apache.coyote.tomcat4.CoyoteServerSocketFactory" clientAuth="false" protocol="TLS" />
- Add the "keystoreFile" and "keystorePass directives:
<Factory className="org.apache.coyote.tomcat4.CoyoteServerSocketFactory" clientAuth="false" protocol="TLS" keystoreFile="/full/path/to/tomcat.keystore" keystorePass="changeit" />
- Restart Tomcat.
