CSR-IBM Lotus Domino 6, 7, or 8

The CSR needs to contain the following attributes:

- Country Name (C): Use the two-letter code without punctuation for country, for example: US or CA.
- State or Province (S): Spell out the state completely; do not abbreviate the state or province name, for example: California.
- Locality or City (L): The Locality field is the city or town name, for example: Berkeley.
- Organization (O): If your company or department has an &, @, or any other symbol using the shift key in its name, you must spell out the symbol or omit it to enroll, for example: XY & Z Corporation would be XYZ Corportation or XY and Z Corportation.
- Organizational Unit (OU): This field is the name of the department or organization unit making the request.
- Common Name (CN): The Common Name is the Host + Domain Name. It looks like “www.company.com” or “company.com”.

Note: VeriSign certificates can only be used on Web servers using the Common Name specified during enrollment. For example, a certificate for the domain “domain.com” will receive a warning if accessing a site named “www.domain.com” or “secure.domain.com”, because ”www.domain.com” and “secure.domain.com” are different from “domain.com”.

To generate a Certificate Signing Request (CSR) file using IBM Lotus Domino 6, 7, or 8 server, follow the steps below:

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.

Note: If you are requesting a server certificate from a server-based certification authority, you can use the IBM® Lotus® Notes® client to create the server key ring and request a server certificate in the Certificate Requests database.

Step 1: To create a server key ring file

1. Set up the Server Certificate Admin application.

2. From the Lotus Notes client, open the Server Certificate Admin application on the server for which you want to enable SSL.

3. Click “Create Key Ring.”

4. Complete these fields:

Field Action
Key Ring File Name Enter the key ring file name. The default is KEYFILE.KYR. It’s helpful to use the extension .KYR to keep key ring file names consistent.

Note: The server’s key ring file name appears in any Internet Site documents that you have configured, or, if Internet Site documents are not being used, on the Ports – Internet Ports tab of the Server document. If you specified a name other than the default, you need to edit the name where it appears – in the Internet Site documents or in the Server document.

Key Ring Password Enter the password for the key ring.
Key Size Specify the key size Domino uses when creating the public and private key pairs. The larger the size, the stronger the encryption.

Note: VeriSign prefers at least 1024-bit key size, 2048 for EV certificates.

Common name Enter the server’s TCP/IP fully-qualified domain name — for example, www.mycompany.com.

Set up the server certificate so that the common name matches the host name since some browsers check for this match before allowing a connection.

Organization Enter the name of the organization — for example, a company name, such as Acme.
Organizational Unit (Optional) Enter the name of certifier division or department.
City or Locality Enter the organization city or locality.
State or Province Enter the full name of the state or province in which the certifier organization resides.

Note: Make sure the State or Province is not abbreviated — for example, California (not CA).

Country Enter the two-character abbreviation of country in which organization resides.

5. Click “Create Key Ring.”

6. After you read the information about the key ring file and distinguished name, click OK. Lotus Notes creates the key ring file and stash (.STH) file and places them in the Lotus Notes data directory on the client machine used to create the key ring.

7. Copy the key ring file and stash (.STH) file to the Domino data directory on the server.

Caution: You must ensure that the key ring password in the stash file is protected. The key ring file password is altered in the stash file so that it cannot be recognized by a casual observer, but it is not encrypted. You should not allow unauthorized persons access to either the stash file or the key ring file. In the normal course of operation, only the server itself should have access to those files; however, administrators may also need permission to remove or replace the files. As with all server resources, managing proper file permissions and protections is vital to the security of the system.

Step 2: Requesting an SSL server certificate

1. From the Lotus Notes client, open the Server Certificate Admin application on server for which you want to set up SSL.

2. Click “Create Certificate Request.”

3. Complete these fields:

Field Enter
Key Ring File Name The name of the server key ring file including the path to the file.
Log Certificate Request Choose one:

  • Yes (default) to log information in the Server Certificate Admin application.
  • No to not log information.
Method Choose one:

  • Paste into form on CA’s site (recommended)
  • Send to CA by e-mail

Note: You must choose the paste option to submit a request to VeriSign, which doesn’t use PKCS format for requests sent by e-mail. If you choose “Send to CA by e-mail,” enter the CA’s e-mail address, and your e-mail address, phone number, and location.

4. Click “Create Certificate Request.”

5. Enter the password for the server key ring file.

6. If you selected “Paste into form on CA’s site” in Step 4, do the following:

Copy the certificate request to the system Clipboard (include the Begin Certificate and End Certificate lines).
Use a browser to visit the CA’s site, and then follow the instructions that the CA’s site provides for submitting a request for a new certificate.

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


VeriSign, Inc. has made efforts to ensure the accuracy and completeness of the information in this document. However, VeriSign, Inc. makes no warranties of any kind (whether express, implied or statutory) with respect to the information contained herein. VeriSign, Inc. assumes no liability to any party for any loss or damage (whether direct or indirect) caused by any errors, omissions, or statements of any kind contained in this document.  Further, VeriSign, Inc. assumes no liability arising from the application or use of the product or service described herein and specifically disclaims any representation that the products or services described herein do not infringe upon any existing or future intellectual property rights. Nothing herein grants the reader any license to make, use, or sell equipment or products constructed in accordance with this document. Finally, all rights and privileges related to any intellectual property right described herein are vested in the patent, trademark, or service mark owner, and no other person may exercise such rights without express permission, authority, or license secured from the patent, trademark, or service mark owner. VeriSign Inc. reserves the right to make changes to any information herein without further notice.