Entrust Datacard

Entrust Certificate Services Support Knowledge Base

Last Modified: 2017-03-01 09:36:31.0

How to create a Private Key, CSR and Import Certificate on Microsoft Azure KeyVault (Cloud HSM)

Article Number: 70600

User-added image

Purpose: How to create a Private Key, CSR and Import Certificate on Microsoft Azure KeyVault (Cloud HSM)

User-added image

Requirements
1. You must have an active Microsoft Azure account.
2. You must have selected either the Free or HSM (paid) subscription option. These steps will work for either Microsoft Azure account type.
3. Microsoft Azure PowerShell must be installed. You can download it here.

The solution is in three parts:
1) Login and Create a Resource Group
2) Creating a Private Key and Certificate Signing Request (CSR)
3) Importing the Public Signed Certificate to Microsoft Azure KeyVault

Part 1 of 3: Login and Create a Resource Group

1. Launch Microsoft Azure PowerShell.

2. Log in to your Microsoft Azure account by typing:

Login-AzureRmAccount

User-added image

You will be prompted to enter your credentials to log in to your account. Once you login successfully you will see something like the below:

User-added image

3. Determine your Resource Group. If you already have an existing Resource Group, you can skip this step. Otherwise, to create a resource group you need to provide the pieces of information shown below:

 EntityDescription  Example
 Resource Group NameThis is the name you choose for your Resource Group.  ECSTestCertificatesGroup
 LocationGeographic location for your key.  Canada Central


To create a new resource group, use the command below:

New-AzureRMResourceGroup -Name 'ECSTestCertificatesGroup' -Location 'Canada Central'

User-added image

4. Determine your keyvault. If you do not have an existing keyvault, you will need to generate one.
To create a new keyvault follow the command line below:

New-AzureRmKeyVault -VaultName '<your Vault Name>' -ResourceGroupName '<your Group Name>' -Location '<your Location>' -SKU 'Premium'

Where:

 EntityDescription  Example
VaultNameYour own Vault Name. This name is unique. Microsoft Azure will reject your Vault Name if someone else has already registered that name in the Cloud.MyNewECSKeyVault
ResourceGroupNameYour own Group Name (chosen in Step 3).ECSTestCertificatesGroup
LocationGeographic location for your key.Central Canada


User-added image

1. Make sure you are still logged into your Microsoft Azure account from PowerShell.

2. Set the parameters for your certificate policy by using the following commands:

$vaultName = '<your Vault Name>'
$certificateName = '<your Certificate Name>'

$manualPolicy = New-AzureKeyVaultCertificatePolicy -SubjectName "<your FQDN>" -ValidityInMonths 24 -IssuerName Unknown


Where:

 EntityDescription  Example
$vaultNameYour Vault Name.MyNewECSKeyVault
$CertificateNameYour own designated Certificate Friendly Name.MyCSCertificate
-subjectNameYour Fully Qualified Domain Name (FQDN).CN=www.testcertificates.com


User-added image

3. Execute the Certificate Operation Command:

$certificateOperation = Add-AzureKeyVaultCertificate -VaultName $vaultName -Name $certificateName -CertificatePolicy $manualPolicy

User-added image

Your private key has been generated. To view your private key inside KeyVault, use the command:

Get-AzureKeyVaultKey -VaultName 'MyNewECSKeyVault'

4. Generate Certificate Signing Request (CSR) by using the below command:

$certificateOperation.CertificateSigningRequest

User-added image

You have successfully created the CSR and are ready to create the certificate. This is the CSR you will use to create the certificate in either your ECS Enterprise Account or during the ordering process if you are requesting an individual Code Signing certificate.
 

After completing the creation of your certificate using either your ECS Enterprise account, or by completing the individual certificate purchase on our website, follow these steps to successfully import the Public Signed Certificate to Microsoft Azure KeyVault:

1. Download your certificate, which will be delivered in a .zip format.

2. Unzip the file and store it to your local drive so you may import it to Microsoft Azure Keyvault.

3. Import the certificate to Microsoft Azure KeyVault using the command:

Import-AzureKeyVaultCertificate -VaultName $vaultName -Name $certificateName -FilePath

Where:

 EntityDescription  Example
$VaultNameYour Vault Name.MyNewECSKeyVault
$CertificateNameYour Certificate Friendly NameMyCSCertificate
FilePathLocation in your drive where you store your downloaded certificate file.C:\azuretest\ServerCertificate.crt

User-added image

You have successfully imported your certificate into your Microsoft Azure KeyVault Cloud HSM.

Note that at this time Microsoft Azure does not allow direct signing from within keyvault. Applications that use a keyvault must authenticate by using a token from Azure Active Directory. That means the usage of keyvault is limited to Azure Cloud environment only and cannot be used for third party application outside this realm. For more information, see this article by Microsoft.

For best practices regarding the protection of private keys related to Code Signing certificates, please see our Best Practices article here.

If you have any questions or concerns please contact the Entrust Certificate Services Support department for further assistance: 

Hours of Operation: 
Sunday 8:00 PM ET to Friday 8:00 PM ET 
North America (toll free): 1-866-267-9297 
Outside North America: 1-613-270-2680 (or see the list below) 
NOTE: It is very important that international callers dial the UITF format exactly as indicated. Do not dial an extra "1" before the "800" or your call will not be accepted as an UITF toll free call.
 

CountryNumber
Australia0011 - 800-3687-7863
1-800-767-513
Austria00 - 800-3687-7863
Belgium00 - 800-3687-7863
Denmark00 - 800-3687-7863
Finland990 - 800-3687-7863 (Telecom Finland)
00 - 800-3687-7863 (Finnet)
France00 - 800-3687-7863
Germany00 - 800-3687-7863
Hong Kong001 - 800-3687-7863 (Voice)
002 - 800-3687-7863 (Fax)
Ireland00 - 800-3687-7863
Israel014 - 800-3687-7863
Italy00 - 800-3687-7863
Japan001 - 800-3687-7863 (KDD)
004 - 800-3687-7863 (ITJ)
0061 - 800-3687-7863 (IDC)
Korea001 - 800-3687-7863 (Korea Telecom)
002 - 800-3687-7863 (Dacom)
Malaysia00 - 800-3687-7863
Netherlands00 - 800-3687-7863
New Zealand00 - 800-3687-7863
0800-4413101
Norway00 - 800-3687-7863
Singapore001 - 800-3687-7863
Spain00 - 800-3687-7863
Sweden00 - 800-3687-7863 (Telia)
00 - 800-3687-7863 (Tele2)
Switzerland00 - 800-3687-7863
Taiwan00 - 800-3687-7863
United Kingdom00 - 800-3687-7863
0800 121 6078
+44 (0) 118 953 3088

Affected Products:

  • Entrust GetAccess Runtimes 7.1 English Solaris
  • Entrust GetAccess Runtimes 7.1 English Windows