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 <eagle@eyrie.org>

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/>.