CGI::Auth::Flexible - web authentication optionally using cookies
-=head1 SYNOPSYS
+=head1 SYNOPSYS - STARTUP
my $verifier = CGI::Auth::Flexible->new_verifier(setting => value,...);
my $authreq = $verifier->new_request($cgi_request_object);
- my $authreq = CGI::Auth::Flexible->new_request($cgi_request_object,
- setting => value,...);
-
-=head1 USAGE PATTERN FOR SIMPLE APPLICATIONS
+=head1 SYNOPSYS - SIMPLE APPLICATIONS
$authreq->check_ok() or return;
-
- blah blah blah
+ ...
$authreq->check_mutate();
- blah blah blah
+ ...
-=head1 USAGE PATTERN FOR FANCY APPLICATIONS
+=head1 SYNOPSIS - SOPHISTICATED APPLICATIONS
my $divert_kind = $authreq->check_divert();
- if ($divert_kind) {
- if ($divert_kind eq 'LOGGEDOUT') {
- print "goodbye you are now logged out" and quit
- } elsif ($divert_kind eq 'NOCOOKIES') {
- print "you need cookies" and quit
- ... etc.
- }
- }
-
- blah blah blah
+ if ($divert_kind) { ... print diversion page and quit ... }
+ ...
$authreq->check_mutate();
- blah blah blah
+ ...
+
+=head1 DESCRIPTION
+
+CGI::Auth::Flexible is a