2016-06-09 20:40:20 +02:00
|
|
|
# Base package for LLNG portal plugins. It adds somme wrapper to
|
|
|
|
# Lemonldap::NG::Handler::PSGI::Try (base of portal)
|
2016-05-28 10:33:39 +02:00
|
|
|
package Lemonldap::NG::Portal::Main::Plugin;
|
|
|
|
|
|
|
|
use strict;
|
|
|
|
use Mouse;
|
2017-10-10 11:24:08 +02:00
|
|
|
use HTML::Template;
|
2016-05-28 10:33:39 +02:00
|
|
|
|
|
|
|
our $VERSION = '2.0.0';
|
|
|
|
|
2016-06-02 23:20:36 +02:00
|
|
|
extends 'Lemonldap::NG::Common::Module';
|
2016-05-28 10:33:39 +02:00
|
|
|
|
2017-01-09 07:11:28 +01:00
|
|
|
sub sendError {
|
|
|
|
my $self = shift;
|
|
|
|
return $self->p->sendError(@_);
|
|
|
|
}
|
|
|
|
|
|
|
|
sub sendJSONresponse {
|
|
|
|
my $self = shift;
|
|
|
|
return $self->p->sendJSONresponse(@_);
|
|
|
|
}
|
|
|
|
|
2016-05-28 10:33:39 +02:00
|
|
|
sub addAuthRoute {
|
|
|
|
my $self = shift;
|
2016-12-17 21:19:46 +01:00
|
|
|
return $self->_addRoute( 'addAuthRoute', @_ );
|
2016-05-28 10:33:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
sub addUnauthRoute {
|
|
|
|
my $self = shift;
|
2016-12-17 21:19:46 +01:00
|
|
|
return $self->_addRoute( 'addUnauthRoute', @_ );
|
2016-05-28 10:33:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
sub _addRoute {
|
2016-12-17 21:19:46 +01:00
|
|
|
my ( $self, $type, $word, $subName, $methods, $transform ) = @_;
|
|
|
|
$transform //= sub {
|
|
|
|
my ($sub) = @_;
|
|
|
|
if ( ref $sub ) {
|
|
|
|
return sub {
|
|
|
|
shift;
|
|
|
|
return $sub->( $self, @_ );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return sub {
|
|
|
|
shift;
|
|
|
|
return $self->$sub(@_);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
2017-01-08 07:25:10 +01:00
|
|
|
$self->p->$type( $word, $subName, $methods, $transform );
|
|
|
|
return $self;
|
2016-05-28 10:33:39 +02:00
|
|
|
}
|
|
|
|
|
2017-10-10 11:24:08 +02:00
|
|
|
sub loadTemplate {
|
2017-10-10 13:04:40 +02:00
|
|
|
my $self = shift;
|
|
|
|
return $self->p->loadTemplate(@_);
|
2017-10-10 11:24:08 +02:00
|
|
|
}
|
|
|
|
|
2016-05-28 10:33:39 +02:00
|
|
|
1;
|
2017-01-30 21:21:58 +01:00
|
|
|
__END__
|
|
|
|
|
|
|
|
=pod
|
|
|
|
|
|
|
|
=encoding utf8
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
Lemonldap::NG::Portal::Main::Plugin - Base class for
|
|
|
|
L<Lemonldap::NG::Portal> modules I<(plugins, authentication modules,...)>.
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
package Lemonldap::NG::Portal::My::Plugin;
|
|
|
|
use Mouse;
|
|
|
|
extends 'Lemonldap::NG::Portal::Main::Plugin';
|
|
|
|
|
|
|
|
use constant beforeAuth => 'verifyIP';
|
|
|
|
|
|
|
|
sub init {
|
|
|
|
my ($self) = @_;
|
|
|
|
$self->addUnauthRoute( mypath => 'hello', [ 'GET', 'PUT' ] );
|
|
|
|
$self->addAuthRoute( mypath => 'wellcome', [ 'GET', 'PUT' ] );
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
sub verifyIP {
|
|
|
|
my ($self, $req) = @_;
|
|
|
|
return PE_ERROR if($req->address !~ /^10/);
|
|
|
|
return PE_OK;
|
|
|
|
}
|
|
|
|
sub hello {
|
|
|
|
my ($self, $req) = @_;
|
|
|
|
...
|
|
|
|
return $self->p->sendJSONresponse($req, { hello => 1 });
|
|
|
|
}
|
|
|
|
sub wellcome {
|
|
|
|
my ($self, $req) = @_;
|
|
|
|
...
|
|
|
|
return $self->p->sendHtml($req, 'template', params => { WELLCOME => 1 });
|
|
|
|
}
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
Lemonldap::NG::Portal::Main::Plugin provides many methods to write easily
|
|
|
|
Lemonldap::NG addons.
|
|
|
|
|
|
|
|
init() is called for each plugin. If one plugin initialization fails (init()
|
|
|
|
returns 0), the portal responds a 500 status code for each request.
|
|
|
|
|
|
|
|
=head1 Writing plugins
|
|
|
|
|
|
|
|
Custom plugins can be inserted in portal by declaring them in
|
|
|
|
C<lemonldap-ng.ini> file, section C<[portal]>, key C<customPlugins>:
|
|
|
|
|
|
|
|
[portal]
|
|
|
|
customPlugins = My::Plugin1, My::Plugin2
|
|
|
|
|
|
|
|
Plugins must be valid packages well found in C<@INC>.
|
|
|
|
|
|
|
|
=head2 Plugin entry points
|
|
|
|
|
|
|
|
=head3 Entry point based on PATH_INFO
|
|
|
|
|
|
|
|
Plugins can declare unauthRoutes/authRoutes during this initialization (=
|
|
|
|
/path/info). Methods declared in this way must be declared in the plugin class.
|
|
|
|
They will be called this the $req argument: the HTTP request
|
|
|
|
(L<Lemonldap::NG::Portal::Main::Request>). These methods must return a valid
|
|
|
|
L<PSGI> response. You can also use sendJSONresponse() or sendHtml() methods
|
|
|
|
(see L<Lemonldap::NG::Common::PSGI>).
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
sub init {
|
|
|
|
my ($self) = @_;
|
|
|
|
$self->addUnauthRoute( mypath => 'hello', [ 'GET', 'PUT' ] );
|
|
|
|
$self->addAuthRoute( mypath => 'wellcome', [ 'GET', 'PUT' ] );
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
sub hello {
|
|
|
|
my ($self, $req) = @_;
|
|
|
|
...
|
|
|
|
return $self->p->sendJSONresponse($req, { hello => 1 });
|
|
|
|
}
|
|
|
|
sub wellcome {
|
|
|
|
my ($self, $req) = @_;
|
|
|
|
...
|
|
|
|
return $self->p->sendHtml($req, 'template', params => { WELLCOME => 1 });
|
|
|
|
}
|
|
|
|
|
|
|
|
=head3 Entry point in auth process
|
|
|
|
|
|
|
|
A plugin which wants to be inserted in authentication process has to declare
|
|
|
|
constants containing the name of the method to run. The following entry points
|
|
|
|
are available.
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item C<beforeAuth>: method called before authentication process
|
|
|
|
|
|
|
|
=item C<betweenAuthAndDatas>: method called after authentication and before
|
|
|
|
setting C<sessionInfo> provisionning
|
|
|
|
|
|
|
|
=item C<afterDatas>: method called after C<sessionInfo> provisionning
|
|
|
|
I<(macros, groups,...)>
|
|
|
|
|
|
|
|
=item C<forAuthUser>: method called for already authenticated users
|
|
|
|
|
|
|
|
=item C<beforeLogout>: method called before logout
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
B<Note>: methods inserted so must return a PE_* constant. See
|
|
|
|
Lemonldap::NG::Portal::Main::Constants.
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<http://lemonldap-ng.org>
|
|
|
|
|
|
|
|
=head2 OTHER POD FILES
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
2018-02-19 22:07:20 +01:00
|
|
|
=item Writing an authentication module: L<Lemonldap::NG::Portal::Auth>
|
|
|
|
|
|
|
|
=item Writing a UserDB module: L<Lemonldap::NG::Portal::UserDB>
|
|
|
|
|
|
|
|
=item Writing a second factor module: L<Lemonldap::NG::Portal::Main::SecondFactor>
|
2017-01-30 21:21:58 +01:00
|
|
|
|
|
|
|
=item Writing an issuer module: L<Lemonldap::NG::Portal::Main::Issuer>
|
|
|
|
|
2018-03-15 21:20:03 +01:00
|
|
|
=item Writing another plugin: L<Lemonldap::NG::Portal::Main::Plugin>
|
2018-02-19 22:07:20 +01:00
|
|
|
|
2017-01-30 21:21:58 +01:00
|
|
|
=item Request object: L<Lemonldap::NG::Portal::Main::Request>
|
|
|
|
|
|
|
|
=item Adding parameters in the manager: L<Lemonldap::NG::Manager::Build>
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 AUTHORS
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item LemonLDAP::NG team L<http://lemonldap-ng.org/team>
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 BUG REPORT
|
|
|
|
|
|
|
|
Use OW2 system to report bug or ask for features:
|
2017-11-11 14:06:23 +01:00
|
|
|
L<https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>
|
2017-01-30 21:21:58 +01:00
|
|
|
|
|
|
|
=head1 DOWNLOAD
|
|
|
|
|
|
|
|
Lemonldap::NG is available at
|
|
|
|
L<http://forge.objectweb.org/project/showfiles.php?group_id=274>
|
|
|
|
|
|
|
|
=head1 COPYRIGHT AND LICENSE
|
|
|
|
|
|
|
|
See COPYING file for details.
|
|
|
|
|
|
|
|
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 L<http://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
=cut
|