A couchDB plugin that allows LDAP authentication, based on https://github.com/chao/couchdb/ and https://github.com/etnt/eldap.
To get started, you need to install CouchDB from source, grab the CouchDB sources:
git clone https://git-wip-us.apache.org/repos/asf/couchdb.git
cd couchdb
Follow the instructions in couchdb/INSTALL.Unix and couchdb/DEVELOPERS to get a development environment going.
Be sure to install CouchDB into your system. If you want to install CouchDB into a development directory, make sure that the bin/ folder of that directory is in your PATH.
Next, install rebar from https://github.com/rebar/rebar. Rebar is a build tool for Erlang projects and it makes our lives a lot easier.
To compile your code, simply run:
make
The output should be something like this:
ERL_LIBS=<..>: rebar compile
==> ldap_auth (compile)
Compiled src/eldap/eldap_sup.erl
src/ldap_auth.erl:101: Warning: variable 'LDAPRecord' is unused
Compiled src/ldap_auth.erl
Compiled src/eldap/eldap_app.erl
Compiled src/eldap/eldap_fsm.erl
Compiled src/eldap/eldap.erl
Compiled src/eldap/ELDAPv3.erl
To run CouchDB with your new plugin make sure CouchDB isn’t already running elsewhere and then do this:
make dev
Publishing a plugin is both simple and not so simple. The mechanics are trivial, just type:
make plugin
and you will see something like this:
> make plugin
rebar compile
==> ldap_auth (compile)
my_first_couchdb_plugin-1.0.0-R15B03-1.4.0.tar.gz: 1/MeXYfxeBK7DQyk10/6ucIRusc=
That’s the easy part. The hard part is publishing the plugin. And since this is subject to change a lot in the near future, we will punt on explaining this in detail here, but to see how it works, look into this file in the CouchDB source distribution: share/www/plugins.html
===== Configuring couchdb =====
https://github.com/chao/couchdb/wiki/How-to-configure-couchdb-to-use-ldap-authentication-handler