Saturday, December 08, 2007

ActiveDirectoryForRuby - New Baby Gem

ActiveDirectoryForRuby

Hi, I just released a new tiny-weenie-itty-bitty little gem that allows for easy access to ActiveDirectory data and authentication, provides just two functions: authenticate and [] operator. From the gem rdoc site:

How To Install

You can either: Install the gem directly with:
 $ sudo gem install ActiveDirectoryForRuby
OR download and install the gem file from:
 $ wget http://rubyforge.org/frs/download.php/28898/ActiveDirectoryForRuby-0.1.8.gem
 $ sudo gem install ActiveDirectoryForRuby-0.1.8.gem

How To Use

Just create an ActiveDirectoryForRuby object, and pass your YAML configuration file as follows:
 myconn = ActiveDirectoryForRuby::ActiveDirectoryForRuby.new('myconfig.yml')
Then, you can authenticate a user like this:
 myconn.authenticate('user.name', 'somepass') # returns true/false
And get a user's data with:
 myconn['user.name'].ldap_givenname # returns 'User'
As my other works, this is released under the LGPL license.

Where?

You can find the gem here: http://ad4ruby.rubyforge.org/ActiveDirectoryForRuby/rdoc/

Thanks for reading!