Spamexperts

From Open-Xchange
Revision as of 11:58, 7 October 2014 by Choeger (talk | contribs)

Introduction

This package connects the SpamExperts system with Open-Xchange. It allows to access your SpamExperts settings from within Open-Xchange and use the spam- and ham learning mechanisms of SpamExperts directly from within the Open-Xchange UI.

Install on OX v6.22.x

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/6.22/backend/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/6.22/backend/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-spamhandler-spamexperts open-xchange-spamhandler-spamexperts-gui

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/6.22/backend/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/6.22/backend/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-spamhandler-spamexperts open-xchange-spamhandler-spamexperts-gui


Install on OX App Suite

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-spamhandler-spamexperts open-xchange-appsuite-spamexperts

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-spamhandler-spamexperts open-xchange-appsuite-spamexperts


Components

OX UI Plugin

The UI plugin extends the OX settings tree with a new subtree to access the "Antispam" management WEB UI of Spamexperts.com

OX Backend Plugin

The backend plugin consists of a servlet which can create an authentication ticket for the currently active OX user by using the Spamexperts.com API and then sends the ticket back to the UI plugin which will do the redirect to the external Spamexperts.com management WEB UI.

Configuration

You need to adapt the settings in /opt/open-xchange/etc/spamexperts.properties

Settings can be separated in two sections:

SpamExperts UI integration

Define your custom parameters in order to integrate your branded SpamExperts UI into Open-Xchange

SpamExperts SPAM/HAM learning integration

Note: This requires backend version 7.6.0 or newer.

Configure you personal parameters to access the SpamExperts IMAP server in order to use the SPAM/HAM learning mechanism.

In addition, you have to tell the Open-Xchange mail backend what spamhandler to use for SPAM/HAM learning. This must be done in the configuration file /opt/open-xchange/etc/imap.properties. You have to set

com.openexchange.imap.spamHandler=SpamExperts

exactly like this, or the SPAM/HAM learning mechanism will not work.

Provisioning

Note: This requires backend version 7.6.0 or newer.

In order to activate SPAM/HAM learning in OX Webmail, you have to turn that on for the users.


Using create- or changeuser, provide the option --gui_spam_filter_capabilities_enabled true In order to add the spamexperts link to OX Webmail, provide the option --capabilities-to-add com.spamexperts