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

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

2.1 - Apache
16

17
Enable the components you've installed:
18

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

  # Manager
23
  a2ensite manager-apache2.conf
24

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

Xavier Guimard's avatar
Xavier Guimard 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

Xavier Guimard's avatar
Xavier Guimard 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.
Xavier Guimard's avatar
Xavier Guimard committed
55 56
  ln -s ../sites-available/handler-nginx.conf

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

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

  service nginx reload

64 65
3 - Check your DNS
------------------
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!
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

Xavier Guimard's avatar
Xavier Guimard 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

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