NAME

Apache::Wyrd::Interfaces::GetUser

SYNOPSIS

[in a subclass of Apache::Wyrd::Handler]

sub process {
  my ($self) =@_;
  $self->{init}->{user} = $self->user('BASENAME::User');
  return FORBIDDEN
    unless ($self->check_auth($self->{init}->{user}));
  return undef;
}

DESCRIPTION

Provides a User method that will check both the Apache notes table and the available cookies for a User created by the Apache::Wyrd::Services::Auth module. This is needed by any handler which will need to be informed as to the findings of a stacked Apache::Wyrd::Services::Auth handler.

But this method is not limited only to stacked Auth handlers. When the AuthPath SetPerlVar directive of the Apache::Wyrd::Services::Auth module is beyond the scope of the area where the authorization was checked (in other words, the cookie is returned to areas of the site where authorization is not required), this interface is useful for finding what user is browsing the site.

The SYNOPSIS shows the typical use of this interface in a subclass of Apache::Wyrd::Handler.

METHODS

(format: (returns) name (arguments after self))

(Apache::Wyrd::User) user (scalar)

Given a User object classname (such as BASENAME::User), this method revives any User object found by an Auth handler and either placed into the Apache notes table of the current session or in a cookie provided by the browser.

BUGS/CAVEATS

UNKNOWN

AUTHOR

Barry King <wyrd@nospam.wyrdwright.com>

SEE ALSO

Apache::Wyrd

General-purpose HTML-embeddable perl object

LICENSE

Copyright 2002-2004 Wyrdwright, Inc. and licensed under the GNU GPL.

See LICENSE under the documentation for Apache::Wyrd.