1Lemonldap::NG::Manager(U3s)er Contributed Perl DocumentatLieomnonldap::NG::Manager(3)
2
3
4
6 Lemonldap::NG::Manager - Perl extension for managing Lemonldap::NG
7 Web-SSO system.
8
10 Use any of Plack launcher. Example:
11
12 #!/usr/bin/env plackup
13
14 use Lemonldap::NG::Manager;
15
16 # This must be the last instruction ! See PSGI for more
17 Lemonldap::NG::Manager->run($opts);
18
20 Lemonldap::NG::Manager provides a web interface to manage Lemonldap::NG
21 Web-SSO system.
22
23 The Perl part of Lemonldap::NG::Manager is the REST server. Web
24 interface is written in Javascript, using AngularJS framework and can
25 be found in `site` directory. The REST API is described in REST-API.md
26 file provided in source tree.
27
28 Lemonldap::NG Manager uses Plack to be CGI, FastCGI and so on
29 compatible. It inherits of Lemonldap::NG::Handler::PSGI::Router
30
32 Lemonldap::NG Manager contains 6 parts:
33
34 Configuration management
35 Session explorer
36 Notification explorer
37 Second Factors manager
38 Configuration builder (see Lemonldap::NG::Manager::Build
39 Command line interface (see Lemonldap::NG::Manager::Cli
40
41 Static files generation
42 `scripts/jsongenerator.pl` file uses
43 Lemonldap::NG::Manager::Build::Attributes,
44 Lemonldap::NG::Manager::Build::Tree and
45 Lemonldap::NG::Manager::Build::CTrees to generate
46
47 `site/htdocs/static/struct.json`:
48 main file containing the tree view;
49
50 `site/htdocs/static/js/conftree.js`:
51 generates Virtualhosts, SAML and OpenID-Connect partners sub-trees;
52
53 `Lemonldap::NG::Common::Conf::ReConstants`:
54 constants used by all Perl manager components;
55
56 `Lemonldap::NG::Common::Conf::DefaultValues`:
57 constants used to read configuration.
58
60 You can use a hash ref to override any LemonLDAP::NG parameter.
61 Currently, you can specify where your lemonldap-ng.ini file is:
62
63 Lemonldap::NG::Manager->run( { confFile => '/path/to/lemonldap-ng.ini' } );
64
65 lemonldap-ng.ini parameters
66 You can override any configuration parameter in lemonldap-ng.ini, but
67 some are required and can't be set to global configuration (as any
68 Lemonldap::NG module, you can also fix them in $opts hash ref passed as
69 argument to run() or new()).
70
71 [manager]
72 ;protection: choose one of none, authenticate, manager as explain in
73 ; Lemonldap::NG::Handler::PSGI::Router doc.
74 protection = manager
75
76 ;enabledModules: Modules to display. Default to `conf, sessions, notifications, 2ndFA`
77 enabledModules = conf, sessions, notifications, 2ndFA
78
79 ;logLevel: choose one of error, warn, notice, info, debug
80 ; See Lemonldap::NG::Common::PSGI doc for more
81 logLevel = notice
82
83 ;staticPrefix: set here the URI path to static content
84 ; See Lemonldap::NG::Common::PSGI doc for more
85 staticPrefix = static/
86
87 ;languages: Available interface languages
88 languages = en, fr
89
90 ;templateDir: path to the directory containing HTML templates
91 ; See Lemonldap::NG::Common::PSGI doc for more
92 templateDir = /usr/share/lemonldap-ng/manager/
93
95 <http://lemonldap-ng.org/>
96
98 LemonLDAP::NG team <http://lemonldap-ng.org/team>
99
101 Use OW2 system to report bug or ask for features:
102 <https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>
103
104 Note that if you want to post a ticket for a conf upload problem,
105 please see Lemonldap::NG::Manager::Conf::Parser before.
106
108 Lemonldap::NG is available at <https://lemonldap-ng.org/download>
109
111 See COPYING file for details.
112
113 This library is free software; you can redistribute it and/or modify it
114 under the terms of the GNU General Public License as published by the
115 Free Software Foundation; either version 2, or (at your option) any
116 later version.
117
118 This program is distributed in the hope that it will be useful, but
119 WITHOUT ANY WARRANTY; without even the implied warranty of
120 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
121 General Public License for more details.
122
123 You should have received a copy of the GNU General Public License along
124 with this program. If not, see <http://www.gnu.org/licenses/>.
125
126
127
128perl v5.36.1 2023-11-14 Lemonldap::NG::Manager(3)