Install the Certificate

This topic applies only to VoiceConsole On Prem deployment customers.

If you are running this command on Windows:

  1. Paste it into the command prompt
  2. Ensure that the Java JDK bin folder is in your PATH environment

To run the keytool command, install Java JDK or use the included keytool program that is installed alongside VoiceConsole/VoiceLink in the <install Path/jre/bin>.

Open a command prompt to run the commands below.

From a Certificate Authority

  1. Place the certificate file that you received from a certificate authority into the directory where your private key and certificate signing request were saved.
  2. Run the following command, replacing the variables with your information. 
    Keytool -import -trustcacerts -alias tomcat -file certificateFileName.p7b -keystore keystorePath/.keystore
  3. A confirmation of installation appears.

Generate Your Own Self-Signed Certificate

To generate a self-signed certificate that is valid for a specified number of days, perform the following steps:

  1. Copy and paste the following command into a terminal session on the machine where the Java keytool is located. The command assumes that the Java keytool is installed on your server.
    Replace the variables with your own information.
    keytool -genkey -validity number of days -alias tomcat -keyalg RSA -keysize 2048 -keystore keystorePath/.keystore -dname "CN=Domain name of server, O=Your Organization, OU=Organizational Unit, L=City, ST=State, C=Country"
  2. Press Enter.
  3. Enter a keystore password, and press Enter.
  4. Enter the same password to confirm, and press Enter.
  5. Press Enter again to confirm using the same password for the Tomcat alias.

Configure Tomcat

  1. In a text editor, open the Tomcat server.xml file.
  2. Update the location of the keystore file and the keystore password in the Tomcat connector definitions in Tomcat's server.xml file.

    There are two connector definitions that require this change. Each connector definition is a separate Connector XML element.

    Example:
    <Connector port="9443" protocol="org.apache.coyote.http11.Http11NioProtocol" connectionTimeout="10000" tomcatAuthentication="false"
    keepaliveTimeout="5000" backlog="50" maxThreads="10" scheme="https" secure="true" SSLEnabled="true" clientAuth="false" sslProtocol="TLS"
    keystorePass="keystorePasswordEnteredAbove" keystoreFile="keystorePath/.keystore"/>
    The keystore file parameter is relative to this directory (<install Path> tomcat/webapps/VoiceConsole) unless absolute path is provided.
  3. Save the file.
  4. Restart Tomcat.