Updated README with some documentation
This commit is contained in:
parent
5acdc024ae
commit
812297f5bf
59
README.md
59
README.md
@ -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.
|
||||||
|
Loading…
Reference in New Issue
Block a user