Client side¶

Area protection (Apache handler)

  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/config',
                # If soapserver is protected by HTTP Basic:
                User     => 'http-user',
                Password => 'pass',
      },
      https               => 0,
  } );

Authentication portal

  use Lemonldap::NG::Portal::SharedConf;
  
  my $portal = Lemonldap::NG::Portal::SharedConf->new ( {
          configStorage => {
                  type    => 'SOAP',
                  proxy    => 'http://auth.example.com/index.pl/config',
                  # If soapserver is protected by HTTP Basic:
                  User     => 'http-user',
                  Password => 'pass',
          }
  });
  # Next as usual... See Lemonldap::NG::Portal(3)
  if($portal->process()) {
    ...

Manager

  use Lemonldap::NG::Manager;
  
  my $m=new Lemonldap::NG::Manager(
       {
           configStorage=>{
                  type  => 'SOAP',
                  proxy    => 'http://auth.example.com/index.pl/config',
                  # If soapserver is protected by HTTP Basic:
                  User     => 'http-user',
                  Password => 'pass',
           },
            dhtmlXTreeImageLocation=> "/imgs/",
        }
  ) or die "Unable to start manager";
  
  $m->doall();

Server side¶

You just have to set "Soap => 1" in your portal. 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

    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/config',
                  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/config',
        },
        https               => 1,
    } );