Issuing Subsystem Certificate with CMC

Overview

This document describes the process for a CA agent to issue a subsystem certificate with CMC in PKI 10.5 or later.

This process assumes that the CA agent has performed PKI CLI Initialization.

Creating CMC Request

To create a CMC request prepare the following configuration file (e.g. subsystem-cmc-request.cfg):

# NSS database directory where CA agent certificate is stored.
dbdir=$HOME/.dogtag/nssdb

# NSS database password.
password=Secret.123

# Token name (default is internal).
tokenname=internal

# Nickname for CA agent certificate.
nickname=caadmin

# Request format: pkcs10 or crmf.
format=pkcs10

# Total number of PKCS10/CRMF requests.
numRequests=1

# Path to the PKCS10/CRMF request.
# The content must be in Base-64 encoded format.
# Multiple files are supported. They must be separated by space.
input=subsystem.csr

# Path for the CMC request.
output=subsystem-cmc-request.bin

Then execute the following command:

$ CMCRequest subsystem-cmc-request.cfg

Submitting CMC Request

To submit a CMC request prepare the following configuration file (e.g. subsystem-cmc-submit.cfg):

# PKI server host name.
host=pki.example.com

# PKI server port number.
port=8443

# Use secure connection.
# For secure connection with ECC, set environment variable 'export NSS_USE_DECODED_CKA_EC_POINT=1'.
secure=true

# Use client authentication.
clientmode=true

# NSS database directory where CA agent certificate is stored.
dbdir=$HOME/.dogtag/nssdb

# NSS database password.
password=Secret.123

# Token name (default: internal).
tokenname=internal

# Nickname of CA agent certificate.
nickname=caadmin

# CMC servlet path
servlet=/ca/ee/ca/profileSubmitCMCFull?profileId=caCMCsubsystemCert

# Path for the CMC request.
input=subsystem-cmc-request.bin

# Path for the CMC response.
output=subsystem-cmc-response.bin

Then execute the following command:

$ HttpClient subsystem-cmc-submit.cfg

Processing CMC Response

To convert CMC response into PKCS #7 cert chain:

$ CMCResponse -i subsystem-cmc-response.bin -o subsystem.crt

See Also

• CMC Responder

• CMC Tools

• PKCS7

• Installing Standalone KRA