3cb1666f9321a11a5cdff302613bb653b98920ac
[virtual-ldap] / README
1 Virtual LDAP is set of perl scripts which allows you to augment data in your
2 existing LDAP server (which you don't want to modify) using ldap-rewrite.pl
3 (supporting rewrite of bind request, search requests and responses).
4
5 Alternative usage is to expose SQL database (currently Koha database with uses)
6 to some other system as LDAP server.
7
8
9 Install with:
10
11   cd /srv
12   svn co svn://svn.rot13.org/virtual-ldap/
13
14   cd virtual-ldap
15   ./bin/install-debian.sh
16
17
18 If you need to augment or mungle LDAP from upstream server start:
19
20   ./bin/ldap-rewrite.pl
21
22 You might want to edit configuration at top of script itself, especially
23 overlay_prefix if you want your YAML data to be without it.
24
25 To augment data with your own, you should create files
26
27   yaml/uid=login,dc=example,dc=com
28
29 If you have test user in your LDAP edit configuration file and run tests:
30
31   cp t/config.pl.template t/config.pl
32   vi t/config.pl
33   ./t/ldap-rewrite.t
34
35
36 If you want to expose MySQL Koha database as LDAP server start:
37
38   ./bin/ldap-koha.pl
39
40
41 Home page for this program (please register your usage) is:
42
43   https://www.ohloh.net/p/virtual-ldap