This topic explains how to change a user's password on HSM using the changePswd command.
Feature description
The changePswd command allows for the modification of an existing user's password on HSM. Users have the capability to change their own passwords.
The Cryptographic Officer (CO) is authorized to change the password of another CO or a Cryptographic User (CU).
Current password entry is not required to implement the change.
Prior to executing this command, initiate the hsm_mgmt_tool, log on to the HSM, and verify that the user type of the logged-in user is permitted by the command.
User types
The following user types are eligible to execute this command. For user type descriptions, see HSM User Permissions Table.
Administrator (CO)
Cryptographic User (CU)
Provisional Administrator (PRECO)
Syntax
Enter the parameters as per the syntax provided below. To conceal the password, opt for the -hpswd parameter instead of the actual password and follow the subsequent prompts. For additional details, see Parameters.
changePswd <user-type> <user-name> <password |-hpswd>
Parameters must be entered in the sequence outlined by the syntax.
Example
As an illustration, this section demonstrates changing the password for the administrator (CO) named 'admin'.
Utilize the info command to gather information about each HSM in the cluster, including the username and user type of the logged-in user.
cloudmgmt>info server 0 Id Name Hostname Port State Partition LoginState 0 172.16.0.2 172.16.0.2 2225 Connected 192168123006 Logged in as 'admin(CO)'
Proceed to change the password.
cloudmgmt>changePswd CO admin newPassword
Parameters
Parameter Name | Description | Required | Valid Values |
<user-type> | Specifies the type of user whose password is to be changed. | Yes |
Note Refer to the HSM User Permissions Table for user type descriptions. |
<user-name> | The username for which the password is being changed. This parameter is case-insensitive. | Yes | No Special Requirements |
<password | -hpswd > | The new password for the user. It must be a string of 7 to 32 characters and is case-sensitive. Typing the password will display it in plaintext. To conceal the password, use the | Yes | No Special Requirements |