Managing Azure Keys
This section describes how to manage Azure keys on the CCKM. Before proceeding, you must have an Azure key vault added to the CCKM. Refer to Managing Azure Vaults for details.
Adding Azure Keys
This section describes about the different types of keys and how to create/use these keys. The CCKM allows you to:
Create new local keys on the CipherTrust Manager. Refer to Uploading New Local Keys for details.
Create new Azure native keys. The key material is created by the Azure. Refer to Creating Azure Native Keys for details.
Use existing local keys available on the CipherTrust Manager. Refer to Uploading Existing Local Keys for details.
Uploading New Local Keys
To create a new local Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure.
Click Add Key. The Select Material Origin screen of the Add Azure Key wizard is displayed.
Select Material Origin
Select Upload New Local Key. The CipherTrust Manager will create a new key material locally.
Click Next. The Create CipherTrust Key screen is displayed.
** Create CipherTrust Key**
Enter a Key Name.
Select the Key Size from the available options. The key size can be:
2048
3072
4096
Click Create Key next to the Key Name field. A CipherTrust key is created and displayed on the screen.
Click Next. The Add Labels screen is displayed.
Add Labels
Select the desired Vault.
Enter a user-friendly alias as the Key Name. This helps in uniquely identify a key.
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options. The supported operations are:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully created is displayed on the screen. The newly created key is displayed in the list of Azure keys.
The origin of the key is CCKM
.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Creating Azure Native Keys
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure.
Click Add Key. The Select Material Origin screen of the Add Azure Key wizard is displayed.
Select Material Origin
Select Create Azure Native Key. The Azure will create a native key material.
Click Next. The Add Labels screen is displayed.
Add Labels
Select the desired Vault.
Enter a user-friendly alias as the Key name. This helps in uniquely identify a key.
From the Key Type drop-down list, select the type of the key. The available key types are:
RSA
Elliptic Curve
If the key type is RSA, select Size from the following options: 2048, 3072, and 4096.
If the key type is Elliptic Curve, select Curve from the following options: P-256, P-384, P-521, and SECP256K1.
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options.
If the Key Type is RSA, following operations are supported:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
If the Key Type is Elliptic Curve, following operations are supported:
Sign
Verify
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully created is displayed on the screen. The newly created key is displayed in the list of Azure keys.
The origin of the key is Native
.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Uploading Existing Local Keys
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure.
Click Add Key. The Select Material Origin screen of the Add Azure Key wizard is displayed.
Select Material Origin
Select Upload Existing Local Key. The already existing CipherTrust key material will be used.
Click Next. The Select CipherTrust Key screen is displayed.
Select CipherTrust Key
Select an existing CipherTrust key from the Key Name drop-down list.
Click Next. The Add Labels screen is displayed.
Add Labels
Select the desired Vault.
Enter a user-friendly alias as the Key Name. This helps in uniquely identify a key.
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options. The available options are:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully created is displayed on the screen. The newly created key is displayed in the list of Azure keys.
The origin of the key is CCKM
.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Viewing Azure Keys
To view an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed. The Azure Keys page displays following details:
Field Description Key Name Unique, user-friendly alias of the key. This is useful in searching for specific keys. Current Version Current version of the key. Key Vault Name of the Azure key vault. Region Azure region where the key is created. Status State of the key. The status can be:
• Available
• Soft Deleted
• DeletedAlgorithm Name of the algorithm. Supported algorithms are:
• EC
• RSA
• EC-HSM
• RSA HSMOrigin Source of the key material. The origin of the key can be:
• CCKM: Key material is created on CCKM.
• Native: Key material is created on the Azure cloud.
• External (Unknown): Source of the key material is unknown. It is different than CCKM and the native cloud.Cloud Name of the cloud. Supported clouds are:
• Azure Cloud
• Azure China Cloud
• Azure German Cloud
• Azure US GovernmentCreation Date Time when the key is created.
Sometimes, you might notice certain keys are displayed as grayed out. This happens when the keys are no longer accessible. For example, when:
Any cloud permissions on the keys are changed. The keys are no longer accessible from the Azure connection.
Connection is changed in KMS. The new connection does not have permissions to access the keys.
Editing Azure Keys
To view or edit an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click View/Edit.
Configure the KEY SCHEDULES. Refer to KEY SCHEDULES for details.
KEY SCHEDULES
To configure key schedules:
In the KEY SCHEDULES section, select/enter the following details:
From the Select Rotation Schedule drop-down list, select a rotation schedule.
In the Rotation Settings section, select/enter the following details:
Key origin: Select the key origin from the available options. The key origin can be CipherTrust or Native (Azure).
Key Type: Select the key type. If the key origin is CipherTrust, supported key type is RSA. If the key origin is Native, supported key types are RSA and EC.
If the key type is RSA, select Key Size from the available options.
If the key origin is native and key type is EC, select Elliptical Curve Name from the available options.
Select Enabled if you want to enable the rotated key.
Click Update.
A message Key schedule updated successfully is displayed on the screen.
Rotating Keys (Add Version)
To rotate Azure keys, CCKM Users require Add Key and Upload Key permissions.
To rotate a key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Rotate Now (Add Version).
On the Add New Version screen, Select Key Material Origin. The CCKM allows you to use any of the following key material origin:
Uploading New Local Keys
On the Select Material Origin screen of the Add New Version wizard, select Upload New Local Key. The CipherTrust Manager will create a new key material locally.
Click Next. The Create CipherTrust Key screen is displayed.
** Create CipherTrust Key**
Enter a Key name.
Select the Key Size from the available options. The key size can be:
2048
3072
4096
Click Create Key next to the Key Name field. A CipherTrust key is created and displayed on the screen.
Click Next. The Add Labels screen is displayed.
Add Labels
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options. The Supported operations are:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully rotated is displayed on the screen. Navigate to Cloud Keys > Azure > View/Edit > Versions to view the versions of the rotated Azure key.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Creating Azure Native Keys
On the Select Material Origin screen of the Add New Version wizard, select Create Azure Native Key. The Azure will create a native key material.
Click Next. The Add Lables screen is displayed.
Add Labels
From the Key Type drop-down list, select the type of the key. The available key types are:
RSA
Elliptic Curve
If the key type is RSA, select Size from the following options: 2048, 3072, and 4096.
If the key type is Elliptic Curve, select Curve from the following options: P-256, P-384, P-521, and SECP256K1.
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options.
If the Key Type is RSA, following operations are supported:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
If the Key Type is Elliptic Curve, following operations are supported:
Sign
Verify
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully rotated is displayed on the screen. Navigate to Cloud Keys > Azure > View/Edit > Versions to view the versions of the rotated Azure key.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Uploading Existing Local Keys
On the Select Material Origin screen of the Add New Version wizard, select Upload Existing Local Key. The already existing CipherTrust key material will be used.
Click Next. The Select CipherTrust Key screen is displayed.
Select CipherTrust Key
Select an existing CipherTrust key from the Key Name drop-down list.
Click Next. The Add Labels screen is displayed.
Add Labels
Select Key Attributes. The Key Attributes section contains the following details:
Select the Enable Key check-box.
Select Key Operations from the available options. The available options are:
Encrypt
Decrypt
Sign
Verify
Wrap Key
Unwrap Key
Enter Tags. A tag is a label assigned to the key, which consists of a user-defined key and a value.
To add a tag:
Specify a tag name.
Specify the tag value.
Click the + button.
Similarly, you can add more tags.
Click Save.
A message Azure Key successfully rotated is displayed on the screen. Navigate to Cloud Keys > Azure > View/Edit > Versions to view the versions of the rotated Azure key.
Set Activation Date
To configure the activation date:
Select the Set Activation Date check-box.
From the on-screen calendar, select the date and time to activate the key.
Set Expiration Date
To configure the expiration date:
Select the Set Expiration Date check-box.
From the on-screen calendar, select the key expiration date and time.
Deleting Azure Keys
Non-soft-delete keys can be deleted directly from the Azure vaults using CCKM.
To delete an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Delete.
On the Confirm Delete screen, click Delete.
A confirmation message is displayed on the screen. The key status changes to DELETED
.
Restoring Backup
Note
Restoration of keys among cross-region vaults is not allowed.
To restore an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Restore Backup.
On the Confirm Restore Key screen, click Restore Key.
A message Key <key name>
restored is displayed on the screen. The key status changes to AVAILABLE
.
Deleting Backup
Deleting Backup permanently removes backup of a deleted Azure key from the CCKM.
This operation can be performed only on the keys with DELETED
status.
To delete backup of an Azure key from the CCKM:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Delete Backup.
On the Hard Delete Azure Key screen, select the I wish to delete the backup of this key. check-box.
Click Delete Key Backup.
A message Key <key name>
backup deleted is displayed on the screen. The backup of the key is permanently deleted from the CCKM.
Soft-Deleting Azure Keys
Soft deleting is the process of deleting Azure keys from the Azure vaults and CCKM. These keys still exist on the CCKM and in the Azure vaults. The soft-deleted keys can be recovered.
Note
This operation can be performed only on the Azure keys residing in the soft-enabled key vaults.
To soft-delete an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Soft Delete.
On the Confirm Soft Delete screen, Click Soft Delete.
A message key <key name>
soft-deleted is displayed on the screen. The status of the key changes to SOFT-DELETED
.
Recovering Soft-Deleted Azure Keys
To recover a soft-deleted Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Recover Soft Delete.
On the Confirm Recover Key screen, Click Recover Key.
A message Key <key name>
recovered from soft-delete is displayed on the screen. The status of the key changes to AVAILABLE
.
Purging Azure Keys
Purging is the process of permanently deleting soft-deleted Azure keys from the Azure vaults. However, backup of the purged key can be restored on the CCKM. If you wish to restore backup of the purged key, follow the steps mentioned in the Restoring Backup section.
Note
This operation can be performed only on the soft-deleted Azure keys residing in the soft-enabled key vaults.
To purge an Azure key:
Open the Cloud Key Manager application.
In the left pane, click Cloud Keys > Azure. The list of available Azure keys is displayed.
Click the overflow icon () corresponding to the desired alias and click Purge.
On the Purge Azure Key screen, select the I wish to purge this key. check-box.
Click Purge Key.
A message key <key name>
hard deleted is displayed on the screen. The status of the key changes to DELETED
.