True BusinessID with EV - Installation Instructions

Extended Validation SSL Certificates require the use of two CA certificates to be installed on the web server: the Extended Validation Root CA certificate and the Extended Validation Intermediate CA certificate. Both of these CA certificates must be installed on the server to enable the “green bar” capability in IE7 and to ensure the proper trust chain is established.

Note: For Microsoft IIS 5.0 and 6.0 users, all the required certificates are packaged in one certificate file.

Please select the correct CA certificate that corresponds to your order:

Customers NOT running Apache Web servers

 

Customers RUNNING Apache Web servers

 

Click on the server type you are using for instructions to install Extended Validation SSL.

 

Microsoft IIS 5.0 and 6.0
This document provides instructions for installing GeoTrust’s True BusinessID with Extended Validation SSL Certificate. If you are unable to use these instructions for your server, GeoTrust recommends that you contact Microsoft.

Installing an EV SSL Certificate
GeoTrust will send you the Extended Validation SSL certificate via email. The certificate will be in the body of the email, and you need to create a .cer file (example: NewCertificate.cer) by copying and pasting the certificate text into a plain text editor such as Notepad or Vi. Please be sure to include the header and footer as well as the surrounding dashes. Do not use Microsoft Word or other word processing programs that may add characters. Confirm that there are no extra lines or spaces in the file.

  1. Open the Internet Services Manager (IIS). Click Start > All Programs > Administrative Tools > Internet Information Services (IIS) Manger.
  2. Under Web Sites, right-click your web site and select Properties.
  3. Click the Directory Security tab.
  4. Under Secure Communications, click Server Certificate.
  5. The Web Site Certificate Wizard will open, click Next.
  6. Choose Process the Pending Request and Install the Certificate, then click Next.
    Important: The pending request must match the response file. If you deleted the pending request in error you must generate a new CSR and replace this certificate.
  7. Select the location of the certificate response file, and then click Next.
  8. Read the summary screen to be sure that you are processing the correct certificate and then click Next.
  9. At the confirmation screen, verify the information and click Next.

Stop and start your Web server prior to any testing. Be sure to assign your site an SSL port (443 by default). If you do not specify an IP address when installing your SSL Certificate, the same ID will be used for all virtual servers created on the system. If you are hosting multiple sites on a single server, you can specify that the ID only be used for a particular server IP address.

Apache
This document provides instructions for installing GeoTrust Extended Validation SSL Certificates. If you are unable to use these instructions for your server, GeoTrust recommends that you contact either the vendor of your software or an organization that supports Apache-SSL.

Step 1: Obtain the GeoTrust Apache Extended Validation Root Certificate Package
Before installing your certificate, you need to first obtain the GeoTrust Apache Extended Validation Root Certificate Package. Note: Be sure to use Vi or Notepad as word processing programs like Microsoft Word may add additional characters that may render the certificate unusable.

  1. Copy the Extended Validation Root certificate package into a text file and name it "EV_intermediate.crt". This file can be placed in the same directory as your SSL Certificate. For example: /usr/local/ssl/crt

Step 2: Install the EV SSL Certificate Your GeoTrust certificate will be sent via email and the certificate text is included in the body. Copy and paste it into a text file (such as OriginalCert.txt) using Vi or Notepad. Do not use Microsoft Word or other word processing programs that may add characters. Confirm that there are no extra lines or spaces in the file.

  1. To follow the naming convention for Apache, rename the certificate filename with the .crt extension. For example: cert.crt
  2. Copy your Certificate into the directory that you will be using to hold your certificates. In For example: /usr/local/ssl/crt/.

Step 3: Configure the Server

  1. In order to use the key pair, the httpd.conf file will need to be updated.
  2. In the Virtual Host settings for your site locate the httpd.conf file. Verify that you have the following 3 directives within this Virtual Host. Please add them if they are not present:

    SSLCertificateFile /usr/local/ssl/crt/public.crt
    SSLCertificateKeyFile /usr/local/ssl/private/private.key
    SSLCACertificateFile /usr/local/ssl/crt/EV_intermediate.crt

The first directive tells Apache how to find the Certificate File, the second one where the private key is located, and the third line the location of the intermediate certificate.

If you are using a different location and certificate file names than the example above (which most likely you are) you will need to change the path and filename to reflect your server.

Note: Some instances of Apache contain both a httpd.conf and ssl.conf file. Please enter or amend the httpd.conf or the ssl.conf with the above directives. Do not enter both as there will be a conflict and Apache may not start.

  1. Save your httpd.conf file and restart Apache. You can most likely do so by using the apachectl script:
    apachectl stop
    apachectl startssl
  2. You should now be set to start using your VeriSign certificate with your Apache-SSL Server.

Tomcat (keytool)
This document provides instructions for installing GeoTrust Extended Validation SSL Certificates. If you are unable to use these instructions for your server, GeoTrust recommends that you contact either the vendor of your software or an organization that supports Tomcat.

