Generating a CSR and Installing an SSL Certificate in Tomcat 4.x/5.x/6.x
When you request an SSL certificate, you must provide a Certificate Signing Request (CSR) from your server. The CSR includes your public key, and must contain the same details as the online request form in your account. After your request is vetted and your certificate is issued, download and install all of the provided files to complete the installation.
NOTE: These steps describe how to install a certificate using keytool, so you must have Java 2 SDK 1.2 or above installed on your server.
Generating a Keystore and CSR in Tomcat
Using Keytool, follow these steps to generate a keystore and CSR on your server.
To Generate a Keystore and CSR in Tomcat
- Enter the following command into keytool to create a keystore:
keytool -keysize 2048 -genkey -alias tomcat -keyalg RSA -keystore tomcat.keystore - Enter a Password. The default is changeit.
- Enter Distinguished Information:
- First and Last Name — The fully-qualified domain name, or URL, you're securing. If you are requesting a Wildcard certificate, add an asterisk (*) to the left of the common name where you want the wildcard, for example *.coolexample.com.
- Organizational Unit — Optional. If applicable, you can enter the DBA name in this field.
- Organization — The full legal name of your organization. The listed organization must be the legal registrant of the domain name in the certificate request. If you are enrolling as an individual, please enter the certificate requestor's name in Organization, and the DBA (doing business as) name in Organizational Unit.
- City/Locality — Name of the city in which your organization is registered/located — do not abbreviate.
- State/Province — Name of state or province where your organization is located — do not abbreviate.
- Country Code — The two-letter International Organization for Standardization (ISO) format country code for where your organization is legally registered.
- Enter the following command into keytool to create a CSR:
keytool -certreq -keyalg RSA -alias tomcat -file csr.csr -keystore tomcat.keystore - Enter the Password you provided in Step 2.
- Open the CSR file, and copy all of the text
(include ----BEGIN NEW CERTIFICATE REQUEST---- and ----END CERTIFICATE REQUEST----). - Paste all of the text into the online request form and complete your application.
For more information about completing the online request form, see Requesting a Standard or Wildcard SSL Certificate.
After you submit the application, we begin vetting your request. You will receive an email with more information when this process is complete.
Installing Your SSL in Tomcat
After the certificate is issued, download it from the Certificate Manager and place it in the same folder as your keystore. Then, using keytool, enter the following commands to install the certificates.
The file names for your root and intermediate certificates depend on your signature algorithm. For more information, see Which secure hash algorithm should I use for my SSL?
- SHA-1 root certificate:
sf_class2_root.crt
- SHA-2 root certificate:
sfroot-g2.crt
- SHA-1 intermediate certificate:
sf.intermediate.crt
- SHA-2 intermediate certificate:
sfig2.crt
You can also download certificates from the repository.
To Install Your SSL in Tomcat
- Install the root certificate:
keytool -import -alias root -keystore tomcat.keystore -trustcacerts -file <name of the root certificate> - Install the intermediate certificate:
keytool -import -alias intermed -keystore tomcat.keystore -trustcacerts -file <name of the intermediate certificate> - Install the issued certificate into the keystore:
keytool -import -alias tomcat -keystore tomcat.keystore -trustcacerts -file <name of the certificate> - Update the server.xml file with the correct keystore location in the Tomcat directory.
NOTE: The HTTPS connector is commented out by default. Remove the comment tags to enable HTTPS.
- Tomcat 4.x — Update the following elements in server.xml for Tomcat 4.x:
<Factory className="org.apache.coyote.tomcat4.CoyoteServerSocketFactory"
clientAuth="false"
protocol="TLS" keystoreFile="/etc/tomcat5/tomcat.keystore"
keystorePass="changeit" /> - Tomcat 5.x, 6.x and 7.x — Update the following elements in server.xml for Tomcat 5.x, 6.x and 7.x:
<-- Define a SSL Coyote HTTP/1.1 Connector on port 8443 --> <!-- <Connector port="8443" maxThreads="200"
scheme="https" secure="true" SSLEnabled="true"
keystoreFile="path to your keystore file" keystorePass="changeit" clientAuth="false" sslProtocol="TLS"/>
- Tomcat 4.x — Update the following elements in server.xml for Tomcat 4.x:
- Save your changes to server.xml, and then restart Tomcat to begin using your SSL. Your SSL Certificate is installed. If you have problems, please see Using the SSL Installation Tool to help diagnose issues.