/ 
Lemonldap-NG-Portal-1.3.2
River stage zero No dependents
/ Lemonldap::NG::Portal::AuthApache

NAME

Lemonldap::NG::Portal::AuthApache - Perl extension for building Lemonldap::NG compatible portals with Apache authentication.

SYNOPSIS

use Lemonldap::NG::Portal::SharedConf;
my $portal = new Lemonldap::NG::Portal::Simple(
       configStorage     => {...}, # See Lemonldap::NG::Portal
       authentication    => 'Apache',
  );

if($portal->process()) {
  # Write here the menu with CGI methods. This page is displayed ONLY IF
  # the user was not redirected here.
  print $portal->header('text/html; charset=utf-8'); # DON'T FORGET THIS (see CGI(3))
  print "...";

  # or redirect the user to the menu
  print $portal->redirect( -uri => 'https://portal/menu');
}
else {
  # If the user enters here, IT MEANS THAT APACHE AUTHENTICATION DOES NOT WORK
  print $portal->header('text/html; charset=utf-8'); # DON'T FORGET THIS (see CGI(3))
  print "<html><body><h1>Unable to work</h1>";
  print "This server isn't well configured. Contact your administrator.";
  print "</body></html>";
}

and of course, configure Apache to protect the portal.

DESCRIPTION

This library just overload few methods of Lemonldap::NG::Portal::Simple to use Apache authentication mechanism: we've just try to get REMOTE_USER environment variable.

See Lemonldap::NG::Portal::Simple for usage and other methods.

SEE ALSO

Lemonldap::NG::Portal, Lemonldap::NG::Portal::Simple, http://lemonldap-ng.org/

AUTHOR

Clement Oudot, <clem.oudot@gmail.com>
Xavier Guimard, <x.guimard@free.fr>

BUG REPORT

Use OW2 system to report bug or ask for features: http://jira.ow2.org

DOWNLOAD

Lemonldap::NG is available at http://forge.objectweb.org/project/showfiles.php?group_id=274

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.