Home >

LunaCM Command Reference Guide > LunaCM Commands > role > role changePw

role changepw

Change the password for a specified role.

Syntax

role changePW -name <string> [-oldpw <string>] [-newpw <string>] [-prompt] [-force]

Parameter Shortcut Description
-name -n role to change password for
-oldpw -old current password
-newpw -new new password
-prompt -p prompt for challenges (challenges will be hidden by *)
-force -f Force the action. Use this option to bypass the warning about primary/secondary credentials on a PED-authenticated HSM, as shown in the example.

Example

lunacm:> role changePW -name Administrator -prompt

        A role must be logged in to change password.

Error in execution: command cancelled.

Command Result : 0xb (User Cancelled Operation)

lunacm:> role login -name SO

        Please attend to the PED.

Command Result : No Error

lunacm:> role changePW -name SO -prompt

        Warning: this role has no secondary credentials.
                -prompt parameter will be ignored.

        Type 'proceed' to continue, or 'quit' to quit now -> proceed

        Please attend to the PED.

Command Result : No Error

Using the -force option
lunacm:> role changepw -oldpw PASSWORD -newpw userpin -name Crypto Officer
 
This role has secondary credentials.
You are about to change the secondary credentials.
Are you sure you wish to continue?
 
Type 'proceed' to continue, or 'quit' to quit now -> proceed
Please attend to the PED.
Command Result : No Error
 
lunacm:> role changepw -oldpw PASSWORD -newpw userpin2 -oldpw userpin -name Crypto Officer -force
 
Please attend to the PED.
Command Result : No Error