Home >

Utilities Reference Guide > Certificate Management Utility (CMU) > cmu selfsigncertificate

cmu selfsigncertificate

This function creates a self-signed X.509 certificate for an RSA, DSA, or ECDSA key pair on the token or HSM. It must be provided with the handles to both the public key and the corresponding private key (all of the public key components are contained within the private key). The private key must have Signing capability since it is used to sign the certificate request structure. The signature is done with any of the mechanisms listed below. The subject name is defined by a series of optional RDN components.

If none of these components are provided on the command line, the CKA_SUBJECT of the private key is used as the subject of the certificate. If the private key does not have its CKA_SUBJECT attribute set, the user will be queried for each of the RDN components. The Subject DN should contain at least the country, organization and common name components.

The certificate will, by default, have a keyUsage setting of keycertsign. The certificate is stored as a PKCS #11 certificate object on the token. The CKA_ID attribute of the certificate is defined by an optional parameter. If this parameter is omitted, the CKA_ID of the private key is used.

Syntax

cmu selfSignCertificate <parameters>

Required Parameters

Parameter Description
-publichandle=<pubkeyhandle#>

 This is a mandatory parameter that defines the handle to the public key from an RSA key pair to be certified. If this parameter is omitted and there is only one public signing key on the HSM, that key is automatically selected. If this parameter is omitted and there are multiple public signing keys on the HSM, the user is asked to select the public signing key.

-privatehandle=<privkeyhandle#>

 This is a mandatory parameter that defines the handle to the private key from an RSA key pair to be certified. If this parameter is omitted and there is only one private signing key on the HSM, that key is automatically selected. If this parameter is omitted and there are multiple private signing keys on the HSM, the user is asked to select the private signing key.

-startDate

 This parameter defines the validity start of the certificate, in the format YYYYMMDD.

-endDate

 This parameter defines the validity end of the certificate, in the format YYYYMMDD.

-serialNumber

 This parameter defines the serial number of the certificate, in big-endian hexadecimal form.   

Optional Parameters

Parameter Description
-keyusage

 This is an optional parameter that defines the key usage extension for the certificate. It can be set to any of the following: digitalsignature, nonrepudiation, keyencipherment, dataencipherment, keyagreement, keycertsign, crlsign, encipheronly, decipheronly. This parameter may appear more than once in the parameter set to define multiple usages, or it can be used once with a comma separated list of usage types. If no key usage is specified, a default setting of keycertsign is used.

-label

 This is an optional parameter that defines the CKA_LABEL attribute for the certificate object that gets created on the HSM. If omitted, the common name of the issuer and subject DN is used instead.

-id

 This is an optional parameter that defines the CKA_ID attribute for the certificate object that gets created on the HSM. If omitted, the CKA_ID attribute of the private key is used instead.   

-md5WithRsa

 This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-MD5withRSAEncryption.

Default: SHA256withRSAEncryption

-sha1WithRsa

 This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-SHA1withRSAEncryption.

Default: SHA256withRSAEncryption

- sha224withrsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha224withRSAEncryption.

Default: SHA256withRSAEncryption

- sha256withrsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha256withRSAEncryption.

Default: SHA256withRSAEncryption

- sha384withrsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha384withRSAEncryption.

Default: SHA256withRSAEncryption

- sha512withrsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha512withRSAEncryption.

Default: SHA256withRSAEncryption

- sha1withdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha1withDSAEncryption.

Default: SHA256withRSAEncryption

- sha1withecdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha1withECDSAEncryption.

Default: SHA256withRSAEncryption

- sha224withecdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha224withECDSAEncryption.

Default: SHA256withRSAEncryption

- sha256withecdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha256withECDSAEncryption.

Default: SHA256withRSAEncryption

- sha384withecdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha384withECDSAEncryption.

Default: SHA256withRSAEncryption

- sha512withecdsa

This is an optional parameter that defines the signature algorithm for the certificate request to be pkcs-1-sha512withECDSAEncryption.

Default: SHA256withRSAEncryption

-C

 This optional parameter defines the two-letter country name for the subject distinguished name (DN) and issuer Distinguished Name of the certificate. This parameter should be present in each DN.

-S

This optional parameter defines the state or province name for the subject DN and issuer DN of the certificate. This parameter may be present in each DN.

-L

   This optional parameter defines the locality (typically the city) for the subject DN and issuer DN of the certificate. This parameter MAY be present in each DN.

-O

   This optional parameter defines the organization name for the subject DN and issuer DN of the certificate. This parameter SHOULD be present in each DN.

-OU

 This optional parameter defines the organization unit name for the subject DN and issuer DN of the certificate. This parameter MAY be present in each DN.

-CN

This optional parameter defines the common name for the subject DN and issuer DN of the certificate. This parameter SHOULD be present in each DN.

Example

The following example creates a self-signed certificate for RSA key 4:

cmu selfSign -publichandle=4 –privatehandle=5 -C=CA -O=Rainbow-Chrysalis -CN="Test Root Certificate" 
-startDate=20120101 -endDate=20151231 -serialNum=0133337f