Horde 5 Applikation IMAP Sieve-Filterregeln: Ingo unter CentOS 7.x

Als nächste Applikation installieren wir uns die Anwendung Ingo, mit deren Hilfe können wir dann die am IMAP-Server hinterlegten Sieve-Regeln anlegen, bearbeiten und auch löschen. Informationen zu Installation und Konfiguration findet man auch auf der offiziellen Doku-Seite.

Die Installation der Applikation Ingo können wir ganz einfach über das Paketverwaltungswerkzeug yum vornehmen.

 # yum install php-horde-ingo -y

Was uns das Paket php-horde-ingo alles mitgebracht hat zeigt uns der folgende Aufruf.

 # rpm -qil php-horde-ingo

Name        : php-horde-ingo
Version     : 3.2.0
Release     : 1.el7
Architecture: noarch
Install Date: Fri 12 Sep 2014 01:50:08 PM CEST
Group       : Development/Libraries
Size        : 1409432
License     : BSD
Signature   : RSA/SHA256, Fri 25 Jul 2014 11:50:01 PM CEST, Key ID 6a2faea2352c64e5
Source RPM  : php-horde-ingo-3.2.0-1.el7.src.rpm
Build Date  : Wed 23 Jul 2014 05:17:41 PM CEST
Build Host  : buildppc-01.phx2.fedoraproject.org
Relocations : (not relocatable)
Packager    : Fedora Project
Vendor      : Fedora Project
URL         : http://www.horde.org/apps/ingo
Summary     : An email filter rules manager
Description :
Ingo is an email-filter management application. It is fully
internationalized, integrated with Horde and the IMP Webmail client, and
supports both server-side (Sieve, Procmail, Maildrop) and client-side
(IMAP) message filtering.
/etc/horde/ingo
/etc/horde/ingo/backends.php
/etc/horde/ingo/conf.xml
/etc/horde/ingo/fields.php
/etc/horde/ingo/hooks.php.dist
/etc/horde/ingo/prefs.php
/etc/httpd/conf.d/php-horde-ingo.conf
/usr/bin/ingo-admin-upgrade
/usr/bin/ingo-convert-prefs-to-sql
/usr/bin/ingo-convert-sql-shares-to-sqlng
/usr/bin/ingo-postfix-policyd
/usr/share/doc/pear/ingo
/usr/share/doc/pear/ingo/CHANGES
/usr/share/doc/pear/ingo/CREDITS
/usr/share/doc/pear/ingo/INSTALL
/usr/share/doc/pear/ingo/LICENSE
/usr/share/doc/pear/ingo/README
/usr/share/doc/pear/ingo/RELEASE_NOTES
/usr/share/doc/pear/ingo/TODO
/usr/share/doc/pear/ingo/UPGRADING
/usr/share/horde/ingo
/usr/share/horde/ingo/basic.php
/usr/share/horde/ingo/config
/usr/share/horde/ingo/index.php
/usr/share/horde/ingo/js
/usr/share/horde/ingo/js/blacklist.js
/usr/share/horde/ingo/js/filters.js
/usr/share/horde/ingo/js/new_folder.js
/usr/share/horde/ingo/js/rule.js
/usr/share/horde/ingo/js/smartmobile.js
/usr/share/horde/ingo/js/whitelist.js
/usr/share/horde/ingo/lib
/usr/share/horde/ingo/lib/Ajax
/usr/share/horde/ingo/lib/Ajax/Application
/usr/share/horde/ingo/lib/Ajax/Application.php
/usr/share/horde/ingo/lib/Ajax/Application/Filters.php
/usr/share/horde/ingo/lib/Ajax/Application/Smartmobile.php
/usr/share/horde/ingo/lib/Api.php
/usr/share/horde/ingo/lib/Application.php
/usr/share/horde/ingo/lib/Basic
/usr/share/horde/ingo/lib/Basic/Base.php
/usr/share/horde/ingo/lib/Basic/Blacklist.php
/usr/share/horde/ingo/lib/Basic/Filters.php
/usr/share/horde/ingo/lib/Basic/Forward.php
/usr/share/horde/ingo/lib/Basic/Rule.php
/usr/share/horde/ingo/lib/Basic/Script.php
/usr/share/horde/ingo/lib/Basic/Spam.php
/usr/share/horde/ingo/lib/Basic/Vacation.php
/usr/share/horde/ingo/lib/Basic/Whitelist.php
/usr/share/horde/ingo/lib/Block
/usr/share/horde/ingo/lib/Block/Overview.php
/usr/share/horde/ingo/lib/Exception
/usr/share/horde/ingo/lib/Exception.php
/usr/share/horde/ingo/lib/Exception/Pear.php
/usr/share/horde/ingo/lib/Factory
/usr/share/horde/ingo/lib/Factory/Script.php
/usr/share/horde/ingo/lib/Factory/Shares.php
/usr/share/horde/ingo/lib/Factory/Storage.php
/usr/share/horde/ingo/lib/Factory/Transport.php
/usr/share/horde/ingo/lib/Flist.php
/usr/share/horde/ingo/lib/Form
/usr/share/horde/ingo/lib/Form/Base.php
/usr/share/horde/ingo/lib/Form/Forward.php
/usr/share/horde/ingo/lib/Form/Spam.php
/usr/share/horde/ingo/lib/Form/Type
/usr/share/horde/ingo/lib/Form/Type/Longemail.php
/usr/share/horde/ingo/lib/Form/Vacation.php
/usr/share/horde/ingo/lib/Ingo.php
/usr/share/horde/ingo/lib/LoginTasks
/usr/share/horde/ingo/lib/LoginTasks/SystemTask
/usr/share/horde/ingo/lib/LoginTasks/SystemTask/Upgrade.php
/usr/share/horde/ingo/lib/Perms.php
/usr/share/horde/ingo/lib/Script
/usr/share/horde/ingo/lib/Script/Base.php
/usr/share/horde/ingo/lib/Script/Customsql.php
/usr/share/horde/ingo/lib/Script/Imap
/usr/share/horde/ingo/lib/Script/Imap.php
/usr/share/horde/ingo/lib/Script/Imap/Api.php
/usr/share/horde/ingo/lib/Script/Imap/Live.php
/usr/share/horde/ingo/lib/Script/Imap/Mock.php
/usr/share/horde/ingo/lib/Script/Ispconfig
/usr/share/horde/ingo/lib/Script/Ispconfig.php
/usr/share/horde/ingo/lib/Script/Ispconfig/Vacation.php
/usr/share/horde/ingo/lib/Script/Item.php
/usr/share/horde/ingo/lib/Script/Maildrop
/usr/share/horde/ingo/lib/Script/Maildrop.php
/usr/share/horde/ingo/lib/Script/Maildrop/Comment.php
/usr/share/horde/ingo/lib/Script/Maildrop/Recipe.php
/usr/share/horde/ingo/lib/Script/Maildrop/Variable.php
/usr/share/horde/ingo/lib/Script/Procmail
/usr/share/horde/ingo/lib/Script/Procmail.php
/usr/share/horde/ingo/lib/Script/Procmail/Comment.php
/usr/share/horde/ingo/lib/Script/Procmail/Default.php
/usr/share/horde/ingo/lib/Script/Procmail/Recipe.php
/usr/share/horde/ingo/lib/Script/Procmail/Variable.php
/usr/share/horde/ingo/lib/Script/Sieve
/usr/share/horde/ingo/lib/Script/Sieve.php
/usr/share/horde/ingo/lib/Script/Sieve/Action
/usr/share/horde/ingo/lib/Script/Sieve/Action.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Addflag.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Discard.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Fileinto.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Flag.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Keep.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Notify.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Redirect.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Reject.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Removeflag.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Stop.php
/usr/share/horde/ingo/lib/Script/Sieve/Action/Vacation.php
/usr/share/horde/ingo/lib/Script/Sieve/Comment.php
/usr/share/horde/ingo/lib/Script/Sieve/Else.php
/usr/share/horde/ingo/lib/Script/Sieve/Elsif.php
/usr/share/horde/ingo/lib/Script/Sieve/If.php
/usr/share/horde/ingo/lib/Script/Sieve/Require.php
/usr/share/horde/ingo/lib/Script/Sieve/Test
/usr/share/horde/ingo/lib/Script/Sieve/Test.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Address.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Allof.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Anyof.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Body.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Exists.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/False.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Header.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Not.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Relational.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/Size.php
/usr/share/horde/ingo/lib/Script/Sieve/Test/True.php
/usr/share/horde/ingo/lib/Script/String.php
/usr/share/horde/ingo/lib/Script/Util.php
/usr/share/horde/ingo/lib/Session.php
/usr/share/horde/ingo/lib/Smartmobile.php
/usr/share/horde/ingo/lib/Storage
/usr/share/horde/ingo/lib/Storage.php
/usr/share/horde/ingo/lib/Storage/Blacklist.php
/usr/share/horde/ingo/lib/Storage/Filters
/usr/share/horde/ingo/lib/Storage/Filters.php
/usr/share/horde/ingo/lib/Storage/Filters/Sql.php
/usr/share/horde/ingo/lib/Storage/Forward.php
/usr/share/horde/ingo/lib/Storage/Mock.php
/usr/share/horde/ingo/lib/Storage/Prefs.php
/usr/share/horde/ingo/lib/Storage/Rule.php
/usr/share/horde/ingo/lib/Storage/Spam.php
/usr/share/horde/ingo/lib/Storage/Sql.php
/usr/share/horde/ingo/lib/Storage/Vacation.php
/usr/share/horde/ingo/lib/Storage/VacationTest.php
/usr/share/horde/ingo/lib/Storage/Whitelist.php
/usr/share/horde/ingo/lib/Test.php
/usr/share/horde/ingo/lib/Transport
/usr/share/horde/ingo/lib/Transport/Base.php
/usr/share/horde/ingo/lib/Transport/Ispconfig.php
/usr/share/horde/ingo/lib/Transport/Ldap.php
/usr/share/horde/ingo/lib/Transport/Null.php
/usr/share/horde/ingo/lib/Transport/Sivtest.php
/usr/share/horde/ingo/lib/Transport/Sql.php
/usr/share/horde/ingo/lib/Transport/Timsieved.php
/usr/share/horde/ingo/lib/Transport/Vfs.php
/usr/share/horde/ingo/lib/Ui
/usr/share/horde/ingo/lib/Ui/VarRenderer
/usr/share/horde/ingo/lib/Ui/VarRenderer/Ingo.php
/usr/share/horde/ingo/locale
/usr/share/horde/ingo/locale/ca
/usr/share/horde/ingo/locale/ca/LC_MESSAGES
/usr/share/horde/ingo/locale/ca/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/ca/help.xml
/usr/share/horde/ingo/locale/cs
/usr/share/horde/ingo/locale/cs/LC_MESSAGES
/usr/share/horde/ingo/locale/cs/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/da
/usr/share/horde/ingo/locale/da/LC_MESSAGES
/usr/share/horde/ingo/locale/da/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/de
/usr/share/horde/ingo/locale/de/LC_MESSAGES
/usr/share/horde/ingo/locale/de/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/de/help.xml
/usr/share/horde/ingo/locale/el
/usr/share/horde/ingo/locale/el/LC_MESSAGES
/usr/share/horde/ingo/locale/el/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/en
/usr/share/horde/ingo/locale/en/help.xml
/usr/share/horde/ingo/locale/es
/usr/share/horde/ingo/locale/es/LC_MESSAGES
/usr/share/horde/ingo/locale/es/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/es/help.xml
/usr/share/horde/ingo/locale/et
/usr/share/horde/ingo/locale/et/LC_MESSAGES
/usr/share/horde/ingo/locale/et/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/eu
/usr/share/horde/ingo/locale/eu/LC_MESSAGES
/usr/share/horde/ingo/locale/eu/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/eu/help.xml
/usr/share/horde/ingo/locale/fi
/usr/share/horde/ingo/locale/fi/LC_MESSAGES
/usr/share/horde/ingo/locale/fi/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/fi/help.xml
/usr/share/horde/ingo/locale/fr
/usr/share/horde/ingo/locale/fr/LC_MESSAGES
/usr/share/horde/ingo/locale/fr/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/fr/help.xml
/usr/share/horde/ingo/locale/hr
/usr/share/horde/ingo/locale/hr/LC_MESSAGES
/usr/share/horde/ingo/locale/hr/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/hr/help.xml
/usr/share/horde/ingo/locale/hu
/usr/share/horde/ingo/locale/hu/LC_MESSAGES
/usr/share/horde/ingo/locale/hu/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/it
/usr/share/horde/ingo/locale/it/LC_MESSAGES
/usr/share/horde/ingo/locale/it/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/ja
/usr/share/horde/ingo/locale/ja/LC_MESSAGES
/usr/share/horde/ingo/locale/ja/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/ko
/usr/share/horde/ingo/locale/ko/LC_MESSAGES
/usr/share/horde/ingo/locale/ko/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/lt
/usr/share/horde/ingo/locale/lt/LC_MESSAGES
/usr/share/horde/ingo/locale/lt/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/lv
/usr/share/horde/ingo/locale/lv/LC_MESSAGES
/usr/share/horde/ingo/locale/lv/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/lv/help.xml
/usr/share/horde/ingo/locale/nb
/usr/share/horde/ingo/locale/nb/LC_MESSAGES
/usr/share/horde/ingo/locale/nb/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/nl
/usr/share/horde/ingo/locale/nl/LC_MESSAGES
/usr/share/horde/ingo/locale/nl/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/pl
/usr/share/horde/ingo/locale/pl/LC_MESSAGES
/usr/share/horde/ingo/locale/pl/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/pt
/usr/share/horde/ingo/locale/pt/LC_MESSAGES
/usr/share/horde/ingo/locale/pt/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/pt_BR
/usr/share/horde/ingo/locale/pt_BR/LC_MESSAGES
/usr/share/horde/ingo/locale/pt_BR/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/ro
/usr/share/horde/ingo/locale/ro/LC_MESSAGES
/usr/share/horde/ingo/locale/ro/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/ru
/usr/share/horde/ingo/locale/ru/LC_MESSAGES
/usr/share/horde/ingo/locale/ru/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/sk
/usr/share/horde/ingo/locale/sk/LC_MESSAGES
/usr/share/horde/ingo/locale/sk/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/sl
/usr/share/horde/ingo/locale/sl/LC_MESSAGES
/usr/share/horde/ingo/locale/sl/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/sv
/usr/share/horde/ingo/locale/sv/LC_MESSAGES
/usr/share/horde/ingo/locale/sv/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/tr
/usr/share/horde/ingo/locale/tr/LC_MESSAGES
/usr/share/horde/ingo/locale/tr/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/uk
/usr/share/horde/ingo/locale/uk/LC_MESSAGES
/usr/share/horde/ingo/locale/uk/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/zh_CN
/usr/share/horde/ingo/locale/zh_CN/LC_MESSAGES
/usr/share/horde/ingo/locale/zh_CN/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/locale/zh_TW
/usr/share/horde/ingo/locale/zh_TW/LC_MESSAGES
/usr/share/horde/ingo/locale/zh_TW/LC_MESSAGES/ingo.mo
/usr/share/horde/ingo/migration
/usr/share/horde/ingo/migration/1_ingo_base_tables.php
/usr/share/horde/ingo/migration/2_ingo_upgrade_autoincrement.php
/usr/share/horde/ingo/migration/3_ingo_upgrade_sqlng.php
/usr/share/horde/ingo/migration/4_ingo_upgrade_sqlhierarchical.php
/usr/share/horde/ingo/migration/5_ingo_upgrade_sqlnghierarchical.php
/usr/share/horde/ingo/migration/6_ingo_upgrade_parents.php
/usr/share/horde/ingo/smartmobile.php
/usr/share/horde/ingo/templates
/usr/share/horde/ingo/templates/basic
/usr/share/horde/ingo/templates/basic/blacklist
/usr/share/horde/ingo/templates/basic/blacklist/blacklist.html.php
/usr/share/horde/ingo/templates/basic/filters
/usr/share/horde/ingo/templates/basic/filters/filters.html.php
/usr/share/horde/ingo/templates/basic/menu
/usr/share/horde/ingo/templates/basic/menu/menu.html.php
/usr/share/horde/ingo/templates/basic/rule
/usr/share/horde/ingo/templates/basic/rule/rule.html.php
/usr/share/horde/ingo/templates/basic/script
/usr/share/horde/ingo/templates/basic/script/_script.html.php
/usr/share/horde/ingo/templates/basic/script/script.html.php
/usr/share/horde/ingo/templates/basic/whitelist
/usr/share/horde/ingo/templates/basic/whitelist/whitelist.html.php
/usr/share/horde/ingo/templates/flist
/usr/share/horde/ingo/templates/flist/input.html.php
/usr/share/horde/ingo/templates/flist/select.html.php
/usr/share/horde/ingo/templates/smartmobile
/usr/share/horde/ingo/templates/smartmobile/rule.html.php
/usr/share/horde/ingo/templates/smartmobile/rules.html.php
/usr/share/horde/ingo/themes
/usr/share/horde/ingo/themes/default
/usr/share/horde/ingo/themes/default/block
/usr/share/horde/ingo/themes/default/block/screen.css
/usr/share/horde/ingo/themes/default/graphics
/usr/share/horde/ingo/themes/default/graphics/blacklist.png
/usr/share/horde/ingo/themes/default/graphics/copy.png
/usr/share/horde/ingo/themes/default/graphics/disable.png
/usr/share/horde/ingo/themes/default/graphics/enable.png
/usr/share/horde/ingo/themes/default/graphics/favicon.ico
/usr/share/horde/ingo/themes/default/graphics/forward.png
/usr/share/horde/ingo/themes/default/graphics/ingo.png
/usr/share/horde/ingo/themes/default/graphics/script.png
/usr/share/horde/ingo/themes/default/graphics/spam.png
/usr/share/horde/ingo/themes/default/graphics/vacation.png
/usr/share/horde/ingo/themes/default/graphics/whitelist.png
/usr/share/horde/ingo/themes/default/screen.css
/usr/share/horde/ingo/themes/default/smartmobile
/usr/share/horde/ingo/themes/default/smartmobile/screen.css
/usr/share/tests/pear/ingo
/usr/share/tests/pear/ingo/Ingo
/usr/share/tests/pear/ingo/Ingo/AllTests.php
/usr/share/tests/pear/ingo/Ingo/Autoload.php
/usr/share/tests/pear/ingo/Ingo/Unit
/usr/share/tests/pear/ingo/Ingo/Unit/MaildropTest.php
/usr/share/tests/pear/ingo/Ingo/Unit/ProcmailTest.php
/usr/share/tests/pear/ingo/Ingo/Unit/ScriptTest.php
/usr/share/tests/pear/ingo/Ingo/Unit/SieveTest.php
/usr/share/tests/pear/ingo/Ingo/Unit/TestBase.php
/usr/share/tests/pear/ingo/Ingo/bootstrap.php
/usr/share/tests/pear/ingo/Ingo/fixtures
/usr/share/tests/pear/ingo/Ingo/fixtures/from_spammer
/usr/share/tests/pear/ingo/Ingo/fixtures/not_from_spammer
/usr/share/tests/pear/ingo/Ingo/phpunit.xml
/var/lib/pear/pkgxml/php-horde-ingo.xml

