#=ActiveDirectoryForRuby
#
# Allows easy bare minimum access to MS Windows Server's
# ActiveDirectory data and authentication
#
#=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'
#
#=Configuration File
#
# The format for the configuratio file is as follows:
#---
# # Server info, host ip or name, and port
# # which usually will be 389 for a common
# # MS Windows server
# server:
# host : intranet.nuclearplant.com
# port : 389
#
# # Administrator or authenticating login info
# # distinguished_name
# admin:
# distinguished_name : CN=Montgomery Burns,CN=Admins,DC=nuclearplant,DC=com
# user_name : NUKEPLANT\montgomery.burns
# password : burnsy
#
# # The user data base structure and
# # the field name containing user names
# # which is usually sAMAccountName
# search:
# base : OU=USA,DC=nuclearplant,DC=com
# field : sAMAccountName
#---
#
#=License
#
# Copyright (c) 2007 Juan Gabriel Medina Marquez
# Released under the GNU Lesser General Public License
#