Skip to content

ruby-ldap/ruby-net-ldap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8ba4796 · Jun 16, 2016
Jun 16, 2016
Jan 5, 2016
Jun 16, 2016
Jan 13, 2016
Oct 31, 2014
Jan 12, 2016
Jan 13, 2016
Jan 5, 2016
Oct 27, 2014
Jan 5, 2016
Apr 12, 2013
Oct 31, 2014
Feb 3, 2016
Mar 18, 2011
Jan 23, 2016
May 13, 2015
Dec 1, 2015

Repository files navigation

Description

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).

Where

Synopsis

See Net::LDAP for documentation and usage samples.

Requirements

Net::LDAP requires a Ruby 2.0.0 compatible interpreter or better.

Install

Net::LDAP is a pure Ruby library. It does not require any external libraries. 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’.

Extensions

This library focuses on the core LDAP RFCs referenced in the description. However, we recognize there are commonly used extensions to the spec that are useful. If there is another library which handles it, we list it here.

  • resolv-srv: Support RFC2782 SRV record lookup and failover

Develop

This task will run the test suite and the RuboCop static code analyzer.

rake rubotest

To run the integration tests against an LDAP server:

cd test/support/vm/openldap
vagrant up
cd ../../../..
INTEGRATION=openldap bundle exec rake rubotest

Release

This section is for gem maintainers to cut a new version of the gem.

  • Check out a new branch ‘release-VERSION`

  • Update lib/net/ldap/version.rb to next version number X.X.X following {semver}(semver.org/).

  • Update ‘History.rdoc`. Get latest changes with `script/changelog`

  • Open a pull request with these changes for review

  • After merging, on the master branch, run ‘script/release`

:include: Contributors.rdoc

:include: License.rdoc