Neben der Konfiguration der Anwendung selbst, müssen wir der Anwendung Ingo auch noch mitteilen, wie es sich zum MDA¹⁾ also unserem IMAP-Server verbinden soll.

Die mitgelieferte Konfigurationsdatei backends.php lassen wir unangetastet. Die Konfiguration nehmen wir über die lokale Kopie backends.local.php vor.

 # cp -a /usr/share/horde/ingo/config/backends.php /usr/share/horde/ingo/config/backends.local.php

Als erstes deaktivieren wir den ersten Standardeintrag und ergänzen dann den Eintrag für die Anbindung an unseren Dovecot-IMAP-Server.

 # vim /usr/share/horde/ingo/config/backends.local.php

/usr/share/horde/ingo/config/backends.local.php

<?php
/**
 * Ingo works purely on a preferred mechanism for server selection. There are
 * a number of properties that you can set for each backend:
 *
 * IMPORTANT: DO NOT EDIT THIS FILE!
 * Local overrides MUST be placed in backends.local.php or backends.d/.
 * If the 'vhosts' setting has been enabled in Horde's configuration, you can
 * use backends-servername.php.
 *
 * Example configuration file that enables the Sieve backend in favor of the
 * IMAP backend:
 *
 * <?php
 * $backends['imap']['disabled'] = true;
 * $backends['sieve']['disabled'] = false;
 *
 * Example configuration to use a Dovecot Managesieve backend on a different
 * host:
 *
 * <?php
 * $backends['imap']['disabled'] = true;
 * $backends['sieve']['disabled'] = false;
 * $backends['sieve']['transport'][Ingo::RULE_ALL]['params']['hostspec'] = 'sieve.example.com';
 * $backends['sieve']['script'][Ingo::RULE_ALL]['params']['utf8'] = true;
 *
 * Properties that can be set for each server:
 *
 * disabled: (boolean) If true, the config entry is disabled.
 *
 * preferred: (string) This is the field that is used to choose which server
 *            is used. The value for this field may be a single string or an
 *            array of strings containing the hostnames to use with this
 *            server.
 *
 * script: (array) The type of script drivers this server uses. Different
 *         drivers can be specified for different filter rules. The following
 *         rules can be set as keys: Ingo::RULE_FILTER, Ingo::RULE_BLACKLIST,
 *         Ingo::RULE_WHITELIST, Ingo::RULE_VACATION, Ingo::RULE_FORWARD,
 *         Ingo::RULE_SPAM, and finally Ingo::RULE_ALL as a catch-all key for
 *         any rules not further specified.
 *         'params' is an array containing any additional information that the
 *         script driver needs. See examples below for further details.
 *         Valid options for 'driver' are:
 *   - customsql: Custom SQL queries (only for vacation notices).
 *   - imap:      IMAP client side filtering (POP3 servers NOT supported).
 *   - ispconfig: ISPConfig SOAP Server (only for vacation notices).
 *   - maildrop:  Maildrop scripts.
 *   - procmail:  Procmail scripts.
 *   - sieve:     Sieve scripts.
 *
 * shares: (boolean) Some transport drivers (timsieved, vfs, ispconfig) support
 *         sharing filter rules with other users. Users can then configure
 *         filters for each other if they give them permissions to do so. If
 *         you want to enable this feature, you need to set this parameter to
 *         true. Transport backend authentication needs to be configured, so
 *         that it allows to upload other users' rules, e.g. by granting FTP
 *         access to .procmail files, or using an administrative user for
 *         Sieve.
 *
 * transport: (array) The transport drivers to use to store the scripts on the
 *            backend server. Different drivers can be specified for different
 *            filter rules. The following rules can be set as keys:
 *            Ingo::RULE_FILTER, Ingo::RULE_BLACKLIST, Ingo::RULE_WHITELIST,
 *            Ingo::RULE_VACATION, Ingo::RULE_FORWARD, Ingo::RULE_SPAM, and
 *            finally Ingo::RULE_ALL as a catch-all key for any rules not
 *            further specified.
 *            'params' is an array containing any additional information that
 *            the transport class needs. See examples below for further details.
 *            Valid options for 'driver' are:
 *   - ispconfig: ISPConfig SOAP server (only for vacation notices).
 *   - ldap:      LDAP server.
 *   - null:      No backend server (i.e. for script drivers, such as 'imap',
 *                that does not use scripts).
 *   - sql:       Database server (only for vacation notices).
 *   - timsieved: Timsieved (managesieve) server.
 *   - vfs:       Use Horde VFS.
 *
 *   NOTE: By default, the transport driver will use Horde credentials to
 *         authenticate to the backend. If a different username/password is
 *         needed, use the 'transport_auth' hook (see hooks.php) to define
 *         these values.
 */
 
