2010-10-13 12:29:02 +02:00
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" xml:lang = "en"
lang="en" dir="ltr">
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > < / title >
<!-- metadata -->
< meta name = "generator" content = "Offline" / >
< meta name = "version" content = "Offline 0.1" / >
<!-- style sheet links -->
< link rel = "stylesheet" media = "all" type = "text/css" href = "../../css/all.css" / >
< link rel = "stylesheet" media = "screen" type = "text/css" href = "../../css/screen.css" / >
< link rel = "stylesheet" media = "print" type = "text/css" href = "../../css/print.css" / >
< / head >
< body >
< div class = "dokuwiki export" >
< h1 > < a name = "quick_start_tutorial" id = "quick_start_tutorial" > Quick start tutorial< / a > < / h1 >
< div class = "level1" >
< p >
< p > < div class = "noteimportant" >
This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:
< / p >
< ul >
< li class = "level1" > < div class = "li" > A computer with a GNU/Linux or recent UNIX system< / div >
< / li >
< li class = "level1" > < div class = "li" > A web browser launched from the computer (to access localhost)< / div >
< / li >
< li class = "level1" > < div class = "li" > A cup of coffee (or tea, we are open minded)< / div >
< / li >
< / ul >
< p >
< / div > < / p >
< / p >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Quick start tutorial" [1 - 347] -->
2010-10-13 12:29:02 +02:00
< h2 > < a name = "installation" id = "installation" > Installation< / a > < / h2 >
< div class = "level2" >
< p >
2010-11-30 17:35:45 +01:00
You can install Lemonldap::NG using < a href = "../download.html" class = "wikilink1" title = "download" > packages< / a > (rpm or deb) or by hand as described below.
2010-10-30 10:41:59 +02:00
< / p >
< p >
2012-02-26 15:54:43 +01:00
LemonLDAP::NG is written in < acronym title = "Practical Extraction and Report Language" > Perl< / acronym > and requires a lot of < acronym title = "Practical Extraction and Report Language" > Perl< / acronym > dependencies. < a href = "../documentation/current/prereq.html" class = "wikilink1" title = "documentation:latest:prereq" > You must install them first< / a > .
2010-10-13 12:29:02 +02:00
< / p >
< p >
2012-02-26 15:54:43 +01:00
Get the tarball on < a href = "../download.html" class = "wikilink1" title = "download" > download page< / a > and follow next steps (or install using < a href = "../documentation/current/installrpm.html" class = "wikilink1" title = "documentation:latest:installrpm" > RPM< / a > or < a href = "../documentation/current/installdeb.html" class = "wikilink1" title = "documentation:latest:installdeb" > Debian< / a > packages):
2010-10-13 12:29:02 +02:00
< / p >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Installation" [348 - 801] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "extract" id = "extract" > Extract< / a > < / h3 >
< div class = "level3" >
< pre class = "code" >
2010-11-14 09:22:01 +01:00
tar zxvf lemonldap-ng-*.tar.gz
cd lemonldap-ng-*
2010-10-13 12:29:02 +02:00
< / pre >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Extract" [802 - 885] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "build" id = "build" > Build< / a > < / h3 >
< div class = "level3" >
< pre class = "code" >
2010-11-14 09:22:01 +01:00
make
make test
2010-10-13 12:29:02 +02:00
< / pre >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Build" [886 - 933] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "install" id = "install" > Install< / a > < / h3 >
< div class = "level3" >
< pre class = "code" >
2010-11-14 09:22:01 +01:00
sudo make install
2010-10-13 12:29:02 +02:00
< / pre >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Install" [934 - 986] -->
2010-10-13 12:29:02 +02:00
< h2 > < a name = "configuration" id = "configuration" > Configuration< / a > < / h2 >
< div class = "level2" >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "Configuration" [987 - 1013] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "system" id = "system" > System< / a > < / h3 >
< div class = "level3" >
< p >
2010-10-22 17:44:20 +02:00
Update your /etc/hosts to map < acronym title = "Single Sign On" > SSO< / acronym > URLs to localhost:
2010-10-13 12:29:02 +02:00
< / p >
< pre class = "code" >
2010-11-14 09:22:01 +01:00
sudo make postconf
2010-10-13 12:29:02 +02:00
< / pre >
< / div >
2012-06-16 23:24:08 +02:00
<!-- SECTION "System" [1014 - 1119] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "apache" id = "apache" > Apache< / a > < / h3 >
< div class = "level3" >
< p >
Include LemonLDAP::NG configuration in your main Apache configuration:
< / p >
< pre class = "code file apache" > < span class = "kw1" > include< / span > /usr/local/lemonldap-ng/etc/portal-apache2.conf
< span class = "kw1" > include< / span > /usr/local/lemonldap-ng/etc/handler-apache2.conf
2013-01-05 12:56:59 +01:00
< span class = "kw1" > include< / span > /usr/local/lemonldap-ng/etc/manager-apache2.conf
< span class = "kw1" > include< / span > /usr/local/lemonldap-ng/etc/test-apache2.conf< / pre >
2010-10-13 12:29:02 +02:00
< p >
Restart Apache:
< / p >
< pre class = "code" >
2010-11-14 09:22:01 +01:00
sudo apachectl configtest
sudo apachectl restart
2010-10-13 12:29:02 +02:00
< / pre >
< / div >
2013-01-05 12:56:59 +01:00
<!-- SECTION "Apache" [1120 - 1537] -->
2010-10-13 12:29:02 +02:00
< h2 > < a name = "run" id = "run" > Run< / a > < / h2 >
< div class = "level2" >
2012-06-16 23:24:08 +02:00
< p >
2012-06-18 12:33:45 +02:00
Since LemonLDAP::NG 1.2, the < a href = "../documentation/current/authdemo.html" class = "wikilink1" title = "documentation:latest:authdemo" > demonstration backend< / a > is configured by default. Demonstration backend has hard coded user accounts:
2012-06-16 23:24:08 +02:00
< / p >
< table class = "inline" >
< tr class = "row0 roweven" >
< th class = "col0 leftalign" > Login < / th > < th class = "col1" > Password < / th > < th class = "col2" > Role < / th >
< / tr >
< tr class = "row1 rowodd" >
< td class = "col0 centeralign" > rtyler < / td > < td class = "col1 centeralign" > rtyler < / td > < td class = "col2 centeralign" > user < / td >
< / tr >
< tr class = "row2 roweven" >
< td class = "col0 centeralign" > msmith < / td > < td class = "col1 centeralign" > msmith < / td > < td class = "col2 centeralign" > user < / td >
< / tr >
< tr class = "row3 rowodd" >
< td class = "col0 centeralign" > dwho < / td > < td class = "col1 centeralign" > dwho < / td > < td class = "col2 centeralign" > administrator < / td >
< / tr >
< / table >
2010-10-13 12:29:02 +02:00
< / div >
2013-01-05 12:56:59 +01:00
<!-- SECTION "Run" [1538 - 1854] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "open_sso_session" id = "open_sso_session" > Open SSO session< / a > < / h3 >
< div class = "level3" >
< p >
2012-06-16 23:24:08 +02:00
Go on < a href = "http://auth.example.com" class = "urlextern" title = "http://auth.example.com" rel = "nofollow" > http://auth.example.com< / a > and log with one of the demonstration account.
2010-10-13 12:29:02 +02:00
< / p >
< / div >
2013-01-05 12:56:59 +01:00
<!-- SECTION "Open SSO session" [1855 - 1960] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "access_protected_application" id = "access_protected_application" > Access protected application< / a > < / h3 >
< div class = "level3" >
< p >
2010-10-22 17:44:20 +02:00
Try < a href = "http://test1.example.com" class = "urlextern" title = "http://test1.example.com" rel = "nofollow" > http://test1.example.com< / a > or < a href = "http://test2.example.com" class = "urlextern" title = "http://test2.example.com" rel = "nofollow" > http://test2.example.com< / a >
2010-10-13 12:29:02 +02:00
< / p >
< / div >
2013-01-05 12:56:59 +01:00
<!-- SECTION "Access protected application" [1961 - 2058] -->
2010-10-13 12:29:02 +02:00
< h3 > < a name = "edit_configuration" id = "edit_configuration" > Edit configuration< / a > < / h3 >
< div class = "level3" >
< p >
2012-06-16 23:24:08 +02:00
Log with the dwho account and go on < a href = "http://manager.example.com" class = "urlextern" title = "http://manager.example.com" rel = "nofollow" > http://manager.example.com< / a >
2010-10-13 12:29:02 +02:00
< / p >
< / div >
2013-01-05 12:56:59 +01:00
<!-- SECTION "Edit configuration" [2059 - ] --> < / div > <!-- closes <div class="dokuwiki export"> -->