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',
                            # 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',
                 },
             } );

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>
       François-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 François-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/>.

perl v5.22.1                                       2015-12-25             Lemonldap::NG::...::Session::SOAP(3pm)