nupplaphil / kopano-ldap

LDAP Command Line Interface for Kopano
GNU General Public License v3.0
1 stars 0 forks source link
cli docker-image golang kopano ldap-client

Build Status codecov Go Report Card

LDAP Command Line Interface for Kopano

This CLI is built for the User Management of Kopano. It is inspired by kopano-cli and is written in Go.

It should be used in combination with the general kopano-cli tool. kopano-ld starts, where kopano-cli stops with LDAP support.

General usage of kopano-ld tool

The kopano-ld is an administration tool for managing user and groups in LDAP. If you use an other backend than ldap for Kopano (f.e DB or unix), please look for the 8. User Management in Kopano.

The tool can be used to get more information about users and groups too.

Listing users

All available users or groups can be displayed by using the following commands:

> kopano-ld user --list
> kopano-ld group --list

Users

Displaying details

To display more information of a specific user, use:

> kopano-ld user john
Name:                     johndoe
Full name:                John Doe
Email address:            john@doe.com
Active:                   yes
Administrator:            no
Features Enabled:         mobile
Features Disabled:        imap; pop3

To display more information of a specific group, use:

TO BE DEFINED (TODO)

Creating users with LDAP

To create a new user, use the following command:

> kopano-ld user create --user <user name> \
                      --password <password> \
                      --email <email> \
                      --fullname <full name> \
                      --active <active> \
                      --admin-evel <administrator>

The fields between <> should be filled in as follows:

Updating user information with LDAP

The same kopano-ld tool can be used to update LDAP information. Use the following command to update:

TO BE DEFINED (TODO)

Deleting users with LDAP

To delete a user from LDAP, use the following command:

> kopano-ld user delete --user <user name>

The user will be deleted from LDAP. However the store will be kept in the database.

Groups

TO BE DEFINED (TODO)

Creating Groups with LDAP

TO BE DEFINED (TODO)

Deleting Groups with LDAP

TO BE DEFINED (TODO)

Kopano Feature management

Some features within KC can be disabled. By default, all features are disabled. Enabling can be done globally or on a per-user basis. When a feature has been globally disabled, you may enable the feature in a per-user basis too.

Currently the only features that can be controlled are imap, pop3 and mobile.

If the pop3 feature is disabled, users won’t be able to login using the POP3 protocol. The same goes for the imap feature, but this has an extra effect aswell. When a user receives email when the imap feature is enabled, the original email and some other imap optimized data will also be saved in the Kopano database and attachment directory. This will make the IMAP services provided by the kopano-gateway more reliable. On the other hand, it will also use more diskspace.

Disabling the imap feature will thus save diskspace.

Globally enabling features

see 8.7.1. Globally enabling features

Per-user en- or disabling features

Managing the feature per user in LDAP, the kopano-ld tool has to be used to control the features:

> kopano-ld user feature add --user john --add imap
> kopano-ld user feature rem --user john --rem mobile

In LDAP, the features will be managed from the two attributes kopanoEnabledFeatures and kopanoDisabledFeatures.