Project

ldap_tools

0.0
No release in over 3 years
Low commit activity in last 3 years
A set of tools to make managing LDAP users, groups, and keys easier
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 1.0
>= 0.14
= 0.11
~> 3.0
 Project Readme

Gem Version Codacy Badge Gem Build Status

Table of Contents generated with DocToc

  • LDAP Tools
    • Requirements
    • Installation
      • Installation from rubygems
      • Installation from source
    • Configuration
      • ldap_info.yaml
      • ldap.secret
    • Commands
      • ldaptools
        • Currently supported subcommands

LDAP Tools

This LDAP tools gem is designed as a wrapper around Net/LDAP to make interacting with LDAP easier. No knowledge of LDIF required.

Requirements

  • Ruby 2.3
  • Optimist gem
  • Net/LDAP gem

Installation

Installation from rubygems

gem install ldap_tools

Installation from source

git clone git@github.com:Tapjoy/ldap_tools.git
cd ldap_tools
gem build ldap_tools.gemspec
gem install ldap_tools*.gem --no-ri --no-rdoc
cd ..

Configuration

There are two files used by this application. The default location is $HOME/.ldap; however, this can be overridden using the $LDAP_CONFIG_DIR environment variable

ldap_info.yaml

This config file provides basic information about your LDAP server setup.

---
basedn: #LDAP Base DN
servers:
  - # LDAP master servers (one per line)
port: # LDAP port
rootdn: # LDAP root DN
service_ou: # Organization Unit (OU) for service accounts
email_domain: # Domain to be used for user email addresses

ldap.secret

This is a plaintext file with the LDAP root password.

Commands

ldaptools

This is the base command from which all other commands are launched

Usage: ldaptools  [SUB_COMMAND] [options]

Tool to manage LDAP resources.
Available subcommands are: ["user", "group", "key", "audit"]

Options:
  -h, --help    Show this message

Help is available for all subcommands in a similar fashion.

Currently supported subcommands

  • user create
  • user delete
  • group create
  • group delete
  • group add_user
  • group remove_user
  • key add
  • key remove
  • key install
  • audit by_user
  • audit by_group
  • audit raw