Step 1: Install the GeoTrust Extended Validation Root CA Root
You must first obtain the GeoTrust Extended Validation Root CA. Use the following command to import this certificate in the keystore:

  keytool -import -trustcacerts -alias EV_root -keystore -file EV_root.cer

Step 2: Install the GeoTrust Intermediate CA Certificate – GeoTrust Primary Certification Authority
Then obtain the GeoTrust Extended Validation Intermediate CA certificate (save it as EV_intermediate.cer) that corresponds to the certificate you purchased.

Create a file in Notepad and save it as EV_intermediate.cer

Use the following command to import this certificate in the keystore:

  keytool -import -trustcacerts -alias EVIntermediate -keystore -file EVintermediate.cer

Step 3: Install the SSL Certificate GeoTrust will send you the SSL certificate via email. The certificate is in the body of the email. Copy and paste it into a text file using Vi or Notepad. Do not use Microsoft Word or other word processing programs that may add characters.

Enter the following command to import your SSL Certificate

  keytool -import -trustcacerts -alias -keystore -file

BEA Weblogic 8.1
This document provides instructions for installing GeoTrust Extended Validation SSL Certificates. If you are unable to use these instructions for your server, GeoTrust recommends that you contact either BEA or an organization that supports Weblogic 8.1.

Step 1: Install the GeoTrust Extended Validation CA Root
You must first obtain the GeoTrust Extended Validation Root CA certificate (save it as EV_root.cer). Use the following command to import this certificate in the keystore:

  keytool -import -trustcacerts -alias EV_root -keystore -file EV_root.cer

Step 2: Install the GeoTrust Extended Validation Intermediate CA Certificate
Then obtain the GeoTrust Primary Certificate Authority (save it as EV_intermediate.cer) that corresponds to the certificate you purchased.

Create a file in Notepad and save it as EV_intermediate.cer

Use the following command to import this certificate in the keystore:

  keytool -import -trustcacerts -alias EVIntermediate -keystore -file EVintermediate.cer

Step 3: Install the SSL Certificate GeoTrust will send you the SSL certificate via email. The certificate is in the body of the email. Copy and paste it into a text file using Vi or Notepad. Do not use Microsoft Word or other word processing programs that may add characters.

Enter the following command to import your SSL Certificate:

  keytool -import -trustcacerts -alias -keystore -file


Netscape iPlanet 6.x
This document provides instructions for installing GeoTrust Extended Validation SSL Certificates. If you are unable to use these instructions for your server, GeoTrust recommends that you contact either the server software vendor or an organization that supports iPlanet.

Step 1: Install the GeoTrust Extended Validation Root CA
To properly install your certificate, you must first obtain the GeoTrust Extended Validation Root CA and create a file in Notepad called EV_root.txt. To install the GeoTrust Extended Validation Root CA Certificate:

  1. Select the server instance to manage and click Manage.
  2. Click Security.
  3. Click Install Certificate.
  4. Select Server Certificate Chain.
  5. Enter the key pair file password.
  6. Enter a Certificate Name. Example: GeoTrust Extended Validation Root
  7. Select Message text (with headers).
  8. Paste the contents within the EV_root.txt file (including the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----) into the box and click OK.
  9. Click Add Server Certificate.
  10. Do not shutdown and restart the server, proceed to Step 2.

Step 2: Install the GeoTrust Extended Validation Intermediate CA Certificate – GeoTrust Primary Certification Authority
Create a file in Notepad and save it as EV_intermediate.txt.

To install the EV Intermediate CA Certificate:

  1. Select the server instance to manage and click Manage.
  2. Click Security.
  3. Click Install Certificate.
  4. Select Server Certificate Chain.
  5. Enter the key pair file password.
  6. Enter a Certificate Name. Example: EV Intermediate CA
  7. Select Message text (with headers).
  8. Paste the contents within the EVIntermediate.txt file (including the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----) into the box and click OK.
  9. Click Add Server Certificate.
  10. Do not shutdown and restart the server, proceed to Step 3.

Step 3: Install the EV SSL Certificate
Your GeoTrust certificate will be sent via email. Look for the certificate text in the body of the email and copy and paste it into a text file (such as OriginalCert.txt) using Vi or Notepad. Do not use Microsoft Word or other word processing programs that may add characters. Confirm that there are no extra lines or spaces in the file.

  1. Select the This Server option.
  2. Enter the key pair file password.
  3. Enter a Certificate Name. Example: www.mysecurewebsite.com
  4. Select Message text (with headers).
  5. Paste the Certificate text into the box and click OK.
  6. Click Add Server Certificate.
  7. Click Apply.
  8. Select the apply changes that allows the server to restart.

IBM HTTP Server or Websphere running iKeyman
This document provides instructions for installing GeoTrust Extended Validation SSL Certificates. If you are unable to use these instructions for your server, GeoTrust recommends that you contact either the server software vendor or an organization that supports IBM server software.