/* IMAP Example */
// ENABLED by default
// Django : 2014-09-12
// default: 'disabled' => false,
$backends['imap']['disabled'] = true;
 
/* Sieve Example */
// Disabled by default
// Django : 2014-09-12
// default: 'disabled' => true,
$backends['sieve']['disabled'] = false;
$backends['sieve']['transport'][Ingo::RULE_ALL]['driver'] = 'timsieved';
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['hostspec'] = '10.0.0.77';
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['logintype'] = 'CRAM-MD5';
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['usetls'] = true;
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['port'] = 4190;
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['scriptname'] = 'ingo';
$backends['sieve']['transport'][Ingo::RULE_ALL]['params']['debug'] = false;#
$backends['sieve']['script'][Ingo::RULE_ALL]['driver'] = 'sieve';
$backends['sieve']['script'][Ingo::RULE_ALL]['params']['utf8'] = true;
$backends['sieve']['shares'] = false;

Da die Authentifizierung mit Username = eMail-Adresse und Passwort gegen die mySQL-Datenbank erfolgt, müssen wir dien Umstand noch über die Datei hooks.php unserer Installation mitgeben.

Die mitgelieferte Konfigurationsdatei hooks.php lassen wir unangetastet. Die Konfiguration nehmen wir über die lokale Kopie hooks.local.php vor.

 cp -a /usr/share/horde/ingo/config/hooks.php.dist /usr/share/horde/ingo/config/hooks.local.php

 # vim /usr/share/horde/ingo/config/hooks.local.php

