lemonldap-ng.README.Debian 2.34 KB
Newer Older
1
FIRST CONFIGURATION STEPS
2

3
4
1 - Change default DNS domain
-----------------------------
5

6
7
By default, DNS domain is example.com. You can change using dpkg-reconfigure or
with a quick sed command. For example, we change it to ow2.org:
8

9
  sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/* \
10
         /var/lib/lemonldap-ng/conf/lmConf-1.js /var/lib/lemonldap-ng/test/index.pl
11

Yadd's avatar
Yadd committed
12
13
14
15
2 - Enable LL::NG sites
-----------------------

2.1 - Apache
16

17
Enable the components you've installed:
18

Yadd's avatar
Yadd committed
19
  # Portal
Yadd's avatar
Yadd committed
20
  a2ensite portal-apache2.conf
Yadd's avatar
Yadd committed
21
22

  # Manager
Yadd's avatar
Yadd committed
23
  a2ensite manager-apache2.conf
24

Yadd's avatar
Yadd committed
25
  # Handler
Yadd's avatar
Yadd committed
26
27
  a2ensite handler-apache2.conf
  a2ensite test-apache2.conf
Yadd's avatar
Yadd committed
28

Yadd's avatar
Yadd committed
29
customize them and enable mod_perl if not already loaded:
30

31
  a2enmod perl
32

33
Then restart Apache:
34

35
36
  apache2ctl configtest
  apache2ctl restart
37

Yadd's avatar
Yadd committed
38
39
40
41
42
43
44
45
46
47
48
49
50
2.2 - Nginx

Enable the components you've installed:

  cd /etc/nginx/sites-enabled

  # Portal
  ln -s ../sites-available/portal-nginx.conf

  # Manager
  ln -s ../sites-available/manager-nginx.conf

  # Handler
51
52
53
54
  # Warning: if no site is protected (see example files for this), the
  # $lmremote_user variable will not be set. So you can't load this file since
  # it includes /etc/lemonldap/nginx-lmlog.conf that requires at least one
  # protected virtual host.
Yadd's avatar
Yadd committed
55
56
  ln -s ../sites-available/handler-nginx.conf

57
58
59
  # Test site
  ln -s ../site-available/test-nginx.conf

Yadd's avatar
Yadd committed
60
61
62
63
Customize then, then reload nginx

  service nginx reload

64
65
3 - Check your DNS
------------------
Yadd's avatar
Yadd committed
66

67
68
69
Be sure that your browser can join (adapt it with your domain):
- auth.example.com   : the authentication portal
- manager.example.com: the configuration interface
70

71
72
4 - Connect to the manager
--------------------------
73

74
75
Go to http://manager.example.com/, you'll be redirected to the portal. Then
enjoy!
Clément OUDOT's avatar
Clément OUDOT committed
76

77
78
5 - Default accounts
--------------------
79

80
81
By default, LemonLDAP::NG use "Demo" authentication backend, so you can use the
following accounts:
82

83
84
85
86
  Login  Password    Role
  rtyler  rtyler     user
  msmith  msmith     user
   dwho    dwho  administrator
87

Yadd's avatar
Yadd committed
88
89
90
91
92
93
94
95
96
6 - Base configuration file
---------------------------

The configuration is managed by the manager with the exception of some basic
parameters such as the storage type configuration. These parameters are defined
in the file /etc/lemonldap-ng/lemonldap-ng.ini.

This file can also be used to override the global configuration locally

97
98
6 - See more
------------
99

Yadd's avatar
Yadd committed
100
https://lemonldap-ng.org/
101