Versasec vSEC:CMS

Versasec vSEC:CMS S-Series is a card management system that runs on a Windows Server. The vSEC:CMS software uses the Web Service API in EJBCA to integrate the PKI seamlessly with the CMS. During the card issuance and revocation, the vSEC:CMS makes web service calls to EJBCA to issue and revoke certificates.

Prerequisites

The following are required for the integration:

• EJBCA version 6.15.0 or later

• Versasec vSEC:CMS S-Series version 5.8 and upwards

Step 1: Create Certificate for vSEC:CMS

Issuing a certificate for vSEC:CMS is done using the EJBCA RA Web. Note that profiles are required to exist and be properly configured in EJBCA. For more information, see Certificate Profiles Overview.

To issue a certificate for vSEC:CMS, log in as a suitable Administrator with permission to issue other RA Admin certificates, and do the following:

1. Go to the RA Web and select Make New Request.

2. Specify the fields to issue a PKCS#12 keystore.
   The following example uses server-side generated keys, but client generated keys work just as well.
   

   

   
   

   

   
   
   

Step 2: Create a Role for vSEC:CMS

In order for the vSEC:CMS to be able to issue and revoke certificates, it must be added to a role to provide necessary privileges.

To create an RA Administrator role with privileges to issue and revoke the desired certificates, do the following:

1. In EJBCA Admin Web, select System Functions > Administrator Roles.

2. Click Add, specify a Role name, in this example Versasec CMS, and click Save.
   

   

3. When the Versasec CM group is created, click Access Rules.

4. Select the RA Administrator role template, specify the settings according to the following example, and click Save.
   

   

Step 3: Add Certificate to Role

With the role created, add the certificate created for the vSEC:CMS to the newly created role by editing the members of the role and clicking Add.

Step 4: Install vSEC:CMS

Install Versasec vSEC:CMS according to the installation instructions in the Administration Guide provided with the S-Series installation installer.

Note that an Active Directory must be available in order for vSEC:CMS to manage users which should get cards issued.

Step 5: Configure EJBCA in vSEC:CMS

Finally, configure EJBCA in vSEC:CMS:

1. Install the issued certificate in the Windows server where vSEC:CMS is running.

2. Create a new connection to a CA, entering the web service URL of the EJBCA instance to connect to EJBCA and list the available profiles

Note that vSEC:CMS has native support for EJBCA and allows you to select EJBCA from the CA types list.

For more information on adding connections, refer to the Versasec documentation on vSEC:CMS S-Series Documentation - Connections.

The URL for the EJBCA Web Service API is: https://<ejbca-server-hostname>/ejbca/ejbcaws/ejbcaws?wsdl.

The integration is now completed, and you can start using Versasec vSEC:CMS to issue cards with certificates from your EJBCA Certificate Authority.

Multiple CA connections can be added to issue different cards and certificates from different CAs.