<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org" />
<title>Lemonldap::NG documentation: 3.5-Install-of-example.html</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<style type="text/css">
/*<![CDATA[*/
body{
background: #ddd;
font-family: sans-serif;
font-size: 11pt;
padding: 0 50px;
}
div.main-content{
padding: 10px;
background: #fff;
border: 2px #ccc solid;
}
a{
text-decoration: none;
}
p.footer{
text-align: center;
margin: 5px 0 0 0;
}
.heading-1{
text-align: center;
color: orange;
font-variant: small-caps;
font-size: 20pt;
}
.heading-1-1{
color: orange;
font-size: 14pt;
border-bottom: 2px #ccc solid;
}
pre{
background: #eee;
border: 2px #ccc solid;
padding: 5px;
border-left: 10px #ccc solid;
}
ul.star li{
list-style-type: square;
}
/*]]>*/
</style>
</head>
<body>
<div class="main-content">
<h2 class="heading-1"><span id=
"HInstallationoftheprovidedexample">Installation of the provided
example</span></h2>
<p class="paragraph"></p>
<ul>
<li><a href="#HFormthetarball">Form the tarball</a></li>
<li><a href="#HFromDebianpackages">From Debian packages</a></li>
<li><a href="#HConfiguration">Configuration</a></li>
</ul>The proposed example use a protected site named test.example.com. Non
authenticated users are redirected to auth.example.com.
<h3 class="heading-1-1"><span id="HFormthetarball">Form the
tarball</span></h3>
<p class="paragraph"></p>First follow the <span class="wikilink"><a href=
"3.2-Install-from-tarball.html">tarball installation
instruction</a></span>. Then run:
<div class="code">
<pre>
$ make example
</pre>
</div>
<h3 class="heading-1-1"><span id="HFromDebianpackages">From Debian
packages</span></h3><br />
<br />
First follow the <span class="wikilink"><a href=
"3.3-Install-from-debian-packages.html">debian installation
procedure</a></span>. The example is provided with the package, nothing
left to do.
<h3 class="heading-1-1"><span id=
"HConfiguration">Configuration</span></h3><br />
<br />
After build, you have a new file named example/apache.conf. You just have
to include this file in Apache configuration:<br />
<br />
<div class="code">
<pre>
# Apache-1.3: add <span class="java-keyword">this</span> to httpd.conf
include /path/to/lemonldap-ng/source/example/apache.conf
# Apache-2.x:
include /path/to/lemonldap-ng/source/example/apache2.conf
# Debian Apache-1.3
ln -s /usr/share/doc/lemonldap-ng/example/apache.conf /etc/apache/conf.d/test.conf
# or with Apache-2.x
ln -s /usr/share/doc/lemonldap-ng/example/apache2.conf /etc/apache2/sites-enabled/test.conf
</pre>
</div>
<p class="paragraph"></p>Modify your /etc/hosts file to include:
<div class="code">
<pre>
127.0.0.2 auth.example.com
127.0.0.3 test.example.com
127.0.0.4 manager.example.com
</pre>
</div>
<p class="paragraph"></p>Now you have to edit configuration to set your
LDAP settings. You can either use :
<ul class="star">
<li>the manager interface: restart Apache and connect to <span class=
"nobr"><a href=
"http://manager.example.com/">http://manager.example.com/</a></span></li>
<li>edit /path/to/lemonldap-ng/source/example/lmConfig-1 and specify
your LDAP settings (Debian users:
/usr/share/doc/lemonldap-ng/example/conf/lmConfig-1).</li>
</ul>If you don't set managerDn and managerPassword, Lemonldap::NG will
use an anonymous bind to find user dn.
<p class="paragraph"></p><strong class="strong">Warnings</strong>:
<ul class="star">
<li>only few parameters can be set by hand in the configuration file.
You have to use the manager to change configuration, but since the
example is yet configured, you can edit directly the file,</li>
<li>if you use the File backend to store configuration, you have to
check the rights of the directory to allow apache process (eg www-data
user) to read/write on it,</li>
<li>each new configuration is saved by the manager in a new file (or a
new record with DBI) so you can recover an old configuration by removing
the new one.</li>
</ul>Next, restart Apache and use your prefered browser and try to connect
to <span class="wikiexternallink"><a href=
"http://test.example.com/">http://test.example.com/</a></span>. You'll be
redirect to auth.example.com. Try to authenticate yourself with a valid
account and the protected page will appear.
</div>
<p class="footer"><a href="index.html">Index</a></p>
</body>
</html>
