NAME

Lemonldap::NG::Portal::SharedConf - Module for building Lemonldap::NG compatible portals using a central configuration database.

SYNOPSIS

use Lemonldap::NG::Portal::SharedConf;
my $portal = new Lemonldap::NG::Portal::SharedConf( {
       configStorage => {
           type        => 'DBI',
           dbiChain    => "dbi:mysql:...",
           dbiUser     => "lemonldap",
           dbiPassword => "password",
           dbiTable    => "lmConfig",
       },
       # Activate SOAP service
       Soap           => 1
  } );

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 L<CGI(3)>)
  print "...";

  # or redirect the user to the menu
  print $portal->redirect( -uri => 'https://portal/menu');
}
else {
  # Write here the html form used to authenticate with CGI methods.
  # $portal->error returns the error message if athentification failed
  # Warning: by defaut, input names are "user" and "password"
  print $portal->header('text/html; charset=utf8'); # DON'T FORGET THIS (see L<CGI(3)>)
  print "...";
  print '<form method="POST">';
  # In your form, the following value is required for redirection
  print '<input type="hidden" name="url" value="'.$portal->param('url').'">';
  # Next, login and password
  print 'Login : <input name="user"><br>';
  print 'Password : <input name="password" type="password" autocomplete="off">';
  print '<input type="submit" value="go" />';
  print '</form>';
}

SOAP mode authentication (client) :

#!/usr/bin/perl -l

use SOAP::Lite;
use Data::Dumper;

my $soap =
  SOAP::Lite->proxy('http://auth.example.com/')
  ->uri('urn:/Lemonldap::NG::Common::::CGI::SOAPService');
my $r = $soap->getCookies( 'user', 'password' );

# Catch SOAP errors
if ( $r->fault ) {
    print STDERR "SOAP Error: " . $r->fault->{faultstring};
}
else {
    my $res = $r->result();

    # If authentication failed, display error
    if ( $res->{error} ) {
        print STDERR "Error: " . $soap->error( $res->{error} )->result();
    }

    # print session-ID
    else {
        print "Cookie: lemonldap=" . $res->{cookies}->{lemonldap};
    }
}

DESCRIPTION

Lemonldap::NG::Portal::SharedConf is the base module for building Lemonldap::NG compatible portals using a central database configuration. You have to use by inheritance.

See Lemonldap::NG::Portal::SharedConf for a complete example.

METHODS

Same as Lemonldap::NG::Portal::Simple, but Lemonldap::NG::Portal::SharedConf adds a new sub:

• scanexpr: used by setGroups to read combined LDAP and Perl expressions. See Lemonldap::NG::Portal for more.

Args

Lemonldap::NG::Portal::SharedConf use the same arguments than Lemonldap::NG::Portal::Simple, but you can set them either using local variables passed to new() or using variables issued from the database.

EXPORT

Constants

Same as Lemonldap::NG::Portal::Simple.

SEE ALSO

Lemonldap::NG::Portal, Lemonldap::NG::Portal::SharedConf, Lemonldap::NG::Handler, Lemonldap::NG::Manager, http://lemonldap-ng.org/

AUTHOR

Xavier Guimard, <x.guimard@free.fr>, Thomas Chemineau, <thomas.chemineau@linagora.com>

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) 2005, 2007, 2010 by Xavier Guimard <x.guimard@free.fr> and Thomas Chemineau, <thomas.chemineau@linagora.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.