Lemonldap::NG::Common::Apache::Session::SOAP(3pm)

NAME
Lemonldap::NG::Common::Apache::Session::SOAP - Perl extension written to access to Lemonldap::NG Web-SSO sessions via SOAP.

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',
             },
             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',
             },
             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 ( {
          localStorage        => "Cache::FileCache",
          localStorageOptions => {
                    'namespace'          => 'lemonldap-ng',
                    'default_expires_in' => 600,
          },
          configStorage       => {
                    type  => 'SOAP',
                    proxy => 'http://auth.example.com/index.pl/sessions',
                    User     => 'http-user',
                    Password => 'pass',
          },
          https               => 1,
      } );

•   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 ( {
          localStorage        => "Cache::FileCache",
          localStorageOptions => {
                    'namespace'          => 'lemonldap-ng',
                    'default_expires_in' => 600,
          },
          configStorage       => {
                    type  => 'SOAP',
                    proxy => 'http://auth.example.com/index.pl/sessions',
          },
          https               => 1,
      } );

SEE ALSO
Lemonldap::NG::Manager, Lemonldap::NG::Common::Conf::SOAP, Lemonldap::NG::Handler, Lemonldap::NG::Portal, <http://lemonldap-ng.org/>

AUTHOR

Clement Oudot, <clem.oudot@gmail.com>
FranXois-Xavier Deltombe, <fxdeltombe@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) 2008, 2009, 2010 by Xavier Guimard, <x.guimard@free.fr>
Copyright (C) 2012 by FranXois-Xavier Deltombe, <fxdeltombe@gmail.com.>
Copyright (C) 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/>.