configure OPAC_URL
[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 users)
6 to some other system as LDAP server. This supports arbitrary number of objectClass
7 objects (one per SQL file) and allows export of groups from RDBMS to LDAP groups.
8
9
10 Install with:
11
12   cd /srv
13   svn co svn://svn.rot13.org/virtual-ldap/
14
15   cd virtual-ldap
16   ./bin/install-debian.sh
17
18
19 If you need to augment or mungle LDAP from upstream server start:
20
21   ./bin/ldap-rewrite.pl
22
23 You might want to edit configuration at top of script itself, especially
24 overlay_prefix if you want your YAML data to be without it.
25
26 To augment data with your own, you should create files
27
28   yaml/uid=login,dc=example,dc=com
29
30 If you have test user in your LDAP edit configuration file and run tests:
31
32   cp t/config.pl.template t/config.pl
33   vi t/config.pl
34   ./t/ldap-rewrite.t
35
36
37 If you want to expose MySQL Koha database as LDAP server start:
38
39   ./bin/ldap-koha.pl
40
41
42 Home page for this program (please register your usage) is:
43
44   https://www.ohloh.net/p/virtual-ldap