Ask a Question

Advanced Search

Solution ID : SO9271

Last Modified : 05/21/2018

Managed PKI for SSL - Certificate Signing Request (CSR) Generation Instructions for Lotus Domino Server 8.x

Solution


Before you request a certificate from a CA, you must create a key ring file to store the certificates. A key ring file is a binary file that is password-protected and stored on the server's hard drive. When you create a server key ring file (.KYR), IBM® Lotus® Domino™ generates an unsigned server certificate and automatically includes several trusted root certificates. The unsigned server certificate is not valid until it is signed by a certifier. Domino also creates a stash file (.STH) using the same name as the key ring file, but with the file extension .STH. Domino uses the stash file to store the key ring file password for unattended access to the server key ring file.

Every server certificate includes a distinguished name used for SSL connections. You set up this distinguished name when you create the server key ring file. Some components of a distinguished name are optional; however, the more components you include, the less likely you are to encounter an identical name elsewhere on the Internet.
 

To generate a Certificate Signing Request (CSR) file on Domino 8.5 server, please follow the steps below:

Step 1. Create a server key ring

  1. In the Domino Administration client, double-click on Server Certificate Administration.


     
  2. Choose Create Key Ring
  3. When promoted, enter a key ring file name: The default is KEYFILE.KYR. It's helpful to use the extension .KYR to keep key ring file names consistent
  4. Enter a password for your key ring
  5. Specify the key size Domino uses when creating the public and private key pairs. Symantec supports a key size of 2048 bits.
  6. Your Distinguished Name information should be entered as follows:
  • Common Name: The fully-qualified domain name to which your certificate will be issued.
  • Organization: The full legal name of your company.
  • Organizational Unit: Use this field to differentiate between divisions within an organization
  • City or Locality: Usually the city of your organization's main office, or a main office for your organization.
  • State or Province: Enter the full name of your state or province. 
    Note: Make sure the State or Province is not abbreviated (e.g. California)
  • Country: Enter the two-character abbreviation of country in which organization resides (e.g. US)
     
  1. When you click to continue, you should get a message that your key ring file has been created.
  2. After you read the information about the key ring file and distinguished name, click OK.
  3. Verify your CSR

     

Step 2. Create Certificate Signing Request

  1. In the Domino Administration client, double-click on Server Certificate Administration.
  2. At the next screen you will be able to choose to "Create Certificate Request" from your new key ring.
  3. Under Key Ring File Name specify the name of the server key ring file including the path to the file. 
  4. Under Log Certificate Request choose one: Yes (default) to log information in the Server Certificate
    Admin application or No to not log information
  5. Under method, choose to "Paste into form on CA's site."
  6. Enter the password for the server key ring file. 
  7. Copy the CSR (including the BEGIN and END tags) as seen below:

    -----BEGIN CERTIFICATE REQUEST-----

              [encoded data]

    -----END CERTIFICATE REQUEST-----
     
  8. Proceed with the Enrolment from Symantec web site and paste the CSR in the required field.
     

Once the certificate has been issued, follow the steps from this link to install the certificate on your server: INFO1968


IBM

         For additional information, reference to IBM Lotus Domino 8 server documentation 
         (Click Security - SSL security - Setting up SSL on a Domino server).