Util for interact with various catalogs systems.
Avalible catalogs types:
- Active Directory (AD)
You can download releases here.
Example deploy script - get_darwin_release.sh for darwin install v0.0.1:
./scripts/get_darwin_release.sh v0.0.1To configure your bash shell to load completions for each session add to your ~/.bashrc or ~/.profile:
. <(cataloger completion)Full help avalible on -h or --help flags:
cataloger -hLogin command, creates cataloger config and try to connect to catalog:
cataloger loginOr you can pass all flags to escape interactive asking:
cataloger login \
--host ad.server.local \
--port 636 \
--ssl --insecure \
--bind "CN=noname,OU=unit,DC=company,DC=com" \
--password "fake" \
--search-base "OU=people,DC=company,DC=com"After that command cataloger creates config file in $HOME/.cataloger.json:
{
"host": "ad.server.local",
"port": 636,
"ssl": true,
"insecure": true,
"bind": "CN=noname,OU=unit,DC=company,DC=com",
"password": "fake",
"search-base": "OU=people,DC=company,DC=com",
}You can provide custom config file via -c flag:
cataloger -c ~/custom_conf.jsonSearch:
# Search for user entry by user sAMAccountName
cataloger search user dummyuser
# Search for user entry by user mail attribute
cataloger search user --attribute=mail [email protected]
# Search for user entry by user sAMAccountName and display user groups
cataloger search user dummyUser -g
# Search for group entry by sAMAccountName
cataloger search group dummyGroup
# Search for group entry by 'cn' attribute
cataloger search group --attribute=cn dummyGroup dummyGroup-CN
# Search for group entry by sAMAccountName and display group direct members
cataloger search group dummyGroup -m
# Search for group entry by sAMAccountName and display group all members (include all subgroups members)
cataloger search group dummyGroup -m --nestedModify:
# Add 'dummyUser' to 'dummyGroup' members
cataloger modify group members dummyGroup -a dummyUser
# Add 'dummyUser1' and 'dummyUser2' to 'dummyGroup' members
cataloger modify group members dummyGroup -a dummyUser1 -a dummyUser2
# Remove 'dummyUser' form 'dummyGroup' members
cataloger modify group members dummyGroup -d dummyUser
# Remove 'dummyUser1' and 'dummyUser2' form 'dummyGroup' members
cataloger modify group members dummyGroup -d dummyUser1 -d dummyUser2