NAME

Authenticator::Crumb - Class for authenticating with a UUID in AURORA.

SYNOPSIS

It follows the same use as the Authenticator-class. See the Authenticator placeholder class for more information.

DESCRIPTION

Class for authenticating with a UUID in AURORA. AURORA supports requesting an UUID upon validation which then can subsequently be used instead of the original credentials, such as AuroraID.

When validation is performed the AURORA REST-server can generate an UUID to be used instead of the original credentials. All Authenticator-classes can be used with this scheme, with the exception of the UUID-class itself - Crumbs.

One asks for such a UUID to be generated by including the parameter "authuuid" and setting to a value that evaluates to true. The REST-server will then upon success return the newly generated UUID in the parameter "authuuid".

This scheme makes it possible for browser-side apps, such as using javascript, to hide the initial credentials used to authenticate by asking for a UUID replacement and then throwing the original credentials.

CONSTRUCTOR

See the Authenticator placeholder class for more information.

METHODS

define()

See description in the placeholder Authenticator-class.

validate()

Attempt to find user based upon a valid UUID. The authstr of the class is formatted as follows:

UUID

It returns the AURORA database userid (entity id - int) of the user upon success or 0 upon user not found or some failure. Check the error()-method for more information.

See description in the placeholder Authenticator-class for more information on the framework itself.

generate()

Generates a UUID authentication string cleaning it.

Undef is returned upon failure. In such a case check the error()-method for more information.

See description in the placeholder Authenticator-class for more information on the framework itself.