Net::LDAP for Ruby (also called net-ldap) implements client access for the Lightweight Directory Access Protocol (LDAP), an IETF standard protocol for accessing distributed directory services. Net::LDAP is written completely in Ruby with no external dependencies. It supports most LDAP client features and a subset of server features as well.
Net::LDAP has been tested against modern popular LDAP servers including OpenLDAP and Active Directory. The current release is mostly compliant with earlier versions of the IETF LDAP RFCs (2251–2256, 2829–2830, 3377, and 3771). Our roadmap for Net::LDAP 1.0 is to gain full client compliance with the most recent LDAP RFCs (4510–4519, plus portions of 4520–4532).
The Net::LDAP for Ruby documentation, project description, and main downloads can currently be found on RubyForge.
Net::LDAP for Ruby is a pure-Ruby library and currently depends on no external libraries for execution. It will run on a Ruby 1.8.7 interpreter or better.
If you want to make changes to Net::LDAP for Ruby or build a gem yourself, you will need:
- rspec 2
You can install the RubyGems version of Net::LDAP available from the usual sources.
gem install net-ldap
Simply require either 'net-ldap' or 'net/ldap'.
You can clone the project with Git by running:
% git clone git://github.com/ruby-ldap/ruby-net-ldap
For non-RubyGems installations of Net::LDAP, you can use Minero Aoki's setup.rb as the layout of Net::LDAP is compliant. The setup installer is not included in the Net::LDAP repository.
Net::LDAP was originally developed by:
- Francis Cianfrocca (garbagecat)
- Emiel van de Laar (emiel)
- Rory O'Connell (roryo)
- Kaspar Schiess (kschiess)
- Austin Ziegler (halostatue)
- Dimitrij Denissenko (dim)
- James Hewitt (jamstah)
- Kouhei Sutou (kou)
- Lars Tobias Skjong-Børsting (larstobi)
- Rory O'Connell (roryo)
- Tony Headford (tonyheadford)
- Derek Harmel (derekharmel)
- Erik Hetzner (egh)
This software is available under the terms of the MIT license.
Copyright © 2006–2011 by Francis Cianfrocca and other contributors.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Notice of License Change
Versions prior to 0.2 were under Ruby's dual license with the GNU GPL. With release 0.2, Net::LDAP is now under the MIT license.