Certificate management
Venafi Control Plane

Configure Venafi Control Plane Cryptohub integratation

13min

This section covers the following integration cinfiguration tasks:

  • Create an HSM connector and generate a key
  • Enable Vebafi Key Protect
  • Generate and HSM private key
  • Configure code signing

Create an HSM connector and generate an HSM-Protected encryption key

1

Open the Venafi Configuration Console application.

2

Select the Connectors node.

3

Select [ Create HSM Connector ] in the Actions panel.

4

Enter the local master admin username and password and click [ OK ]. This will pull up the Create new HSM (Cryptoki) Connector window.

5

Specify a Name for the HSM connector.

6

For Cryptoki Dll Path, select [ Browse... ] and select the Futurex PKCS #11 DLL file at the following path:

Text

7

Click [ Load Slots ].

8

Select the slot number configured in the FXPKCS11 configuration file (the default is slot 0). This is where Venafi Control Plane will access the encryption keys.

9

For User Type, leave the default option selected, Crypto Officer (User). Venafi will use the identity configured inside the FXPKCS11 configuration file when connecting to the .

10

For Pin, enter the identity password configured inside the <CRYPTO-OPR-PASS> tag in the fxpkcs11.cfg file.

11

Select [ Verify ].

12

If the connection to the is successful, a new Permitted Keys section will populate in the window.

13

Select [ New Key... ]. This will open the Create New HSM Key window.

14

Enter a Name and select the Type for the key, then click [ Create ].

15

If key creation is successful, the key is now viewable inside the Venafi Control Plane service on the . the name of the key is shown in the list of Permitted Keys in the Create New HSM Key window.

If you plan to use Venafi CodeSign Protect to store private code signing keys on the , select the Allow Key Storage checkbox here.

16

Select [ Create ] to save and close the window.

Enable Venafi Advanced Key Protect

Venafi Advanced Key Protect is required for HSM Private Key Generation. In addition, Venafi Code Signing Certificate Private Key Storage requires this feature to be enabled. To enable Venafi Advanced Key Protect:

1

Open the Venafi Configuration Console application.

2

Select [ Enable Venafi Advanced Key Protect... ] in the Actions panel.

3

Enter the local master admin username and password and click [ OK ].

4

Review the information in the following dialog, and select [ Enable ] if you wish to proceed.

5

Restart the IIS, Venafi Platform, and Logging services.

  • Select the Product node.
  • Select Website and then click [ Restart ] in the Actions panel.
  • Select Venafi Platform and then click [ Restart ] in the Actions panel.
  • Select Logging and then click [ Restart ] in the Actions panel.

Generate HSM Private Key

Venafi Trust Protection Platform uses the for private key generation for SSH keys and certificates.

Certificate Authority (CA) template objects are used in Venafi Control Plane to manage the certificate lifecycle. Creating one is a prerequisite to HSM Key Generation. See Venafi documentation for more information.

Configure the Venafi platform policy to enable the for HSM key generation

1

Log in to the admin console: https://[IP_address_of_Venafi_TPP]/vedadmin

2

Select Policy Tree in the main menu at the top of the page.

3

In the Policy : Certificate window, select the Certificate tab.

4

Under Other Information:

  • Select the name of the HSM Connector you created for the in the Key Generation drop-down menu.
  • Select the name of the HSM-Protected Encryption Key you created on the .
5

Click the [ Save ] button at the bottom of the page.

Generate the certificate

1

Select Policy Tree in the main menu at the top of the page.

2

On the left hand side of the page, click the [ Add ] button under the Policy dropdown and select Certificates > Certificate.

3

Under General Information, enter the required information, and for Management Type, select Provisioning or Enrollment.

4

Under CSR Handling, leave Service Generated CSR selected for CSR Generation and leave Generate Key/CSR on Application set to No.

5

Under Subject DN, enter the required information.

6

Under Private Key, select the Key Algorithm to use and the desired Key Strength in bits.

7

Under Other Information, search for and select the previously configured CA Template.

8

Click the [ Save ] button.

9

Select the newly generated certificate from the policy tree. The Certificate Status should be OK.

10

Select [ Renew Now ]. The Certificate Status will change to Queued for renewal.

11

After about a minute, click [ Refresh ]. The certificate details will appear in the window.

12

If you selected Provisioning as the Management Type, associate the certificate to the intended application object.

Configure code signing

Venafi CodeSign Protect can store private code signing keys in the . This section describes the basic steps to configure this functionality for the integration. See Venafi documentation for more details.

Certificate Authority (CA) template objects are used in Venafi Control Plane to manage the certificate lifecycle. Creating one is a prerequisite to CodeSign. See Venafi documentation for more information.

To use an HSM for key storage, Key Storage must be enabled on the HSM Connector.

Assign permissions to a Code Signing administrator

1

Open the Venafi Configuration Console application.

2

Select the System Roles node.

3

Select [ Add CodeSign Protect Administrator ] in the Actions panel.

4

Select a user to grant CodeSign Protect Administrator permissions.

Create a Code Signing flow

1

Open the Venafi Configuration Console application.

2

Under the Code Signing node, select Custom Flows.

3

Select Add new Code Signing Flow in the Actions panel.

4

Enter a name for the Code Signing Flow.

5

Select the newly created Code Signing Flow and add an approver through the Actions panel.

Create an environment template for the Code Signing Project

1

Open the Venafi Configuration Console application.

2

Under the Code Signing node, select Environment Templates.

3

Select Certificate in the Actions panel under Add Single Template.

4

Enter a name for the Code Signing Environment Template and select [ Create ].

5

In the Settings tab of the Properties window, enter a Description and select a Certificate Container and Signing Flow.

6

Go to the Certificate Authority tab and select a CA Template, then select [ Add ].

7

Go to the Keys tab and select which key sizes to allow for RSA and Elliptic Curve keys.

8

Open the Key Storage tab and select the Futurex HSM Connector, and select [ Add ].

9

Enter any optional information in the remaining tabs, and select [ OK ].

Create a new Code Signing Project

1

Log in to Aperture: https://[IP_address_of_Venafi_TPP]/aperture/codesign

2

Select Projects in the main menu at the top of the page.

3

Select [ Create Project ].

4

Enter a Project Name and Description.

5

Select [ Create ].

Create an environment for the project with a new HSM private key and certificate

1

Inside the newly created Code Signing Project, go to the Environments tab and select Add Environment > Certificate & Key.

2

Enter the Environment Name.

3

Select the Environment Template you created for this Code Signing project.

4

For Creation Type, select Create New.

The Key Storage Location should now list the Futurex HSM Connector.

5

Enter any other necessary information for the certificate.

6

Select [ Save ].

7

Select [ Submit For Approval ] to generate a new certificate and private key once it is approved.

Approve the Project

1

Log in to Aperture: https://[IP_address_of_Venafi_TPP]/aperture/codesign

2

Select Approvals in the main menu at the top of the page.

3

Under Pending Approvals, select the Project Creation request you just submitted.

4

Select [ Approve ].

Go back to the project, and under the Environments tab you should see that a Certificate & Key were created in Hardware (such as the ).