Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.04 KB

README.md

File metadata and controls

49 lines (33 loc) · 1.04 KB

ad_dir ActiveDirectory

Description

ad_dir provides a easy interface to ActiveDirectory based on the net-ldap gem.

Features

ad_dir allows to query and manage entries of the AD directory. Currently, it provides only a {AdDir::User} and a {AdDir::Group} model based on the base class {AdDir::Entry}.

{AdDir::Entry} is kind of a proxy that wraps most of the instance methods of Net::LDAP::Entry while most of the class methods deal with connecting to the ActiveDirectory, as well as searching and retrieving entries.

The library tries to provide the same functionalities as given by ActiveRecord.

Examples

  require 'ad_dir'
  AdDir.establish_connection(
    host: 'my.nice.com',
    base: 'dc=my,dc=nice,dc=com',
    username: 'cn=manager,dc=example,dc=com',
    password: 'opensesame'
  )
  
  jdoe = AdDir::User.find('jdoe')
  jdoe.groups
  # => [<#AdDir::Group... ]
  jdoe.add_group(AdDir::Group.find('admin'))

Requirements

  • 'net-ldap' >= '0.16'

Install

$ gem install ad_dir