/usr/share/horde/ingo/config/hooks.local.php

<?php
/**
 * Ingo Hooks configuration file.
 *
 * THE HOOKS PROVIDED IN THIS FILE ARE EXAMPLES ONLY.  DO NOT ENABLE THEM
 * BLINDLY IF YOU DO NOT KNOW WHAT YOU ARE DOING.  YOU HAVE TO CUSTOMIZE THEM
 * TO MATCH YOUR SPECIFIC NEEDS AND SYSTEM ENVIRONMENT.
 *
 * For more information please see the horde/config/hooks.php.dist file.
 *
 * $Id: fdf1f95f36a8b0c339f61ac27badcdce094a0388 $
 */
 
class Ingo_Hooks
{
    /**
     * Returns the username/password needed to connect to the transport
     * backend.
     *
     * @param string $driver  The driver name (array key from backends.php).
     *
     * @return mixed  If non-array, uses Horde authentication credentials
                      (DEFAULT). Otherwise, an array with the following keys
     *                (non-existent keys will use default values):
     *  - euser: (string; SIEVE ONLY) For the sieve driver, the effective
     *           user to use.
     *  - password: (string) Password.
     *  - username: (string) User name.
     */
    // Django : 2014-09-12
    // default: //    public function transport_auth($driver)
    //          //    {
    //          //        switch ($driver) {
    //          //        case 'foo':
    public function transport_auth($driver)
    {
        switch ($driver) {
        case 'timsieved':
//    public function transport_auth($driver)
//    {
//        switch ($driver) {
//        case 'foo':
//            // Example #1: Use full Horde username for password.
//            return array(
//                'username' => $GLOBALS['registry']->getAuth(null)
//            );
//
            // Django : 2014-09-12
            // default: //            // Example #2: Use IMP password/username.
            //          //            $ob = $GLOBALS['registry']->call('mail/imapOb');
            //          //            return array(
            //          //                'password' => $ob->getParam('password'),
            //          //                'username' => $ob->getParam('username')
            //          //            );
            //          //        }
            // Example #2: Use IMP password/username.
            $ob = $GLOBALS['registry']->call('mail/imapOb');
            return array(
                'password' => $ob->getParam('password'),
                'username' => $ob->getParam('username')
            );
        }
//
//        // DEFAULT: Use hordeauth (identical to not defining hook at all).
//        return true;
// Django : 2014-09-12
// default: //    }
    }
 
 
    /**
     * Set the default addresses used for the vacation module.
     *
     * @param string $user  The username.
     * @param array $value  The default/current value.
     *
     * @return array  A list of vacation addresses.
     */
//    public function vacation_addresses($user = null, $value = null)
//    {
//        // Example #1: User has 2 vacation addresses.
//        return array($user . '@example.com', $user . '@foobar.com');
//
//        // Example #2: Keep user-supplied values, return defaults only
//        return is_array($value) && count($array)
//            ? $value
//            : array($user . '@example.com', $user . '@foobar.com');
//    }
 
}

