keyring reset
Reset a keyring to its initial conditions (erase all objects, reset label, initial password set to PASSWORD). You must then re-initialize the keyring and set a new KRCO password.
NOTE Thales requires minimum Luna Appliance Software 7.8.5 with the lnh_cluster-1.0.4 package, Luna HSM Firmware 7.8.4, and Luna HSM Client 10.7.2 to use clusters in production environments.
REST API: PATCH /api/keyrings/{keyringID}
User Privileges
Users with the following privileges can perform this command:
>Admin
Syntax
keyring reset [-copassword <password>] [-keyringid <string>] [-label <name>] [-force]
| Argument(s) | Shortcut | Description |
|---|---|---|
| -copassword | -c | Specifies the keyring CO password. If this option is omitted on a password-authenticated HSM, LunaSH prompts for the password. If this option is included on a multifactor quorum-authenticated HSM and the partition is not activated, it is ignored. |
| -force | -f | Reset the keyring without asking for confirmation. |
| -keyringid | -k | Specifies the UUID of the keyring to be reset. Use lunash:> keyring list to display a list of available keyrings and their UUIDs. |
| -label | -l | Specifies the label of the keyring to be reset. |
Example
lunash:>keyring reset -label keyring00 -co IamtheKRCO WARNING !! This command will reset keyring keyring00. This will delete all objects belonging to the keyring. If you are sure that you wish to proceed, then type 'proceed', otherwise type 'quit' proceed Proceeding... Keyring 728e8b21-81d5-49fc-ba77-2ebb22e7e25e was successfully reset. Command Result : 0 (Success)
