Intro
web2ldap is designed to be very flexible. It can be installed in
different modes either running persistent or non-persistent under
Win32 and Unix platforms:
- stand-alone
-
You can start web2ldap as stand-alone web server running
on a specific address and port. You can even serve some
other static web pages in that mode.
- CGI-BIN
-
If you have already a running web server with support
for CGI-BIN programs (like almost every web server has)
you can use web2ldap as simple CGI-BIN program.
- mod_python
-
If you are running the Apache web server and
want to speed things up by persistence of the Python
interpreter and modules you might want to consider
running web2ldap as handler under the control of
mod_python.
Requirements
For running web2ldap you need at least:
Web server
Additional web server software depends on the running mode:
Running mode | web server | SSL support |
CGI-BIN |
Any web server capable of calling external programs
through CGI-BIN interface
|
SSL support by web server. Ask the vendor of your web server.
|
mod_python |
Apache with Apache module
mod_python
(apply patch found in web2ldap/mod_python/patch-header-crlf
to mod_python/apache.py)
|
Apache SSL or
Apache with mod_ssl
|
stand-alone |
built-in
|
requires module M2Crypto
|
Pre-compiled packages
Ready-to-use packages of the required software in current Linux distributions:
-
The Linux distribution S.u.S.E.
already has packages of Python, OpenLDAP, OpenSSL, Apache with mod_ssl and
ldapmodule (since 6.2) for Python.
-
Red Hat has included the Python
interpreter with their Linux distribution. You might consider to grab some
pre-packaged RPMs of OpenLDAP,
ldapmodule and web2ldap.
-
I was told by
Lorenzo M. Catucci
that the upcoming Debian-Release
(nickname Potato) will include packages of Python, OpenLDAP, OpenSSL and
ldapmodule for Python as well as ApacheSSL and Apache with mod_ssl.
Ready-to-use packages for Windows.
Documentation to get the required LDAP stuff working:
Installing
Unix platform
-
Install all required software
on your system.
-
Extract content of archive web2ldap-*.tar.gz to /usr/lib/web2ldap.
-
Choose the right script web2ldap.py for your running mode,
adjust the path to the python excutable in the web2ldap.py script
and copy it to the appropriate directory:
- stand-alone
-
sbin/web2ldap.py should go into /usr/sbin or /usr/local/sbin.
- CGI-BIN
-
cgi-bin/web2ldap.py should go into a directory which
your web server uses for executing scripts.
- mod_python
-
mod_python/web2ldap.py should go into a directory which
has the right mod_python directives set.
Example:
<Directory /usr/local/httpd/htdocs/mod_python>
AddHandler python-program .py
PythonHandler web2ldap
</Directory>
-
Edit configuration modules under /usr/lib/web2ldap/etc/web2ldap/web2ldapcnf/
which contain comments about every configuration parameter.
See also the documentation
(which might be outdated sometimes).
-
Call
python sbin/compile.py
and
python -O sbin/compile.py
for compiling all
sources.
-
Copy directory web2ldap/etc/web2ldap to /etc.
-
For a quick start as stand-alone web gateway
simply invoke the script /usr/sbin/web2ldap.py
which outputs the start URL before detaching from console.
Windows platform
Maybe another person should figure out the optimal way
of installing under Windows...
-
Install all required software
on your system.
-
Page last modified: Sunday, 30-Jul-2000 12:10:05 CEST,
© by
Michael Ströder <michael@stroeder.com>