SYNOPSIS

• With Lemonldap::NG::Handler

  
  package My::Package;
  use Lemonldap::NG::Handler::SharedConf;
  our @ISA = qw(Lemonldap::NG::Handler::Simple);
  __PACKAGE__->init ({
  globalStorage => 'Lemonldap::NG::Common::Apache::Session::SOAP',
  globalStorageOptions => {
  proxy => 'http://auth.example.com/index.pl/sessions',
  proxyOptions => {
  timeout => 5,
  },
  # If soapserver is protected by HTTP Basic:
  User => 'http-user',
  Password => 'pass',
  # To have a local session cache
  localStorage => "Cache::FileCache",
  localStorageOptions => {
  'namespace' => 'lemonldap-ng',
  'default_expires_in' => 600,
  },
  },
  configStorage => {
  ... # See Lemonldap::NG::Handler
  

• With Lemonldap::NG::Portal

    use Lemonldap::NG::Portal::SharedConf;
    my $portal = new Lemonldap::NG::Portal::SharedConf (
           globalStorage => 'Lemonldap::NG::Common::Apache::Session::SOAP',
           globalStorageOptions => {
                   proxy => 'http://auth.example.com/index.pl/sessions',
                   proxyOptions => {
                       timeout => 5,
                   },
                   # If soapserver is protected by HTTP Basic:
                   User     => 'http-user',
                   Password => 'pass',
                   # To have a local session cache
                   localStorage        => "Cache::FileCache",
                   localStorageOptions => {
                       'namespace'          => 'lemonldap-ng',
                       'default_expires_in' => 600,
                   },
           },
           configStorage => {
               ... # See Lemonldap::NG::Portal
  

  You can also set parameters corresponding to ``Apache::Session module'' in the manager.

DESCRIPTION

Lemonldap::NG::Common::Conf provides a simple interface to access to Lemonldap::NG Web-SSO configuration. It is used by Lemonldap::NG::Handler, Lemonldap::NG::Portal and Lemonldap::NG::Manager.

Lemonldap::NG::Common::Apache::Session::SOAP used with Lemonldap::NG::Portal provides the ability to acces to Lemonldap::NG sessions via SOAP: the portal act as a proxy to access to the real Apache::Session module (see HTML documentation for more)

SECURITY

As Lemonldap::NG::Common::Conf::SOAP use SOAP::Lite, you have to see SOAP::Transport to know arguments that can be passed to "proxyOptions". Lemonldap::NG provides a system for HTTP basic authentication.

Examples :

• HTTP Basic authentication

  SOAP::transport can use basic authentication by rewriting ""SOAP::Transport::HTTP::Client::get_basic_credentials>:

    package My::Package;
    
    use base Lemonldap::NG::Handler::SharedConf;
    
    __PACKAGE__->init ( {
        globalStorage => 'Lemonldap::NG::Common::Apache::Session::SOAP',
        globalStorageOptions => {
                  proxy => 'http://auth.example.com/index.pl/sessions',
                  User     => 'http-user',
                  Password => 'pass',
        },
    } );
  

• SSL Authentication

  SOAP::transport provides a simple way to use SSL certificate: you've just to set environment variables.

    package My::Package;
    
    use base Lemonldap::NG::Handler::SharedConf;
    
    # AUTHENTICATION
    $ENV{HTTPS_CERT_FILE} = 'client-cert.pem';
    $ENV{HTTPS_KEY_FILE}  = 'client-key.pem';
    
    __PACKAGE__->init ( {
        globalStorage => 'Lemonldap::NG::Common::Apache::Session::SOAP',
        globalStorageOptions => {
                  proxy => 'https://auth.example.com/index.pl/sessions',
        },
    } );
  

AUTHOR

Clement Oudot, <[email protected]>

François-Xavier Deltombe, <[email protected].>

Xavier Guimard, <[email protected]>

DOWNLOAD

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

COPYRIGHT AND LICENSE

Copyright (C) 2008-2013 by Xavier Guimard, <[email protected]>

Copyright (C) 2012 by François-Xavier Deltombe, <[email protected].>

Copyright (C) 2010-2012 by Clement Oudot, <[email protected]>

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