Step 1: Install the GeoTrust Extended Validation Root CA Certificate
To properly install your certificate, you must first obtain the GeoTrust Extended Validation Root CA and create a file in Notepad called EVRoot.txt. To install the GeoTrust Extended Validation Root CA Certificate:

  1. Start the key management utility (iKeyman)
  2. Open the key database file that was used to create the certificate request.
  3. Enter the password, and then click OK.
  4. Select Signer Certificates and then click Add.
  5. Click Data type, and select a data type, such as Base64-encoded ASCII data. This data type must match the data type of the importing certificate.
  6. Enter a file name and location for the CA root digital certificate or click Browse to select a file name and location.
  7. Click OK.
  8. Enter a label for the importing certificate.
  9. Click OK.

The Signer Certificates field displays the label of the signer certificate you added.

Step 2: Install the GeoTrust Extended Validation Intermediate CA Certificate - GeoTrust Primary Certification Authority
Create a file in Notepad and save it as EV_intermediate.txt.

  1. Start the key management utility (iKeyman)
  2. Open the key database file that was used to create the certificate request.
  3. Enter the password, and then click OK.
  4. Select Signer Certificates and then click Add.
  5. Click Data type, and select a data type, such as Base64-encoded ASCII data. This data type must match the data type of the importing certificate.
  6. Enter a file name and location for the CA root digital certificate or click Browse to select a file name and location.
  7. Click OK.
  8. Enter a label for the importing certificate.
  9. Click OK.

The Signer Certificates field displays the label of the signer certificate you added.

Step 3: Install the EV SSL Certificate
GeoTrust will email you your certificate. The certificate is in the body of the email, copy and paste it into a text file (such as OriginalCert.txt) using vi or Notepad. Do not use Microsoft Word or other word processing programs that may add characters. Confirm that there are no extra lines or spaces in the file.

Step A: Installing the certificate
Using the iKeyman graphical user interface (GUI)

After GeoTrust sends you an SSL certificate, you add it to the key database file from which you generated the CSR. GeoTrust sends you the SSL certificate as part of an email, copy the certificate into a separate file. If necessary, move the file to the server machine.

  1. Start the iKeyman GUI using either the gsk7ikm command (UNIX) or the strmqikm command (Windows).
    Note: To use the iKeyman GUI, be sure that your machine can run the X Windows system.
  2. Choose Open from the Key Database File menu. Click Key database type, and select CMS.
  3. Click Browse to navigate to the directory containing the key database files.
  4. Select the key database file to which you want to add the certificate. For example, key.kdb.
  5. Click Open.
  6. In the Password Prompt window, type the password you set when you created the key database and then click OK.
  7. Select the Personal Certificates view.
  8. Click Receive.
  9. In the Receive certificate from a file window, select the data type of the new SSL certificate. For example, Base64-encoded ASCII for a file with the .arm extension.
  10. Click Browse to select the name and location of the certificate file name.
  11. Click OK.

Using the iKeycmd (command line interface)
To install a certificate in iKeycmd (using UNIX command line), use these commands:

  + gsk7cmd -cert -receive -file filename -db filename -pw password -format ascii

To install a certificate in iKeycmd (using Windows command line), use these commands:

  + runmqckm -cert -receive -file filename -db filename -pw password -format ascii

where:

  + -file filename is the fully qualified file name of the file containing the personal certificate.

  + -db filename is the fully qualified file name of a CMS key database.

  + -pw password is the password for the CMS key database.

  + -format ascii is the format of the certificate. The value can be ascii for Base64-encoded ASCII or binary for Binary DER data. The default is ascii.

Step B: Transferring certificates
You can extract an SSL certificate from a key database file and store it in a CA key ring file by performing the following steps:

Using the iKeyman graphical user interface (GUI)

  1. Start the iKeyman graphical user interface (GUI) using either the gsk7ikm command (UNIX) or the strmqikm command (Windows).
  2. Choose Open from the Key Database File menu. Click Key database type, and select CMS.
  3. Click Browse to navigate to the directory containing the key database files.
  4. Select the key database file to which you want to add the certificate. For example, key.kdb.
  5. Click Open.
  6. In the Password Prompt window, type the password you set when you created the key database and then click OK.
  7. Select Signer Certificates in the Key database content field, and then select the certificate you want to extract.
  8. Click Extract.
  9. Select the Data type of the certificate. For example, Base64-encoded ASCII data for a file with the .arm extension.
  10. Click Browse to select the name and location of the certificate file name.
  11. Click OK. The certificate is written to the file you specified.

Using the iKeycmd (command line interface)
To extract a certificate in iKeycmd (using UNIX command line), use these commands:

  + gsk7cmd -cert -extract -db filename -pw password -label label -target filename -format ascii

To extract a certificate in iKeycmd (using Windows command line), use these commands:

  + runmqckm -cert -extract -db filename -pw i -label label -target filename -format ascii

where:

  + -db filename is the fully qualified pathname of a CMS key database.

  + -pw password is the password for the CMS key database.

  + -label label is the label attached to the certificate.

  + -target filename is the name of the destination file.


-format ascii is the format of the certificate. The value can be ascii for Base64-encoded ASCII or binary for Binary DER

Top of Page Top of Page