Updated README with some documentation

This commit is contained in:
Gregory Ballantine 2018-08-27 18:11:01 -04:00
parent 5acdc024ae
commit 812297f5bf

View File

@ -1,3 +1,58 @@
# ldap-management # MULdap
A series of tools to manage Metaunix.net LDAP resources A tool to manage LDAP resources, built in Go
## About
MULdap (short for Metaunix LDAP) is a CLI tool built for easily managing an LDAP directory. The goal is to be very configurable to fit in different environments, while also still being rather secure (e.g. not requiring a plaintext file be world readable somewhere). MULdap has "user" and "group" resources, which give some structure to those LDAP resources, albeit slightly opinionated - there will be more resources added later as this tool grows! MULdap can also add and delete resources using LDIF files.
## Runtime Requirements
Currently this has only been tested to work on Linux systems.
## Use
The currently available commands are: `version`, `setup`, `search, `ldif`, `user`, `group`
### Version command
`muldap version`
Displays the current version of this application.
### Setup command
`muldap setup`
Sets up your user environment with some default configuration to start using this tool.
### Search command
`muldap search -f objectClass=top`
Searches your LDAP directory. You can supply a filter using the `-f` flag.
## Build
### Requirements
You will need `Dep` and Go 1.7 installed and in your PATH.
### Build Binary
`cd` to the source directory, then install dependencies:
`dep ensure`
Build using Go:
`go build`
## Contributing
Feel free to fork/clone/whatever this repo and make changes!
## License
This program is distributed under the BSD 2-Clause License.