168 lines
6.0 KiB
HTML
168 lines
6.0 KiB
HTML
|
|
<!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 class="sectionedit1" id="quick_start_tutorial">Quick start tutorial</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>
|
|
<!-- EDIT1 SECTION "Quick start tutorial" [1-347] -->
|
|
<h2 class="sectionedit2" id="installation">Installation</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
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.
|
|
</p>
|
|
|
|
<p>
|
|
LemonLDAP::NG is written in Perl and requires a lot of Perl dependencies. <a href="../documentation/current/prereq.html" class="wikilink1" title="documentation:latest:prereq">You must install them first</a>.
|
|
</p>
|
|
|
|
<p>
|
|
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):
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT2 SECTION "Installation" [348-801] -->
|
|
<h3 class="sectionedit3" id="extract">Extract</h3>
|
|
<div class="level3">
|
|
<pre class="code">tar zxvf lemonldap-ng-*.tar.gz
|
|
cd lemonldap-ng-*</pre>
|
|
|
|
</div>
|
|
<!-- EDIT3 SECTION "Extract" [802-885] -->
|
|
<h3 class="sectionedit4" id="build">Build</h3>
|
|
<div class="level3">
|
|
<pre class="code">make
|
|
make test</pre>
|
|
|
|
</div>
|
|
<!-- EDIT4 SECTION "Build" [886-933] -->
|
|
<h3 class="sectionedit5" id="install">Install</h3>
|
|
<div class="level3">
|
|
<pre class="code">sudo make install</pre>
|
|
|
|
</div>
|
|
<!-- EDIT5 SECTION "Install" [934-986] -->
|
|
<h2 class="sectionedit6" id="configuration">Configuration</h2>
|
|
<div class="level2">
|
|
|
|
</div>
|
|
<!-- EDIT6 SECTION "Configuration" [987-1013] -->
|
|
<h3 class="sectionedit7" id="system">System</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Update your /etc/hosts to map <abbr title="Single Sign On">SSO</abbr> URLs to localhost:
|
|
</p>
|
|
<pre class="code">sudo make postconf</pre>
|
|
|
|
</div>
|
|
<!-- EDIT7 SECTION "System" [1014-1119] -->
|
|
<h3 class="sectionedit8" id="apache">Apache</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
|
|
<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>
|
|
|
|
<p>
|
|
Restart Apache:
|
|
</p>
|
|
<pre class="code">sudo apachectl configtest
|
|
sudo apachectl restart</pre>
|
|
|
|
</div>
|
|
<!-- EDIT8 SECTION "Apache" [1120-1537] -->
|
|
<h2 class="sectionedit9" id="run">Run</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
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:
|
|
</p>
|
|
<div class="table sectionedit10"><table class="inline">
|
|
<thead>
|
|
<tr class="row0 roweven">
|
|
<th class="col0 leftalign"> Login </th><th class="col1"> Password </th><th class="col2"> Role </th>
|
|
</tr>
|
|
</thead>
|
|
<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></div>
|
|
<!-- EDIT10 TABLE [1720-1852] -->
|
|
</div>
|
|
<!-- EDIT9 SECTION "Run" [1538-1854] -->
|
|
<h3 class="sectionedit11" id="open_sso_session">Open SSO session</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
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.
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT11 SECTION "Open SSO session" [1855-1960] -->
|
|
<h3 class="sectionedit12" id="access_protected_application">Access protected application</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
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>
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT12 SECTION "Access protected application" [1961-2058] -->
|
|
<h3 class="sectionedit13" id="edit_configuration">Edit configuration</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
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>
|
|
</p>
|
|
|
|
</div>
|
|
</div><!-- closes <div class="dokuwiki export">--> |