ROM-LDAP is a ROM adapter for LDAP and provides lightweight directory object mapping for Ruby. This gem makes it easier to use LDAP in your project or even as your primary datastore and an alternative to back-ends like MongoDB or CouchDB.
ROM-LDAP is compatible with versions of Ruby 2.4 and above.
This project has evolved from a refactoring of the net-ldap gem and tries to emulate the functionality of rom-sql which is itself backed by the sequel gem.
A more detailed walk-through of rom-ldap can be found at pdhamilton.uk.
Add this line to your Gemfile:
gem 'rom-ldap'To configure a gateway connection to an LDAP server you can use environment variables or pass in a URI:
config = ROM::Configuration.new(:ldap, 'ldap://cn=admin,dc=rom,dc=ldap:topsecret@openldap')
ENV['LDAPURI'] = 'ldap://cn=admin,dc=rom,dc=ldap:topsecret@openldap'
config = ROM::Configuration.new(:ldap)
rom = ROM.container(config)
directory = ROM.container(config).directory
=> #<ROM::LDAP::Directory
uri='ldap://cn=admin,dc=rom,dc=ldap:topsecret@openldap'
vendor='OpenLDAP'
version='0.0' />For the greatest compatibility with Ruby method naming you can pass the optional "compatibility" extension whilst configuring the gateway. This will format the attributes of directory entries into names suitable for ruby methods by converting camelCase and kebab-case to snake_case.
config = ROM::Configuration.new(:ldap, extensions: [:compatibility])The ROM::LDAP::Relation class already has support for exporting to JSON, YAML and LDIF.
Other extensions are available including exporting to DSML format.
config = ROM::Configuration.new(:ldap, extensions: [:dsml_export]) do |conf|
conf.relation(:all) { schema('(cn=*)', infer: true) }
end
rom = ROM.container(config)
rom.relations[:all].to_dsmlThe project has docker provision for four opensource LDAP servers to test against;
see spec/fixtures/vendors.yml for connection details.
Allow the dependent services to boot before running the specs in the gem container.
$ cd docker
$ docker-compose up -d apacheds openldap 389ds opendj
$ docker-compose up rom
-
ApacheDS is an extensible and embeddable directory server entirely written in Java.
-
OpenLDAP is a high performance replacement for Oracle Corporation's Berkeley DB. It is mostly written in C and its functionality can be extended with additional modules.
-
389DS from the Fedora Project is also written in Java.
-
OpenDJ Community Edition from the Open Identity Platform is written in Java.
A custom schema is loaded into each of the servers and defines attribute types and object classes used in the tests and examples.
Apache Directory Studio is a cross-platform platform LDAP management application with a graphic interface.
For convenience, you can import the predefined connection settings for the docker environment using the included file
spec/fixtures/vendors.lbc.
Alternatively, if you have the ldapmodify command installed on your development machine,
you can use a rake task to import a folder of LDIF files:
$ LDAPURI=ldap://localhost:4389 \
LDAPBINDDN='cn=Directory Manager' \
LDAPBINDPW=topsecret \
LDAPDIR=./examples/ldif \
rake ldap:modify
Or, you could import the 1000 example users included with this project, with no dependency on other software.
The DEBUG variable will print to screen any response from the server that would normally be logged.
$ DEBUG=y \
LDAPURI='ldap://cn=Directory Manager:topsecret@localhost:4389' \
rake 'ldif:import[examples/ldif/users.ldif]'
The console script connects and loads Pry so you can explore your directory on the command line.
$ ./bin/console
To see a demonstration in action you can explore the examples after loading the seed data.
$ rake 'ldif:import[examples/ldif/animals.ldif]'
$ ./examples/fauna.rb
Check out Fauna which is a more complete version of the example above and models data on evolutionary taxonomy.
If you use Rails then try the rom-ldap-rails repository, for a skeleton version of this same example applied to the Ruby on Rails framework.