NAME

       WebAuth::Token::Login - WebAuth login tokens

SYNOPSIS

           my $token = WebAuth::Token::Login->new;
           $token->username ('user');
           $token->password ($password);
           print $token->encode ($keyring), "\n";

DESCRIPTION

       A WebAuth login token, used to communicate the user's username and password or other
       authentication secret from the WebLogin server to the WebKDC.

CLASS METHODS

       new ()
           Create a new, empty WebAuth::Token::Login.  At least some attributes will have to be
           set using the accessor methods described below before the token can be used.

INSTANCE METHODS

       As with WebAuth module functions, failures are signaled by throwing WebAuth::Exception
       rather than by return status.

General Methods

       encode (KEYRING)
           Generate the encoded and encrypted form of this token using the provided KEYRING.  The
           encryption key used will be the one returned by the best_key() method of
           WebAuth::Keyring on that KEYRING.

Accessor Methods

       username ([USERNAME])
           Get or set the username for which this token holds login credentials.  This is a site-
           specific identifier and may or may not be a fully-qualified principal name.

       password ([PASSWORD])
           Get or set the password for this user.  Either this or the otp() attribute will be
           set.

       otp ([OTP])
           Get or set the one-time password code for this user.  Either this or the password()
           attribute will be set.

       otp_type ([TYPE])
           Get or set the one-time password type.  This should be a WebAuth factor code
           corresponding to the type of one-time password that this login token represents.  It
           may be left unset if the caller doesn't know.

       creation ([TIMESTAMP])
           Get or set the creation timestamp for this token in seconds since epoch.  If not set,
           the encoded token will have a creation time set to the time of encoding.

AUTHOR

       Russ Allbery <rra@stanford.edu>

SEE ALSO

       WebAuth(3), WebAuth::Keyring(3), WebAuth::Token(3)

       This module is part of WebAuth.  The current version is available from
       <http://webauth.stanford.edu/>.