Download OpenVMS System Services Reference Manual: GETUTC–Z

Transcript
System Service Descriptions
$HASH_PASSWORD
hash
OpenVMS usage:
type:
access:
mechanism:
quadword_unsigned
quadword (unsigned)
write only
by reference
Output hash value representing the encrypted password. The hash argument is
the address of an unsigned quadword to which $HASH_PASSWORD writes the
output of the hash. If you use the UAI$C_AD_II algorithm, the second longword
of the hash is always set to 0.
Description
The Hash Password service applies the hash algorithm you select to an ASCII
password string and returns a quadword hash value that represents the
encrypted password.
Other OpenVMS password services allow spaces, tabs, and other blank characters
from the user, but they remove those spaces before passing the string to $HASH_
PASSWORD. Before calling $HASH_PASSWORD, all white space must be
removed from the password string to ensure proper comparison with passwords
created by other services.
Required Access or Privileges
None
Required Quota
None
Related Services
$GETUAI, $SETUAI.
Use $GETUAI to get the values for the salt and alg arguments. Use $SETUAI to
store the resulting hash using the item codes UAI$_PWD and UAI$_PWD2.
For more information, see the appendix on implementing site-specific security
policies in the OpenVMS Programming Concepts Manual.
Condition Values Returned
SS$_NORMAL
SS$_ACCVIO
SS$_BADPARAM
SYS2–40
The service completed successfully.
The input or output buffer descriptors cannot be
read or written to by the caller.
The specified hash algorithm is unknown or
invalid.