Path: | README |
Last Update: | Thu Jul 30 08:40:37 -0400 2009 |
ruby library for object-oriented LDAP interction
Contributors: | * Dick Davies <rasputnik AT hellooperator.net>
|
‘Ruby/ActiveLdap’ is a ruby extension library which provides a clean objected oriented interface to the Ruby/LDAP[0] library. It was inspired by ActivRecord[3]. This is not nearly as clean or as flexible as ActiveRecord, but it is still trivial to define new objects and manipulate them with minimal difficulty.
For example and usage - read the rdoc in doc/ from lib/activeldap.rb. It is also available on the web at:
ruby-activeldap.rubyforge.org/
% sudo gem install activeldap
There is a small rails plugin included that allows the use of a file named ‘config/ldap.yml’ in the config directory of your rails app. This file has a similar function to the ‘database.yml’ file that allows you to set your database connection settings per environment. Similarly, the ldap.yml file allows settings to be set for development, test, and production environments. For instance, the development entry would look something like the following:
development: host: 127.0.0.1 port: 389 base: dc=localhost bind_dn: cn=admin,dc=localhost password: secret
To install, simply add the following codes to you config/environment.rb:
config.gem "activeldap", :lib => "active_ldap"
When your application starts up, the plugin will call ActiveLdap::Base.setup_connection using the parameters specified for your current environment.
This program is free software; you can redistribute it and/or modify it. It is dual licensed under Ruby‘s license and under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
Please see the file LICENSE for the terms of the licence.
This list may not be correct. If you notice mistakes of this list, please point out.