Use main Handler module VERSION (#630)
This commit is contained in:
Clément Oudot
parent
bd95df3136
commit
75c3a79abf
|
|
@ -1,13 +1,12 @@
|
|||
## @file
|
||||
# Alias for Lemonldap::NG::Handler::SharedConf
|
||||
# Alias for Lemonldap::NG::Handler::DefaultHandler
|
||||
|
||||
## @class
|
||||
# Alias for Lemonldap::NG::Handler::SharedConf
|
||||
# Alias for Lemonldap::NG::Handler::DefaultHandler
|
||||
package Lemonldap::NG::Handler;
|
||||
|
||||
our $VERSION = '1.3.0';
|
||||
use Lemonldap::NG::Handler::SharedConf;
|
||||
use base qw(Lemonldap::NG::Handler::SharedConf);
|
||||
our $VERSION = '1.4.0';
|
||||
use base qw(Lemonldap::NG::Handler::DefaultHandler);
|
||||
|
||||
1;
|
||||
|
||||
|
|
@ -24,40 +23,17 @@ Lemonldap::NG Web-SSO system.
|
|||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
=head2 Create your Apache module
|
||||
|
||||
Create your own package (example using a central configuration database):
|
||||
|
||||
package My::Package;
|
||||
use Lemonldap::NG::Handler::SharedConf;
|
||||
@ISA = qw(Lemonldap::NG::Handler::SharedConf);
|
||||
|
||||
__PACKAGE__->init ( {
|
||||
# Local storage used for sessions and configuration
|
||||
localStorage => "Cache::DBFile",
|
||||
localStorageOptions => {...},
|
||||
# How to get my configuration
|
||||
configStorage => {
|
||||
type => "DBI",
|
||||
dbiChain => "DBI:mysql:database=lemondb;host=$hostname",
|
||||
dbiUser => "lemonldap",
|
||||
dbiPassword => "password",
|
||||
}
|
||||
# Uncomment this to activate status module
|
||||
# status => 1,
|
||||
} );
|
||||
|
||||
=head2 Configure Apache
|
||||
|
||||
Call your package in /apache-dir/conf/httpd.conf:
|
||||
Call Handler in /apache-dir/conf/httpd.conf:
|
||||
|
||||
# Load your package
|
||||
PerlRequire /My/File
|
||||
# TOTAL PROTECTION
|
||||
PerlHeaderParserHandler My::Package
|
||||
PerlHeaderParserHandler Lemonldap::NG::Handler
|
||||
# OR SELECTED AREA
|
||||
<Location /protected-area>
|
||||
PerlHeaderParserHandler My::Package
|
||||
PerlHeaderParserHandler Lemonldap::NG::Handler
|
||||
</Location>
|
||||
|
||||
The configuration is loaded only at Apache start. Create an URI to force
|
||||
|
|
@ -68,35 +44,16 @@ configuration reload, so you don't need to restart Apache at each change:
|
|||
Order deny,allow
|
||||
Deny from all
|
||||
Allow from my.manager.com
|
||||
PerlHeaderParserHandler My::Package->refresh
|
||||
PerlHeaderParserHandler Lemonldap::NG::Handler->refresh
|
||||
</Location>
|
||||
|
||||
You can also disable access control for specific URIs, but be aware that
|
||||
this is not really secure, since session cookies are sent to the protected
|
||||
application (so they could be spoofed), and since a user could forge his
|
||||
own HTTP request headers and they would not be reset. To disable access
|
||||
control for specific URIs on a secure way, you should set access rule to
|
||||
'skip' instead.
|
||||
|
||||
<Files "*.gif">
|
||||
PerlHeaderParserHandler My::Package->unprotect
|
||||
</Files>
|
||||
|
||||
To display the status page, add something like this :
|
||||
|
||||
<Location /status>
|
||||
Order deny,allow
|
||||
Allow from 10.1.1.0/24
|
||||
Deny from all
|
||||
PerlHeaderParserHandler My::Package->status
|
||||
</Location>
|
||||
|
||||
If your application has a "logout" URL, you can configure it directly in Apache
|
||||
configuration file (or in the manager interface). THIS IS DEPRECATED, use the
|
||||
manager :
|
||||
|
||||
<Location /logout>
|
||||
PerlHeaderParserHandler My::Package->logout
|
||||
PerlHeaderParserHandler Lemonldap::NG::Handler->status
|
||||
</Location>
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
|
@ -284,8 +241,8 @@ Lemonldap::NG use 3 levels of cache for authenticated users:
|
|||
parameter (completed with C<globalStorageOptions>) and used by
|
||||
L<lemonldap::NG::Portal> to store authenticated user parameters,
|
||||
|
||||
=item * a L<Cache::Cache> module choosed with the C<localStorage> parameter
|
||||
(completed with C<localStorageOptions>) and used to share authenticated users
|
||||
=item * a L<Cache::Cache> module choosed with the C<sessionLocalStorage> parameter
|
||||
(completed with C<sessionLocalStorageOptions>) and used to share authenticated users
|
||||
between Apache's threads or processus and of course between virtual hosts,
|
||||
|
||||
=item * Lemonldap::NG::Handler variables: if the same user use the same thread
|
||||
|
|
@ -329,15 +286,6 @@ Lemonldap::NG::Handler provides different modules:
|
|||
|
||||
=over
|
||||
|
||||
=item * L<Lemonldap::NG::Handler::Simple>: base module. It can be used
|
||||
directly to protect a single host.
|
||||
|
||||
=item * L<Lemonldap::NG::Handler::Vhost>: module used to managed virtual hosts.
|
||||
|
||||
=item * L<Lemonldap::NG::Handler::SharedConf>: with this module, the
|
||||
configuration can be centralized. Inherits from
|
||||
L<Lemonldap::NG::Handler::Vhost> and L<Lemonldap::NG::Handler::Simple>.
|
||||
|
||||
=item * L<Lemonldap::NG::Handler::CGI>: if you have only a few Perl CGI to
|
||||
protect, you can use this module in your CGI instead of protecting it under
|
||||
L<Lemonldap::NG::Handler::SharedConf>.
|
||||
|
|
@ -356,7 +304,7 @@ download a mod_perl2 backport.
|
|||
|
||||
=head1 SEE ALSO
|
||||
|
||||
L<Lemonldap::NG::Handler::SharedConf>,
|
||||
L<Lemonldap::NG::Handler::DefaultHandler>,
|
||||
L<Lemonldap::NG::Portal>, L<Lemonldap::NG::Manager>,
|
||||
L<http://lemonldap-ng.org/>
|
||||
|
||||
|
|
|
|||
|
|
@ -15,6 +15,7 @@ package Lemonldap::NG::Handler::Initialization::LocalInit;
|
|||
|
||||
use Mouse;
|
||||
|
||||
use Lemonldap::NG::Handler; # Needed to get VERSION
|
||||
use Lemonldap::NG::Handler::Main::Logger;
|
||||
|
||||
our $VERSION = '1.3.0';
|
||||
|
|
@ -208,7 +209,7 @@ sub childInit {
|
|||
PerlPostConfigHandler => sub {
|
||||
my ( $c, $l, $t, $s ) = splice @_;
|
||||
$s->add_version_component(
|
||||
'Lemonldap::NG::Handler/' . $VERSION );
|
||||
'Lemonldap::NG::Handler/' . $Lemonldap::NG::Handler::VERSION );
|
||||
}
|
||||
) unless ( $args->{hideSignature} );
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in New Issue