https://github.com/ruby-ldap/ruby-net-ldap

Pure Ruby LDAP library
https://github.com/ruby-ldap/ruby-net-ldap

hacktoberfest ldap ruby

Last synced: 2 days ago
JSON representation

Pure Ruby LDAP library

• Host: GitHub
• URL: https://github.com/ruby-ldap/ruby-net-ldap
• Owner: ruby-ldap
• License: other
• Created: 2011-03-22T03:52:14.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2024-10-29T02:12:31.000Z (about 2 months ago)
• Last Synced: 2024-10-29T13:50:53.196Z (about 2 months ago)
• Topics: hacktoberfest, ldap, ruby
• Language: Ruby
• Homepage: https://rubygems.org/gems/net-ldap
• Size: 1.45 MB
• Stars: 400
• Watchers: 21
• Forks: 254
• Open Issues: 83
• Metadata Files:
  • Readme: README.rdoc
  • Changelog: History.rdoc
  • Contributing: CONTRIBUTING.md
  • License: License.rdoc

Awesome Lists containing this project

• awesome-ruby-toolbox - net-ldap - 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 <em>client</em> compliance with the most recent LDAP RFCs (4510-4519, plutions of 4520-4532). (Security / LDAP)

README

        
= Net::LDAP for Ruby 

{}[https://badge.fury.io/rb/net-ldap]

{}[https://travis-ci.org/ruby-ldap/ruby-net-ldap]

== 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

* {GitHub}[https://github.com/ruby-ldap/ruby-net-ldap]

* {[email protected]}[http://groups.google.com/group/ruby-ldap]

== Synopsis

See {Net::LDAP on rubydoc.info}[https://www.rubydoc.info/github/ruby-ldap/ruby-net-ldap/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}[https://rubygems.org/gems/resolv-srv]: Support RFC2782 SRV record lookup and failover

== Develop

This task will run the test suite and the

{RuboCop}[https://github.com/bbatsov/rubocop] static code analyzer.

  rake rubotest

CI takes too long? If your local box supports

{Docker}[https://www.docker.com/], you can also run integration tests locally.

Simply run:

  script/ldap-docker

  INTEGRATION=openldap rake test

  

Or, use {Docker Compose}[https://docs.docker.com/compose/]. See docker-compose.yml for available Ruby versions.

    docker-compose run ci-2.7

CAVEAT: you need to add the following line to /etc/hosts

    127.0.0.1 ldap.example.org

    127.0.0.1 cert.mismatch.example.org

== 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}[http://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