162 lines
5.0 KiB
HTML
162 lines
5.0 KiB
HTML
<?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>
|