ceeedevops / shared-mailbox-toolkit

Create and manage shared mailboxes. Share department and team mailboxes with individual users. (Family mailbox)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Zimbra Shared Mailbox Toolkit

Do you have generic mailboxes for you sales department, helpdesk or info@yourcompany.com, use Zimbra Shared Mailbox Toolkit to share those mailboxes with your staff. For long time Zimbra users: this toolkit is meant to bring back family mailboxes to Zimbra 8+.

By default shares are created with SendAs rights and read/write access (rwixd). This allows the user to email on behalf of the shared account and sent mail will be go to the shared account sent folder. An outgoing mail filter and persona is set to achieve this.

Supported Zimbra versions: 8.8.15, 9.0, 10.0

Bugs and feedback: https://github.com/Zimbra-Community/shared-mailbox-toolkit/issues

Known issues

If you are using multiple email domains (example.com, example.nl), and the shared account is not in the same domain as the users account, there will be spf/dkim misalignment. See: Zimbra-Community#42

========================================================================

Install prerequisites

  • No special requirements

Installing

Use the automated installer:

wget https://raw.githubusercontent.com/Zimbra-Community/shared-mailbox-toolkit/master/shared-mailbox-toolkit-installer.sh -O /tmp/shared-mailbox-toolkit-installer.sh
chmod +rx /tmp/shared-mailbox-toolkit-installer.sh
/tmp/shared-mailbox-toolkit-installer.sh

========================================================================

Screenshot of Admin Zimlet and extension

No need to have CLI access to create/revoke root shares. alt tag

Screenshot of Client Zimlet

The client Zimlet will automatically expand the shared mailbox, so the Inbox is displayed instead of No results found. alt tag The client Zimlet will not show duplicated options when selecting FROM address. alt tag

Screenshot of additional header

Optionally an additional header is added to the email to identify the user sending email from a shared mailbox. For example it can help finding out what sales person was sending out mail from sales@myzimbra.com. The header can be set via the installer or running su - zimbra -c "zmprov mcf zimbraSmtpSendAddAuthenticatedUser TRUE" and u - zimbra -c "zmmtactl restart". alt tag

Screenshot of the installer

alt tag

CLI Commands

Installed in /usr/local/sbin an can be run as user zimbra:

  • subzim: Share an entire mailbox with another mailbox (root share).
  • unsubzim: Revoke share created by subzim command (revoke root share).
  • personagen: Generate personas/identities for all aliasses of an account.
  • removeshares: Revoke all shares from an account. One can use this for managing people going into a different department, or in case the web UI fails to load due to sharing bugs.
  • submachinegun: Use this in case you are missing folders in your shared account. Read in-script comments for more details.

Enable the Admin Zimlet for delegated admins

zmprov ma testadmin@example.com +zimbraAdminConsoleUIComponents zimbraClientUploadView
zmprov grr global usr testadmin@example.com adminConsoleClientUploadRights
zmprov fc all

Uninstallation

To uninstall the zimlet just remove these folders:

rm -Rf /opt/zimbra/zimlets-deployed/_dev/tk_barrydegraaff_sharetoolkit_client
rm -Rf /opt/zimbra/lib/ext/ShareToolkit
su - zimbra -c "zmzimletctl undeploy tk_barrydegraaff_sharetoolkit_admin"
su - zimbra -c "zmmailboxdctl restart"

License

Copyright (C) 2015-2023 Barry de Graaff Zeta Alliance and the _addSendAsOrSendOboAddresses patch by Michele Olivo ZeXtras

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

About

Create and manage shared mailboxes. Share department and team mailboxes with individual users. (Family mailbox)

License:GNU General Public License v2.0


Languages

Language:JavaScript 41.0%Language:Shell 34.5%Language:Java 24.5%