The getstringpasswd() function prompts the user for a password and compares the answer against the previously encrypted password.
The user’s failure to provide the correct password does not automatically result in a rejection of the secured task request. The policy should examine the result of the getstringpasswd() function and respond accordingly.
result = getstringpasswd(encryptedpassword[, prompt [, attempts]]);
|encryptedpassword||Required. An encrypted password, which can be generated by pbpasswd. The clear text form of this password is the password that the user is expected to enter.|
|prompt||Optional. A user prompt that describes the desired password. If none is specified, then the default prompt Password: is used.|
|attempts||Optional. Number of attempts the user gets to specify the correct password. The default value for attempts is 3.|
|true||The answer matched the password.|
|false||The answer did not match the password.|
result = getstringpasswd(<encrypted string>, "Please enter the Backup Task Password: ", 2);
In this example, result contains true if the user enters the correct Backup Task Password. If the correct password is not entered in two attempts, the function sets result to false.