Zimbra Addon

The Spam Experts Zimbra addon, provides the following functionality:

  • Report a spam to our central reporting system
  • Automatically login to the Spam Experts Control Panel interface via a Zimbra tab

Supported

  • Version: 8.8.15

Configuration

  1. Download the addon files from here
  2. Unpack the Zip file to a temporary location locally
  3. Edit the config_template.xml file to the appropriate values
    • reportSpamUrl - this should remain unchanged
    • panelUrl - The API hostname (for Hosted Cloud users this should be https://api.antispamcloud.com)
    • panelAdmin - Your Spam Experts Admin username
    • panelPassword - Your Spam Experts Admin password
    • allowedDomains - This should contain BOTH your clusters hostname and *.spamrl.com (For Hosted Cloud users this should be *.antispamcloud.com,*.spamrl.com)
  4. If using the Custom Branding functionality, make these changes here.
  5. Save the config_template.xml file
  6. Remove the README.md file
  7. Pack the addon files back into a zip file called com_zimbra_spamexperts.zip.

Custom Branding

It's possible to re-brand our Zimbra addon. To re-brand the addon, this will need to be done in the Configurationsteps before saving and packing the files.

  1. Change the Addon Name:
    1. Replace the "ZimletName", "Label" in the com_zimbra_spamexperts.properties files.
  2. Change the Addon Icon:
    1. Replace "zimlet_icon.gif" with your own icon. This must be a GIF file and use dimensions 16px x 16px.

Installation

This can be installed via the command line or via the Admin Area web interface.

Installation via the command line

  1. Upload the recently packaged zip file com_zimbra_spamexperts.zip to the /opt/zimbra/zimlets/ directory of your server.
  2. Deploy the package by using the following command
  3. /opt/zimbra/bin/zmzimletctl deploy /opt/zimbra/zimlets/com_zimbra_spamexperts.zip

  4. Upon successful installation, you should see the following response:
  5. INFO: Deploying Zimlet com_zimbra_spamexperts in LDAP.
    INFO: Installing Zimlet com_zimbra_spamexperts on this host.
    INFO: Upgrading Zimlet com_zimbra_spamexperts to 1.0
    INFO: Installing Zimlet config for com_zimbra_spamexperts
    INFO: Adding Zimlet com_zimbra_spamexperts to COS default
    INFO: Enabling Zimlet com_zimbra_spamexperts

  6. Log in to the Zimbra Admin Area to see if the zimlet appears.
  7. Due to the Zimbra Cache it is possible that it will not appear immediately.

Installation via the Zimbra Admin Area

  1. Log in to your Zimbra as an administrator (using port 7071)
  2. On the left hand toolbar, go to Configure->Zimlets
  3. Click on the small settings cog in the upper right and select Deploy
  4. Upload the com_zimbra_spamexperts.zip file from the Configuration steps
  5. Tick Flush zimlet cache box to ensure you will see the zimlet immediately
  6. Click Deploy
  7. Wait for the deployment to complete then click Finish.

By default, the zimlet is available to all users. From Zimbra administration, you can set for each user if they should have access to this zimlet or not.

Resolving Issues

Debug logging

By default, Zimbra debug mode for zimlets is enabled and all the information can be found in /opt/zimbra/log/mailbox.log. If debug mode is disabled, it can be enabled for an admin user by executing the following command:

su - zimbra zmprov addAccountLogger $email zimbra.zimlet debug

Forbidden Proxy

If you are using multiple COS (Class of Service ) objects then you will likely need to add *.spamrl.com to these. This can be done via command line using:

for i in `zmprov gac`; do zmprov mc $i +zimbraProxyAllowedDomains *.spamrl.com; done

X-Frame Protection

If you are having issues with "not permit cross-origin framing", this would indicate that there is a strict setting in the "Protection against rendering IFrames" part of server settings which can be found by going to Server > Setting page > Protection against rendering in HTML Frames.

Here you a choose either No protection (not recommended) or Allow from URL and enter your Zimbra server hostname.

Hosted Cloud is set to No Protection by default, so Hosted Cloud customers should not have this issue.

Further support

Please contact support@spamexperts.com if you have any issues.