Deletes a key from a Hardware Security Module (HSM). You can delete one key per command.
Prerequisites
Before you begin, make sure that you have:
Started
key_mgmt_toolLogged in to the HSM as a Crypto User (CU)
Usage notes
Only the key owner can delete a key. Users who have access to a shared key can use it for encryption but cannot delete it.
Deleting one key from a key pair does not affect the other key in the pair.
Syntax
deleteKey -kImportant
Enter parameters in the order shown in the syntax.
Parameters
For details on parameters, see Parameters.
| Parameter | Description | Required | Valid values |
|---|---|---|---|
-k | Key handle of the key to delete. Use findKey to get the key handle. | Yes | A valid key handle integer |
Examples
Delete a key
Deletes the key with handle 6.
deleteKey -k 6Output:
Cfm3DeleteKey returned: 0x00 : HSM Return: SUCCESS
Cluster Status:
Node id 0 status: 0x00000000 : HSM Return: SUCCESSRelated topics
findKey— Find key handles before deleting keys