Provided by: liblemonldap-ng-portal-perl_1.2.5-1_all bug

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=utf8'); # 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=utf8'); # 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

       Copyright (C) 2007, 2008, 2009, 2010 by Xavier Guimard, <x.guimard@free.fr>
       Copyright (C) 2009, 2010, 2012 by Clement Oudot, <clem.oudot@gmail.com>

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