Die Konfiguration der Applikation Ingo erfolgt dann über die GUI des Web-Frameworks. Dazu rufen wir unseren angelegten VHOST im Webbrowser auf.

 $ firefox https://horde.sec-mail.guru/admin/config/

Da wir die Anwendung Ingo noch nicht konfiguriert haben und auch die nötigen mySQL-Datenbanktabellen angelegt haben, sind die beiden Fehlermeldungen normal.

Als erstes legen wir die notwendigen Datenbanktabellen an. Hierzu klicken wir auf den Punkt Update all DB schemas.

Nun fehlt nur noch die Konfiguration vom Filters Ingo, diese legen wir nun an, in dem wir auf den Punkt Filters (ingo) klicken.

Hier erfolgt nun die Konfiguration der Horde-Applikation Ingo.

Rules Storage

$conf[storage][driver]                                                         SQL
$conf[storage][params][driverconfig]                                           Horde defaults
$conf[storage][maxblacklist]                                                   0
$conf[storage][maxwhitelist]                                                   0

Rules Options

$conf[rules][userheader]                                                       [✔]

Spam Filtering

$conf[spam][compare]                                                           numeric
$conf[spam][header]                                                            X-Spam-Level

Am Ende unserer Konfigurationsarbeit, sichern wir die Konfiguration mit einem Klick auf die Schaltfläche: Bild: Schaltfläche "Generate Filters Configuration" Die erfolgreiche Sicherung wird uns entsprechend angezeigt.