'a' - The Authenticate Command
The authenticate command is specific to the authentication DBM. It allows a person to prove his or her identity to an authentication realm by providing a PUID or alias and a password.
The puidnetd.h symbol for the authenticate command is PUIDNETD_CMD_AUTHC.
The standard keys for the authenticate command are either PUID or alias.
If the specified key is found and the authentication is successful, the reply message will contain a positive acknowledgement
(ACK); if not, a negative
N.B.: a NAK may result even if the
password matches, e.g., if the
account is frozen.
A NAK may be accompanied by these fields. The field symbols come from puidnetd.h.
e -- an error code (PUIDNETD_DATA_ERRC); it accompanies a NAK reply.
M -- a message (PUIDNETD_DATA_MSG); it accompanies a NAK reply.
a p12345678 @Rpurdue Pc2VjcmV0MA== @
Authenticate by providing alias and password:
a ajdoe @Rpurdue Pc2VjcmV0MA== @
Because passwords are sent unencrypted, authentication requests must use an SSL connection. Authentication requests sent over a non-SSL connection are rejected with the error PUIDNETD_EORSSLC:
Error: Operation requires SSL connection (42)