Quick start tutorial

This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:

A computer with a GNU/Linux or recent UNIX system
A web browser launched from the computer (to access localhost)
A cup of coffee (or tea, we are open minded)

Installation

You can install Lemonldap::NG using packages (rpm or deb) or by hand as described below.

LemonLDAP::NG is written in Perl and requires a lot of Perl dependencies. You must install them first.

Get the tarball on download page and follow next steps (or install using RPM or Debian packages):

Extract

tar zxvf lemonldap-ng-*.tar.gz
cd lemonldap-ng-*

Build

make
make test

Install

sudo make install

Configuration

System

Update your /etc/hosts to map SSO URLs to localhost:

sudo make postconf

Apache

Include LemonLDAP::NG configuration in your main Apache configuration:

include /usr/local/lemonldap-ng/etc/portal-apache2.conf
include /usr/local/lemonldap-ng/etc/handler-apache2.conf
include /usr/local/lemonldap-ng/etc/manager-apache2.conf
include /usr/local/lemonldap-ng/etc/test-apache2.conf

Restart Apache:

sudo apachectl configtest
sudo apachectl restart

Nginx

Include LemonLDAP::NG configuration in your Nginx configuration

include /usr/local/lemonldap-ng/etc/portal-nginx.conf;
include /usr/local/lemonldap-ng/etc/handler-nginx.conf;
include /usr/local/lemonldap-ng/etc/manager-nginx.conf;
include /usr/local/lemonldap-ng/etc/test-nginx.conf;

Restart Nginx:

sudo nginx -t
sudo service nginx restart

Run

Since LemonLDAP::NG 1.2, the demonstration backend is configured by default. Demonstration backend has hard coded user accounts:

Login	Password	Role
rtyler	rtyler	user
msmith	msmith	user
dwho	dwho	administrator

Open SSO session

Go on http://auth.example.com and log with one of the demonstration account.

Access protected application

Try http://test1.example.com or http://test2.example.com

Edit configuration

Log with the dwho account and go on http://manager.example.com

Table of Contents