NAME

Lemonldap::Federation::Shibboleth - Perl extension for lemonldap websso and Shibboleth IDP

SYNOPSIS

  use Lemonldap::Federation::ShibbolethRequestMap ;
  my $requestmap = Lemonldap::Federation::ShibbolethRequestMap->new( xml_host => $extrait_de_xml ,
                                  xml_application=> $extrait_de_xml2 ,
                                  uri => $full_uri , ) ;
  my $re= $requestmap->application_id;
  my  $redirection = $requestmap->redirection ;

DESCRIPTION

There are two pieces of code :

• Lemonldap::Federation::SplitURI
• Lemonldap::Federation::ShibbolethRequestMap

First (Lemonldap::Federation::SplitURI) is used in order to split uri in scheme , host , port and path .

 eg :   https://sp.example.org/secure/admin/index.html must be splited into

• https
• 443
• sp.example.org
• secure
• admin
• index.html

The second compoment is the RequestMap . It job is to find and return the applicationID for URI. For this it uses an XML configuration file like this :

   <Host  scheme="https" port="443"  name="sp.example.org" >
                <Path name="secure" 
                      authType="shiboleth" 
                      requireSession="true"
                      exportAssertion="true">
                 <Path name="admin" applicationId ="foo-admin" />
                </Path>

  </Host>

METHODS:

Constructor $requestmap = Lemonldap::Federation::ShibbolethRequestMap->new( xml_host => $extrait_de_xml , xml_application=> $extrait_de_xml2 , uri => $full_uri , ) ;

  with:

• xml_host : XML piece of <RequestMapProvider>..</RequestMapProvider>
• xml_application : XML piece of <Applications> ..</Applications>

Application_id

    return the application id for an URI .
  
=head2  redirection
    
    return entire line of redirection to IPD  :

   eg :
 
https://idp.exemple.org/sso?target=http%3A%2F%2Fauthen.demo.net%2Fshibe&shire=http%3A%2F%2Fsp.example.org%2Fshire&providerId=http%3A%2F%2Fsp.example.org

   see GenericSHIB.pm in example directory

SEE ALSO

 https://spaces.internet2.edu/display/SHIB/WebHome
 http://shibboleth.internet2.edu/

AUTHOR

eric German, <germanlinux@yahoo.fr>

COPYRIGHT AND LICENSE

Copyright (C) 2007 by lemonasso

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