Hostsharing Wiki - Benutzerbeiträge [de]

Roundcube - Filter

2012-06-11T19:58:20Z

Dfr00-hs.wiki: Links

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm Deliver ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Die Vacation-Extension schickt Abwesenheitsmeldungen '''nur''' wenn die Mail an eine dem System für ''diesen'' Account bekannte Email-Adresse geschickt wurde. Im konkreten Fall bei der Erstellung über Roundcube müssen also für jede Email-Adresse Identitäten angelegt werden, also z.B. sowohl max.mustermann@example.org und maexchen@example.org. Diese müssen dann auch unter "Alias" explizit ausgewählt werden. Werden Emails an den Account mit einer anderen Empfänger-Adresse geschickt, erhalten diese '''keine''' Abwesenheitsmeldung. siehe auch [http://tools.ietf.org/html/rfc5230#section-4.5 RFC5230] Abschnitt 4.5
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]

==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

==== Links ====

Einige Sieve-relevante Links, sind im entsprechenden [https://wiki.hostsharing.net/index.php?title=Managesieve#Links Managesieve Wiki-Artikel] angegeben:
----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Managesieve

2012-06-11T19:56:28Z

Dfr00-hs.wiki: Links hinzugefügt

== Managesieve ==

Managesieve [http://wiki.dovecot.org/ManageSieve] ist ein Dienst-Programm zum Einrichten und Verwalten von Mailfiltern, die in der Filtersprache <tt>sieve</tt> geschrieben sind. <tt>Sieve</tt> ist als Dovecot-Plugin [http://wiki.dovecot.org/LDA/Sieve] verfügbar.

'''Für Nutzer, die nur einfache Filterregeln benötigen, wird empfohlen diese Filter über das grafische Oberfläsche im Webmailer [[Roundcube]] anzulegen und zu verwalten. Die Vorgehensweise ist ausführlich unter [[Roundcube - Filter]] beschrieben.'''

Diese Seite gibt einige technische Informationen und Einführung für Nutzer, die eigene Skripte in <tt>sieve</tt> schreiben wollen.

=== Filtermöglichkeiten ===

<tt>Sieve</tt> erlaubt Filter zu schreiben u.a. für folgende '''Filteraktionen''':
* Verschieben/Kopieren einer Nachricht in einen Ordner
* Erstellen von [[Roundcube - Filter#Abwesenheitsmeldung|Abwesenheitsmeldungen]]
* Markieren von Nachrichten (z.B. Gelesen, Weitergeleitet)
* Weiterleiten/Kopie senden an andere Email-Adressen
* Ablehnen von Nachrichten

Eine ausführliche Beschreibun der Filteraktivitäten ist zu finden auf der Dovecot-Seite [http://wiki.dovecot.org/LDA/Sieve#Features]

Hierbei sind '''keine''' Aufrufe von '''externen Programmen''' möglich. Dadurch können keine unerwünschten Seiteneffekte entstehen. Dies grenzt <tt>sieve</tt> beispielsweise von <tt>[[procmail]]</tt> ab.

Die '''Filterregeln''' lassen Checks zu z.B. von
* Test auf bestimmte Absender
* Vorhandensein von bestimmten Texten im Betreff oder dem Text der Nachricht
* Bestimmte Werte für andere Header der Nachricht, z.B. zur Identifizierung von Mailinglisten über List-Id.
Dabei können teilweise reguläre Ausdrücke benutzt werden oder Aggregatsfunktionen wie "Anzahl der Empfänger".

=== Einrichtung ===

Für die Einrichtung von <tt>deliver</tt> als Mailzustellungsprogramm ist keine weitere Konfiguration notwendig. Dies geschieht automatisch.

Hat ein Nutzer bisher procmail benutzt, kann die <tt>.forward</tt> gelöscht werden oder durch eine neue <tt>.forward</tt> ersetzt werden mit folgendem Inhalt:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

=== Sieve-Filter ===

Ein einfaches Sieve-Skript sieht wie folgt aus:

require "fileinto";
if header :contains "X-Spam-Flag" "YES" {
fileinto "Spam";
}

Dieses Skript prüft ob in der Nachricht der Header "X-Spam-Flag" existiert und den Wert "YES" enthält. In diesem Fall wird die Nachricht in den Ordner "Spam" abgespeichert.

Mehrere Filter werden hintereinander in eine Filterdatei gehängt. Die Filter können durch if-then-else-Konstrukte verbunden werden.

Weiter Beispiele sind zu finden z.B. unter [http://wiki.dovecot.org/LDA/Sieve#Example_scripts] oder [http://www.tty1.net/blog/2011-07-16-sieve-tutorial_en.html]

=== Speicherort ===

Die Sieve-Filter sollte im HOME-Verzeichnis des Users in der Datei '''<tt>~/.dovecot.sieve</tt>''' abgespeichert werden.

Bei der Benutzung von Managesieve werden Filterdateien im Verzeichnis '''<tt>~/Maildir/sieve/</tt>''' gespeichert und per Symlink die aktive Filterdatei verlinkt.

xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/einfilter.sieve

Andere Filterdateien können im Flterverzeichnis gespeichert sein, aber nur die Datei, die wie oben gezeigt verlinkt ist, ist die aktive Filterdatei.

xyz00@h01:~$ ls -al Maildir/sieve
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
-rw------- 1 xyz00-max xyz00 210 Nov 16 07:28 einfilter.sieve
-rw------- 1 xyz00-max xyz00 321 Nov 16 07:28 nocheinfilter.sieve
-rw------- 1 xyz00-max xyz00 99 Nov 16 07:28 weitererfilter.sieve

=== Managesieve ===

Managesieve ist ein Dienst, der es erlaubt Filterdateien aus der Ferne über ein definiertes Protokoll zu verändern sowei zu aktivieren/deaktivieren.

Der Dienst läuft jeweils auf dem Server auf dem der User seinen Account hat, also z.B. <tt>xyz00.hostsharing.net</tt>.

Folgende Einstellungen sind hierfür notwendig/empfohlen:

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Beschreibung
!Inhalt
|-
|Servername
|xyz00.hostsharing.net (entsprechend dem Usernamen anpassen)
|-
|Port
|4190
|-
|Authentifizierung
|POP3/IMAP-Username/Passwort (z.B. xyz00-max)
|-
|Sicherheit
|TLS
|}

Beispielsweise kann hierfür das Thunderbird-Plugin [http://sieve.mozdev.org/ Sieve] benutzt werden.

=== Zusammenarbeit mit Procmail ===

Es ist möglich [[Procmail]] und Sieve (über <tt>deliver</tt> nacheinander zu benutzen. Dies kann z.B. interessant sein, wenn der Paketinhaber zentral für alle User über <tt>procmail</tt> Spamfilter mit <tt>[[Spamfilter|spamassassin]]</tt> benutzen möchte und seine Nutzer dann anschließend über die grafische Óberfläche eigene (einfache) Filterregeln konfigurieren können.

Hierzu muß die <tt>.forward</tt> zunächst mit einem Aufruf für procmail zu füllen:

xyz00@h01:~$ cat .forward
"|/usr/bin/procmail"

Als letzte Regel in der <tt>.procmailrc</tt> wird dann <tt>deliver</tt> aufgerufen, welches automatisch die aktiven Sieve-Regeln ausführt:

# Letzte Procmail-Regel: Deliver aufrufen
:0 w
| /usr/lib/dovecot/deliver

Soll procmail später nicht mehr benutzt werden, kann die .forward einfach gelöscht werden, oder deliver dort explizit angegeben werden:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

=== Links ===

* Die Sieve-Filtersprache ist definiert in [http://tools.ietf.org/html/rfc5228 RFC5228]
* In [http://tools.ietf.org/html/rfc5230 RFC5230] ist die Vacation Extension von der Sieve-Sprache genau beschrieben.
* Weitere Sieve-relevante RFC's: [http://tools.ietf.org/html/rfc5229 RFC5229] Variables Extension; [http://tools.ietf.org/html/rfc5173 RFC5173] Body Extension; [http://tools.ietf.org/html/rfc5429 RFC5429] Reject and Extended Reject Extensions; [http://tools.ietf.org/html/rfc5231 RFC5231] Relational Extension; [http://tools.ietf.org/html/rfc5233 RFC5233] Subaddress Extension; [http://tools.ietf.org/html/rfc5235 RFC5235] Spamtest and Virustest Extensions; [http://tools.ietf.org/html/rfc3894 RFC3894] Copying Without Side Effects
;

[[Kategorie:E-Mail]]

Roundcube - Filter

2012-06-11T19:41:16Z

Dfr00-hs.wiki: Alias-Beschreibung umformuliert.

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm Deliver ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Die Vacation-Extension schickt Abwesenheitsmeldungen '''nur''' wenn die Mail an eine dem System für ''diesen'' Account bekannte Email-Adresse geschickt wurde. Im konkreten Fall bei der Erstellung über Roundcube müssen also für jede Email-Adresse Identitäten angelegt werden, also z.B. sowohl max.mustermann@example.org und maexchen@example.org. Diese müssen dann auch unter "Alias" explizit ausgewählt werden. Werden Emails an den Account mit einer anderen Empfänger-Adresse geschickt, erhalten diese '''keine''' Abwesenheitsmeldung. siehe auch [http://tools.ietf.org/html/rfc5230#section-4.5 RFC5230] Abschnitt 4.5
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]

==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Roundcube - Filter

2012-01-23T12:25:41Z

Dfr00-hs.wiki: Baustelle raus

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm Deliver ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]
==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Diskussion:DAViCal installieren

2011-12-22T19:42:25Z

Dfr00-hs.wiki: Kommentar zu Subdomain und suhosin ergänzt

(davical-0.9.9.7 und awl-0.49) 
DAViCal funktioniert nur wenn die Subdomain cal.example.org [[Domains#2._lokale_Subdomains_durch_auf_schalten_.2F_delegieren|delegiert]] wird, unter /home/doms/example.org/subs/cal funktioniert dies nicht! 
Grund: Nur bei bei der delegiert Domain cal.example.org wird die php.ini unter /home/doms/cal.example.org/fastcgi/php.ini eingelesen. 
Dies sollte hervorgehoben werden...

In der php.ini muss laut http://wiki.davical.org/w/Apache_Config#Virtual_Host_Installation
suhosin.server.strip off
gesetzt werden.

Der check in setup.php auf get_magic_quotes_gpc ab php 5.3, welches bei HostSharing verwendet wird, nicht mehr nötig, die Fehlermeldung ist zu ignorieren.
--[[Benutzer:fst01|fst01]] 16:33, 22. Dez. 2011 (CEST)

Danke für die Hinweise!
Kann es aktuell leider nicht nach voll ziehen - kannst es ja direkt in die Seite einarbeiten!

Da hier nicht alle nachschauen werden.

grüße chris [[Benutzer:chg00-hsdoku|chg00-hsdoku]]

Man kann auch bei Verwendung von <tt>/home/doms/example.org/subs/cal</tt> über die <tt>.htaccess</tt> steuern, welche <tt>php.ini</tt> benutzt wird und also eine speziell auf die verwendete Subdomain angepasste <tt>php.ini</tt> einsetzen. Siehe den [[PHP]]-Artikel im Wiki. Darüberhinaus wird in der Davical-Installationsanleitung ''explizit'' das Aufschalten empfohlen und beschrieben. Andere Konfigurationen sind meist möglich, müssen im Wiki aber nicht beschrieben werden. Da das Aufschalten von Subdomains nichts mehr kostet und auch im selben Paket wie dem der Hauptdomain möglich ist, spricht auch nichts dagegen die Variante mit dem Aufschalten zu nehmen.

Der Hinweis auf <tt>suhosin.server.strip off</tt> steht zwar im Davical-Wiki, aber in meiner Davical-Installation funktioniert alles out-of-the box ohne Änderung der <tt>php.ini</tt>. Daher auch kein Hinweis hierauf in der Installationsanleitung. Sollte hier jemand andere Erfahrung gemacht haben, bitte auf der support@-Liste diskutieren, dann kann man danach gucken.

--[[Benutzer:dfr00-hs.wiki|dfr00-hs.wiki]] 20:40, 22. Dez. 2011 (CET)

Managesieve

2011-11-16T10:45:41Z

Dfr00-hs.wiki: /* Speicherort */

Roundcube - Filter

2011-11-16T10:31:02Z

Dfr00-hs.wiki: link zu deliver gelöscht

{{Baustelle}}

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm Deliver ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]
==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Managesieve

2011-11-16T10:28:37Z

Dfr00-hs.wiki: Tippfehler

== Managesieve ==

Managesieve [http://wiki.dovecot.org/ManageSieve] ist ein Dienst-Programm zum Einrichten und Verwalten von Mailfiltern, die in der Filtersprache <tt>sieve</tt> geschrieben sind. <tt>Sieve</tt> ist als Dovecot-Plugin [http://wiki.dovecot.org/LDA/Sieve] verfügbar.

'''Für Nutzer, die nur einfache Filterregeln benötigen, wird empfohlen diese Filter über das grafische Oberfläsche im Webmailer [[Roundcube]] anzulegen und zu verwalten. Die Vorgehensweise ist ausführlich unter [[Roundcube - Filter]] beschrieben.'''

Diese Seite gibt einige technische Informationen und Einführung für Nutzer, die eigene Skripte in <tt>sieve</tt> schreiben wollen.

=== Filtermöglichkeiten ===

<tt>Sieve</tt> erlaubt Filter zu schreiben u.a. für folgende '''Filteraktionen''':
* Verschieben/Kopieren einer Nachricht in einen Ordner
* Erstellen von [[Roundcube - Filter#Abwesenheitsmeldung|Abwesenheitsmeldungen]]
* Markieren von Nachrichten (z.B. Gelesen, Weitergeleitet)
* Weiterleiten/Kopie senden an andere Email-Adressen
* Ablehnen von Nachrichten

Eine ausführliche Beschreibun der Filteraktivitäten ist zu finden auf der Dovecot-Seite [http://wiki.dovecot.org/LDA/Sieve#Features]

Hierbei sind '''keine''' Aufrufe von '''externen Programmen''' möglich. Dadurch können keine unerwünschten Seiteneffekte entstehen. Dies grenzt <tt>sieve</tt> beispielsweise von <tt>[[procmail]]</tt> ab.

Die '''Filterregeln''' lassen Checks zu z.B. von
* Test auf bestimmte Absender
* Vorhandensein von bestimmten Texten im Betreff oder dem Text der Nachricht
* Bestimmte Werte für andere Header der Nachricht, z.B. zur Identifizierung von Mailinglisten über List-Id.
Dabei können teilweise reguläre Ausdrücke benutzt werden oder Aggregatsfunktionen wie "Anzahl der Empfänger".

=== Einrichtung ===

Für die Einrichtung von <tt>deliver</tt> als Mailzustellungsprogramm ist keine weitere Konfiguration notwendig. Dies geschieht automatisch.

Hat ein Nutzer bisher procmail benutzt, kann die <tt>.forward</tt> gelöscht werden oder durch eine neue <tt>.forward</tt> ersetzt werden mit folgendem Inhalt:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

=== Sieve-Filter ===

Ein einfaches Sieve-Skript sieht wie folgt aus:

require "fileinto";
if header :contains "X-Spam-Flag" "YES" {
fileinto "Spam";
}

Dieses Skript prüft ob in der Nachricht der Header "X-Spam-Flag" existiert und den Wert "YES" enthält. In diesem Fall wird die Nachricht in den Ordner "Spam" abgespeichert.

Mehrere Filter werden hintereinander in eine Filterdatei gehängt. Die Filter können durch if-then-else-Konstrukte verbunden werden.

Weiter Beispiele sind zu finden z.B. unter [http://wiki.dovecot.org/LDA/Sieve#Example_scripts] oder [http://www.tty1.net/blog/2011-07-16-sieve-tutorial_en.html]

=== Speicherort ===

Die Sieve-Filter sollte im HOME-Verzeichnis des Users in der Datei '''<tt>~/.dovecot.sieve</tt>''' abgespeichert werden.

Bei der Benutzung von Managesieve werden Filterdateien im Verzeichnis '''<tt>~/Maildir/sieve/</tt>''' gespeichert und per Symlink die aktive Filterdatei verlinkt.

xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/einfilter.sieve

xyz00@h01:~$ ls -al Maildir/sieve
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
-rw------- 1 xyz00-max xyz00 210 Nov 16 07:28 einfilter.sieve
-rw------- 1 xyz00-max xyz00 321 Nov 16 07:28 nocheinfilter.sieve
-rw------- 1 xyz00-max xyz00 99 Nov 16 07:28 weitererfilter.sieve

=== Managesieve ===

Managesieve ist ein Dienst, der es erlaubt Filterdateien aus der Ferne über ein definiertes Protokoll zu verändern sowei zu aktivieren/deaktivieren.

Der Dienst läuft jeweils auf dem Server auf dem der User seinen Account hat, also z.B. <tt>xyz00.hostsharing.net</tt>.

Folgende Einstellungen sind hierfür notwendig/empfohlen:

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Beschreibung
!Inhalt
|-
|Servername
|xyz00.hostsharing.net (entsprechend dem Usernamen anpassen)
|-
|Port
|4190
|-
|Authentifizierung
|POP3/IMAP-Username/Passwort (z.B. xyz00-max)
|-
|Sicherheit
|TLS
|}

Beispielsweise kann hierfür das Thunderbird-Plugin [http://sieve.mozdev.org/ Sieve] benutzt werden.

=== Zusammenarbeit mit Procmail ===

Es ist möglich [[Procmail]] und Sieve (über <tt>deliver</tt> nacheinander zu benutzen. Dies kann z.B. interessant sein, wenn der Paketinhaber zentral für alle User über <tt>procmail</tt> Spamfilter mit <tt>[[Spamfilter|spamassassin]]</tt> benutzen möchte und seine Nutzer dann anschließend über die grafische Óberfläche eigene (einfache) Filterregeln konfigurieren können.

Hierzu muß die <tt>.forward</tt> zunächst mit einem Aufruf für procmail zu füllen:

xyz00@h01:~$ cat .forward
"|/usr/bin/procmail"

Als letzte Regel in der <tt>.procmailrc</tt> wird dann <tt>deliver</tt> aufgerufen, welches automatisch die aktiven Sieve-Regeln ausführt:

# Letzte Procmail-Regel: Deliver aufrufen
:0 w
| /usr/lib/dovecot/deliver

Soll procmail später nicht mehr benutzt werden, kann die .forward einfach gelöscht werden, oder deliver dort explizit angegeben werden:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

Sieve

2011-11-16T10:28:01Z

Dfr00-hs.wiki: Weiterleitung angelegt

#REDIRECT [[Managesieve]]

Managesieve

2011-11-16T10:26:37Z

Dfr00-hs.wiki: Erste Version der Seite

== Managesieve ==

Managesieve [http://wiki.dovecot.org/ManageSieve] ist ein Dienst-Programm zum Einrichten und Verwalten von Mailfiltern, die in der Filtersprache <tt>sieve</tt> geschrieben sind. <tt>Sieve</tt> ist als Dovecot-Plugin [http://wiki.dovecot.org/LDA/Sieve] verfügbar.

'''Für Nutzer, die nur einfache Filterregeln benötigen, wird empfohlen diese Filter über das grafische Oberfläsche im Webmailer [[Roundcube]] anzulegen und zu verwalten. Die Vorgehensweise ist ausführlich unter [[Roundcube - Filter]] beschrieben.'''

Diese Seite gibt einige technische Informationen und Einführung für Nutzer, die eigene Skripte in <tt>sieve</tt> schreiben wollen.

=== Filtermöglichkeiten ===

<tt>Sieve</tt> erlaubt Filter zu schreiben u.a. für folgende '''Filteraktionen''':
* Verschieben/Kopieren einer Nachricht in einen Ordner
* Erstellen von [[Roundcube - Filter#Abwesenheitsmeldung|Abwesenheitsmeldungen]]
* Markieren von Nachrichten (z.B. Gelesen, Weitergeleitet)
* Weiterleiten/Kopie senden an andere Email-Adressen
* Ablehnen von Nachrichten

Eine ausführliche Beschreibun der Filteraktivitäten ist zu finden auf der Dovecot-Seite [http://wiki.dovecot.org/LDA/Sieve#Features]

Hierbei sind '''keine''' Aufrufe von '''externen Programmen''' möglich. Dadurch können keine unerwünschten Seiteneffekte entstehen. Dies grenzt <tt>sieve</tt> beispielsweise von <tt>[[procmail]]</tt> ab.

Die '''Filterregeln''' lassen Checks zu z.B. von
* Test auf bestimmte Absender
* Vorhandensein von bestimmten Texten im Betreff oder dem Text der Nachricht
* Bestimmte Werte für andere Header der Nachricht, z.B. zur Identifizierung von Mailinglisten über List-Id.
Dabei können teilweise reguläre Ausdrücke benutzt werden oder Aggregatsfunktionen wie "Anzahl der Empfänger".

=== Einrichtung ===

Für die Einrichtung von <tt>deliver</tt> als Mailzustellungsprogramm ist keine weitere Konfiguration notwendig. Dies geschieht automatisch.

Hat ein Nutzer bisher procmail benutzt, kann die <tt>.foward</tt> gelöscht werden oder durch eine neue <tt>.forward</tt> ersetzt werden mit folgendem Inhalt:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

=== Sieve-Filter ===

Ein einfaches Sieve-Skript sieht wie folgt aus:

require "fileinto";
if header :contains "X-Spam-Flag" "YES" {
fileinto "Spam";
}

Dieses Skript prüft ob in der Nachricht der Header "X-Spam-Flag" existiert und den Wert "YES" enthält. In diesem Fall wird die Nachricht in den Ordner "Spam" abgespeichert.

Mehrere Filter werden hintereinander in eine Filterdatei gehängt. Die Filter können durch if-then-else-Konstrukte verbunden werden.

Weiter Beispiele sind zu finden z.B. unter [http://wiki.dovecot.org/LDA/Sieve#Example_scripts] oder [http://www.tty1.net/blog/2011-07-16-sieve-tutorial_en.html]

=== Speicherort ===

Die Sieve-Filter sollte im HOME-Verzeichnis des Users in der Datei '''<tt>~/.dovecot.sieve</tt>''' abgespeichert werden.

Bei der Benutzung von Managesieve werden Filterdateien im Verzeichnis '''<tt>~/Maildir/sieve/</tt>''' gespeichert und per Symlink die aktive Filterdatei verlinkt.

xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/einfilter.sieve

xyz00@h01:~$ ls -al Maildir/sieve
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
-rw------- 1 xyz00-max xyz00 210 Nov 16 07:28 einfilter.sieve
-rw------- 1 xyz00-max xyz00 321 Nov 16 07:28 nocheinfilter.sieve
-rw------- 1 xyz00-max xyz00 99 Nov 16 07:28 weitererfilter.sieve

=== Managesieve ===

Managesieve ist ein Dienst, der es erlaubt Filterdateien aus der Ferne über ein definiertes Protokoll zu verändern sowei zu aktivieren/deaktivieren.

Der Dienst läuft jeweils auf dem Server auf dem der User seinen Account hat, also z.B. <tt>xyz00.hostsharing.net</tt>.

Folgende Einstellungen sind hierfür notwendig/empfohlen:

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Beschreibung
!Inhalt
|-
|Servername
|xyz00.hostsharing.net (entsprechend dem Usernamen anpassen)
|-
|Port
|4190
|-
|Authentifizierung
|POP3/IMAP-Username/Passwort (z.B. xyz00-max)
|-
|Sicherheit
|TLS
|}

Beispielsweise kann hierfür das Thunderbird-Plugin [http://sieve.mozdev.org/ Sieve] benutzt werden.

=== Zusammenarbeit mit Procmail ===

Es ist möglich [[Procmail]] und Sieve (über <tt>deliver</tt> nacheinander zu benutzen. Dies kann z.B. interessant sein, wenn der Paketinhaber zentral für alle User über <tt>procmail</tt> Spamfilter mit <tt>[[Spamfilter|spamassassin]]</tt> benutzen möchte und seine Nutzer dann anschließend über die grafische Óberfläche eigene (einfache) Filterregeln konfigurieren können.

Hierzu muß die <tt>.forward</tt> zunächst mit einem Aufruf für procmail zu füllen:

xyz00@h01:~$ cat .forward
"|/usr/bin/procmail"

Als letzte Regel in der <tt>.procmailrc</tt> wird dann <tt>deliver</tt> aufgerufen, welches automatisch die aktiven Sieve-Regeln ausführt:

# Letzte Procmail-Regel: Deliver aufrufen
:0 w
| /usr/lib/dovecot/deliver

Soll procmail später nicht mehr benutzt werden, kann die .forward einfach gelöscht werden, oder deliver dort explizit angegeben werden:

xyz00@h01:~$ cat .forward
"| /usr/lib/dovecot/deliver "

E-Mail

2011-11-16T09:40:10Z

Dfr00-hs.wiki: Managesieve / Roundcube-Filter aufgenommen

{{HSDoku-Links}}
Die (auch das) '''E-Mail''' (kurz ''Mail'', von englisch ''electronic mail'': „elektronische Post“ oder „elektronischer Brief“), manchmal als '''E-Post''' oder '''E-Brief''' bezeichnet, ist eine auf elektronischem Weg in [[Rechnernetz|Computernetzwerken]] übertragene [[Nachricht]].

E-Mail wird – noch vor dem [[World Wide Web]] – als wichtigster und meistgenutzter Dienst des [[Internet]]s angesehen.

== Verfügbarkeit auf den Hostsharing-Servern ==
Jeder Benutzer, für den ein [[user|Benutzerkonto]] in einem Hostsharing-Paket eingerichtet ist, besitzt automatisch auch ein E-Mail-Konto(Postfach) bei Hostsharing und kann darüber E-Mail empfangen und senden.

Ferner haben Shell-Benutzer die Möglichkeit, durch die Installation von [[Fetchmail]], E-Mail Konten bei anderen Anbietern abzufragen und ihre dortigen E-Mails abzurufen.

== E-Mail empfangen und senden ==
Für den Zugriff auf die E-Mails kann entweder unser [[Webmail]]-System oder ein beliebiger anderer Mailclient verwendet werden, zum Beispiel [http://www.mozilla-europe.org/de/products/thunderbird/ Thunderbird]. Wie der Mailclient einzurichten ist, ist unter [[Mailclient einrichten]] beschrieben.

Damit ein Benutzer Nachrichten empfangen kann, muss natürlich außerdem eine [[E-Mail-Adressen]] entsprechend eingerichtet werden, sodass Nachrichten an diese Adresse in das Postfach des Benutzers ausgeliefert werden. Jeder Paketadmin hat automatisch einige [[E-Mail-Adressen#Standard_Adressen|Standard-Adressen]].

=== Größenbeschränkung ===
Die Hostsharing-Server akzeptieren Mail-Nachrichten nur bis zu einer [[Größenbeschränkung von E-Mails|maximalen Größe]] von netto 128 MB. In der Praxis bedeutet das, dass Dateianhänge eine maximale Größe von ca. 90 MB haben dürfen.

== Weitergehende Konfigurationsmöglichkeiten ==

Durch das Anlegen von Benutzerkonten und E-Mail-Adressen lassen sich die meisten Anwendungsfälle gut abdecken. Für speziellere Anforderungen bietet Hostsharing aber noch eine ganze Reihe weiterer Konfigurationsmöglichkeiten, die im Folgenden beschrieben werden.

* Automatisches Filtern und Bearbeiten von Emails über [[Managesieve]] order [[procmail]]. Managesieve kann hierbei über die [[Roundcube - Filter|Webmail-Oberfläche]] konfiguriert werden.
* Mit [[aliases|Aliasen]] kann die Zustellung von Nachrichten in die Postfächer der Benutzer genauer gesteuert werden.

* [[hsadmin-mail]] bietet viele Optionen beim Einrichten von E-Mail-Adressen.

* Es können [[Mailinglisten]] eingerichtet werden.

== E-Mail-Infrastruktur ==

Wir nutzen [http://www.postfix.org/ Postfix] als [[Mail Transfer Agent]](MTA) bzw. Mailserver. Diese Software dient dazu, eingehende Mails den lokalen Usern des Servers zuzuordnen, an interne oder externe Server zuzustellen.

E-Mails werden vom Mailsystem im Verzeichnis Maildir des jeweiligen User-Accounts abgelegt (der Name ist systemweit eingestellt und kann nicht verändert werden).

Damit sind die Mails im normalen Backup enthalten und gehen auch in die Quota des Paketes ein. Das Verzeichnis wird automatisch angelegt, wenn die erste E-Mail dort abgelegt wird.

Ist das Verzeichnis Maildir nicht angelegt, liefern E-Mail-Clients oder Webmail-Clients aufgrund des fehlenden Verzeichnisses eine Fehlermeldung.
Dies kann verhindert werden, indem auf der Shell in dem entsprechenden User-Account folgender Befehl ausführt wird:

<pre> maildirmake Maildir</pre>

== Weiterführende Links ==

[[HS-Mailrouting]]

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Verzeichnis-Struktur

2011-11-16T09:37:18Z

Dfr00-hs.wiki: Managesieve aufgenommen

{{Baustelle}}
== Verzeichnis-Struktur ==

Es folgt eine Übersicht der Verzeichnisstruktur in HS Paketen.
(Paket-Admin, Domain-Admin sowie DW / SW - Pakete)

=== eines Paket-Admins ===

{| class="wikitable"
|- class="hintergrundfarbe5"
!Verzeichniss !!Datei!! Beschreibung
|-
| xyz00@h01:~ || || Home Verzeichnis des Paketes
|-
| xyz00@h01:~/.bak || || Sicherungsdateien (cron/doms/dbs)
|-
| xyz00@h01:~/etc || || Verzeichnis für zb.: config.ini, dom-order.upd, dom-users, event-handler
|-
| xyz00@h01:~/fastcgi || || xyz00.hostsharing.net
|-
| xyz00@h01:~/fastcgi-ssl || || xyz00.hostsharing.net
|-
| xyz00@h01:~/web || || xyz00.hostsharing.net
|-
| xyz00@h01:~/web-ssl || || xyz00.hostsharing.net
|-
| xyz00@h01:~/cgi || || xyz00.hostsharing.net
|-
| xyz00@h01:~/cgi-ssl || || xyz00.hostsharing.net
|-
| xyz00@h01:~/users || || Die Benutzer (user) des Pakets
|-
| xyz00@h01:~/var || || des Pakets
|-
| xyz00@h01:~/Maildir || || des Pakets
|}

=== eines DomainAdmin-Users ===

Der PaketAdmin hat einem User des Pakets eine Domain zugeordnet. So ergibt sich folgende Verzeichnisstruktur:

{| class="wikitable"
|- class="hintergrundfarbe5"
!Verzeichniss !!Datei!! Beschreibung
|-
| xyz00-abc@h01:~ || || Home Verzeichnis des Users
|-
| xyz00-abc@h01:~/Maildir || || Alles rund um Mail
|-
| xyz00-abc@h01:~/doms || || Hier liegen die Domains des Users
|}

=== Verzeichnisaufbau je Domain ===

{| class="wikitable"
|- class="hintergrundfarbe5"
!Verzeichniss !!Datei!! Beschreibung
|-
| xyz00-abc@h01:~/doms/example.com || || Für jede Domain ein Verzeichnis
|-
| xyz00-abc@h01:~/doms/example.com/cgi || ||
|-
| xyz00-abc@h01:~/doms/example.com/cgi-ssl || ||
|-
| xyz00-abc@h01:~/doms/example.com/etc || ||
|-
| xyz00-abc@h01:~/doms/example.com/fastcgi || ||
|-
| xyz00-abc@h01:~/doms/example.com/fastcgi-ssl || ||
|-
| xyz00-abc@h01:~/doms/example.com/htdocs || ||
|-
| xyz00-abc@h01:~/doms/example.com/htdocs-ssl || ||
|-
| xyz00-abc@h01:~/doms/example.com/subs || ||
|-
| xyz00-abc@h01:~/doms/example.com/subs-ssl || ||
|-
| xyz00-abc@h01:~/doms/example.com/var || ||
|}

=== weiter Verzeichnisse / Dateien ===

{| class="wikitable"
|- class="hintergrundfarbe5"
!Verzeichnis!! Datei!! Bemerkung
|-
|~/.bak/ || ||Komprimiertes Backup verschiedener Dateien, vor allem der Datenbanken. Siehe Nächtliche Paket-Backups
|-
| ||crontabs.tar.gz||Die crontabs
|-
| ||dbusers....|| Aufstellung der Datenbank-User
|-
|~/ ||.forward ||In dieser Datei im Homeverzeichnis eines beliebigen Benutzers können eine oder mehrere E-Mail-Adressen stehen. Alle eingehenden E-Mails für den User werden an die Mailboxen oder E-Mail-Adressen weitergeleitet, die in der Datei sind. Außerdem wird die Datei für den Einsatz von Mailfilterprogrammen wie [[Managesieve]] oder [[Procmail|procmail]] verwendet.
|-
|~/doms || ||Verzeichnis, in dem die Verzeichnisse für Domains angelegt sind.
|-
| ||[[Aliases|aliases]]|| E-Mail Weiterleitungen für alle User
|-
| ||.htpasswd|| Verantwortlich für Passwortschutz. Siehe .htaccess
|-
| ||passwd|| Datei für Passwörter der [[User]]. Dient auch zum Neuanlegen oder Löschen von [[User|Usern]]
|-
| ||shadow|| enthält die verschlüsselten Passwörter der User-Accounts des Paketes. Die Datei darf niemals von Hand bearbeitet werden, sondern dient vor allem als Backup, falls das Paket auf einen anderen Server verschoben wird und kann mit passenden Algorithmen von Skripten zur Überprüfung der Passwörter verwendet werden.
|-
| ||dom-users|| Hier kann man nachträglich (also nach dem Domain-Auftrag per Formular) eine Domain einem User zuweisen. (Bald veraltet!)
|-
| ||https.pem|| Hier wird der csr eines SSL-Zertifikates abgelegt.
|-
| ||event-handler|| Diese Datei ermöglicht es, bei bestimmten Ereignissen, wie zum Beispiel nach der Aktivierung des Pakets nach einem Umzug, automatisch eigene Programme, oder einen eigenen Daemon starten zu lassen.
|-
|~/ftp || ||für anonymous FTP (falls im Paket verfügbar)
|-
|~/var|| ||web.log aktuelles logfile aller domains des Paketes
|-
| ||web-example.com.gz|| derzeit alle gesplitteten Domain-Logfiles
|-
| ||config.err|| Logfile der Fehlermeldungen, die beim Bearbeiten vonKonfigurations-Dateien aufgefallen sind. Hier sollte man reinsehen,wenn Änderungen anscheinend nicht vom Robot übernommen werden.
|-
| ||web.err|| Dies ist das Logfile des Apache-Webservers. Es enthält die Fehlermeldungen für alle Domains im Paket.
|}

----

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:ToDo-Kerndoku]]

WEB-Paket

2011-11-16T09:36:05Z

Dfr00-hs.wiki: Managesieve aufgenommen

{{HSDoku-Links}}

== Jedes Dynamik-Web Paket ==

* stellt eine eigene UNIX-User-Gruppe dar
* erlaubt mehrere POP3/IMAP- und (je nach Pakettyp) einen oder mehrere FTP/SSH/Telnet-[[User]]
* enthält vom Pakettyp abhängigen, durch Quota begrenzten Speicherplatz, der für jeden einzelnen Paket-User individuell quotiert werden kann
* beinhaltet je nach Pakettyp einen entsprechenden Frei-[[Traffic]] pro Monat
* kann eine theoretisch unbegrenzte Anzahl [[Domains]] enthalten
* hat ein eigenes login-Prefix für die Usernamen
* kann bei Bedarf, z.B. für anonymous-FTP und HTTPS, eine eigene IP-Nummer erhalten (selbstverständlich in den Grenzen der Vergaberichtlinien der jeweiligen Registrars, z.B. des RIPE)
* unterstützt zur Zeit: E-Mail mit IMAP, SMTP und POP3 sowie [[Managesieve]]/[[procmail]] (Email-Filter), FTP, HTTP mit CGI-bin, [[PHP]], [[MySQL]] und SSI sowie [[cron|cronjobs]]

== Weiterführende Links ==
[[DW-Speicherbelegung]] 
[[Verzeichnis-Struktur]]

----
[[Kategorie:HSDoku]]
[[Kategorie:Pakete bei HS]]
[[Kategorie:Dynamic-Web Pakete]]
[[Kategorie:Glossar]]
[[Kategorie:ToDo-Kerndoku]]

Spamfilter

2011-11-16T09:33:16Z

Dfr00-hs.wiki: Tippfehler

Einrichtung, Konfiguration und Optimierung eines Spamfilters auf den Hostsharing Servern.

= Spamassassin Konfigurieren =

Der Spamfilter "Spamassassin" ist bei HS vorinstalliert und kann wie auf der Seite [[Procmail]] beschrieben für eine Mailbox eingebunden werden.

ToDo: Anpassung Konfiguration, Filtertraining

= Mitteilungen über aussortierte Emails erzeugen lassen =

Spamcheck Verzeichnis im Homeverzeichnis anlegen,

mkdir spamcheck
cd spamcheck

und dort drei Skiptdateien anlegen und deren Voreinstellungen anpassen:

<pre>
cat > check <<EOF
#!/bin/sh
#----------------------------------------------------------------------------------------
# send spam mailfolder infomail
# (c) 04/2004 by ff, webmaster@ff-newmedia.net
#----------------------------------------------------------------------------------------
#set -x
version="0.4 0405201035 (modified)"
mailuser=$1
mailpath="Maildir/.Spam/"
checkmaildir="spamcheck/checkmaildir"
listmaildir="spamcheck/listmaildir"
mailhost="h02"
maildomain="hostsharing.net"
purgetime="7"

if ($checkmaildir $mailpath)
then
mailbox_status=`$listmaildir $mailpath`
# send infomail
(
echo "From: spamcheck <admin@xyz00.$maildomain>"
echo "To: $mailuser <$mailuser@$mailhost.$maildomain>"
echo "Subject: Status des Spam-Ordners"
echo
echo
echo "$mailbox_status"
echo
echo
echo "Bitte pruefen ob evtl. erwuenschte Nachrichten aussortiert wurden."
echo "Zugriff auf das Postfach ist IMAP oder Webmail mÃglich."
echo "(https://webmail.hostsharing.net)"
echo
echo
echo "-- "
echo "created by spamcheck $version"
)|/usr/lib/sendmail $mailuser@$mailhost.$maildomain
else
exit 1
fi

exit 0
EOF
</pre>

<pre>
cat > checkmaildir <<EOF
#!/usr/bin/perl
#----------------------------------------------------------------------------------------
# send spam mailfolder infomail - check if maildir exists
# (c) 05/2004 by ff, webmaster@ff-newmedia.net
# based on mdfrm (c) 1996, Matthew C. Mead
#----------------------------------------------------------------------------------------

$maildir = shift;

if (!$maildir) {
$maildir = $ENV{'MAILDIR'};
}

if (!$maildir) {
$maildir = "$ENV{'HOME'}/.Maildir";
}

$maildir =~ s/^=/$ENV{'HOME'}\/Mail\//;

# Kein Spamordner vorhanden - Errorcode 1
if (!(-d $maildir && -r $maildir && -x $maildir && -d "$maildir/cur" &&
-r "$maildir/cur" && -x "$maildir/cur" && -d "$maildir/new" &&
-r "$maildir/new" && -x "$maildir/new")) {
exit 1;
}

# Anderenfalls nachsehen ob Mails vorhanden sind
opendir(DIR, "$maildir/cur");
@tmpfiles = map{$_ = "$maildir/cur/$_"} grep{!/(^\.$)|(^\.\.$)/} readdir(DIR);
@msgfiles = @tmpfiles;
closedir(DIR);
opendir(DIR, "$maildir/new");
@tmpfiles = map{$_ = "$maildir/new/$_"} grep{!/(^\.$)|(^\.\.$)/} readdir(DIR);
push(@msgfiles, @tmpfiles);
closedir(DIR);

# Wenn keine Mails vorhanden - Errorcode 1
if (!@msgfiles) {
exit 1;
}

# Wenn Mails vorhanden - Errorcode 0
exit 0;
EOF
</pre>

<pre>
cat > listmaildir <<EOF
#!/usr/bin/perl
#----------------------------------------------------------------------------------------
# send spam mailfolder infomail - list maildir contents
# (c) 05/2004 by ff, webmaster@ff-newmedia.net
# based on mdfrm (c) 1996, Matthew C. Mead.
#----------------------------------------------------------------------------------------
$hours = 24; #Anzeigen von Mails, deren mtime hoechstens $hours Stunden in der Vergangenheit liegt

use Date::Parse;
use Date::Format;

$maildir = shift;

if ($maildir eq "-h") {
print "usage: mdfrm /path/to/Maildir\n";
print " mdfrm =Maildir == mdfrm ~/Mail/Maildir\n";
print " otherwise, mdfrm defaults to \$MAILDIR\n";
print " otherwise, mdfrm defaults to ~/.Maildir\n";
exit;
}

if (!$maildir) {
$maildir = $ENV{'MAILDIR'};
}

if (!$maildir) {
$maildir = "$ENV{'HOME'}/.Maildir";
}

$maildir =~ s/^=/$ENV{'HOME'}\/Mail\//;

if (!(-d $maildir && -r $maildir && -x $maildir && -d "$maildir/cur" &&
-r "$maildir/cur" && -x "$maildir/cur" && -d "$maildir/new" &&
-r "$maildir/new" && -x "$maildir/new")) {
# faellt weg, da checkmaildir bereits ueberprueft
# print "Kein Spamordner in \"$maildir\" vorhanden. Sie haben offensichtlich noch keine Spammails erhalten.\n";
exit 1;
}

opendir(DIR, "$maildir/cur");
@tmpfiles = map{$_ = "$maildir/cur/$_"} grep{!/(^\.$)|(^\.\.$)/} readdir(DIR);
@msgfiles = @tmpfiles;
closedir(DIR);
opendir(DIR, "$maildir/new");
@tmpfiles = map{$_ = "$maildir/new/$_"} grep{!/(^\.$)|(^\.\.$)/} readdir(DIR);
push(@msgfiles, @tmpfiles);
closedir(DIR);

@msgs = ( );

foreach $file (@msgfiles) {
# wirkliches Alter der Mail
$mtime = (stat($file))[9];

$from = "";
$subject = "";
$date = 0;
$hits = 0;

open(INPUT, $file);

FILEINPUT:
while(<INPUT>) {

if (/^From:\s+(.*)$/i) {
$from = $1;
next FILEINPUT;
}

if (/^Subject:\s+(.*)$/i) {
$subject = $1;
next FILEINPUT;
}

if (/^Date:\s+(.*)$/i) {
$date = $1;
next FILEINPUT;
}

if (/^X-Spam-Status: Yes, hits=+(.*)$/i) {
$hits = $1;
next FILEINPUT;
}

if (/^\s*$/) {
last FILEINPUT;
}

if ($from && $subject && $date && $hits) {
last FILEINPUT;
}

}

close(INPUT);

@tmp = ( str2time($date), $from, $subject, $mtime, $hits );
push(@msgs, [ @tmp ]);
}

$oldest = time - $hours * 3600; # Berechnen des Timestamps now - $hours

$o = 0;

foreach $msg (@msgs){
if ($msg->[3] >= $oldest) { # Innerhalb der letzten $hours aussortierte Mails
$o++;
}

$i++; # alle Mails
}

if ($i==0) { # Wenn keine Mail da sind, Errorcode 1
exit 1;
}

print("Insgesamt befinden sich ", $i, " E-Mails in Ihrem Trash-Ordner.\n");
print("In den letzen ", $hours, " Stunden wurden ", $o, " Spam-E-Mails
aussortiert.\n\n");
if ($o==0) { exit 0; }
print("Datum (mtime) Absender Betreff Hits\n");
print("-----------------------------------------------------------------------");

foreach $msg (sort {$b->[3] <=> $a->[3]} @msgs) { # Sortierung vorher auf 0/0
if ($msg->[3] >= $oldest) {
if ($msg->[1] =~ /\s*"*([^"]*)"*\s*\<[a-zA-Z0-9._%-=]+@[a-zA-Z0-9._%-=]+\>/) {
$from = $1;
} elsif ($msg->[1] =~ /[a-zA-z0-9._%-=]+@[a-zA-Z0-9._%-=]+.*$"*([^"]*)"*$/) {
$from = $1;
} else {
$from = $msg->[1];
}

# Datum ausgeben
if (time2str("%d",$msg->[3]) <=> $olddate) {
print("\n");
}

# Urspruengliches aus der Mail extrahiertes Datum, sinnlos weil oft gefaelscht
# printf("%-12s ", time2str("%d.%m.%y %H:%M",$msg->[0]));
printf("%-12s ", time2str("%d.%m.%y %H:%M",$msg->[3]));

$olddate = time2str("%d",$msg->[3]);

# From ausgeben
if (length($from) <= 20) {
printf("%-20s ", $from);
} else {
printf("%-.20s ", $from);
}

# um *****SPAM***** bereinigtes Subject ausgeben
@sub = $msg->[2];
if (length(@sub) <= 27) {
printf("%-27s ", @sub);
} else {
printf("%-.27s ", @sub);
}

# Punkte
if (length($msg->[4]) <= 4) {
printf("%-4s\n", $msg->[4]);
} else {
printf("%-.4s\n", $msg->[4]);
}

}
}

exit 0;
EOF
</pre>

Und diese ausführbar machen:

chmod a+x check checkmaildir listmaildir

Anschließend einen [[Cron]]job anlegen, der check für den Mailboxuser aufruft:

#Spam Verzeichnis checken
51 5 * * * sleep $[ ($RANDOM % 120) ]; spamcheck/check xyz00-otto

= Automatisches löschen aussortierter Emails =

ToDo: Emails nach einer bestimmten Zeit löschen.

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Glossar]]

Procmail

2011-11-16T09:32:18Z

Dfr00-hs.wiki: Verweis auf Managesieve

Procmail ist ein mächtiger Filter, der für viele komplexe Aufgaben verwendet werden kann. So sind z.B. variable Weiterleitungen und das einbinden eines Spamfilters machbar. Mehr dazu unter www.procmail.org und auf dem Server in den Manpages zu procmail, procmailrc und procmailex.

Das Standard-Mail-Zustellungsprogramm (Local Delivery Agent - LDA) bei Hostsharing ist <tt>deliver</tt> aus dem <tt>dovecot</tt>-Paket. Hier können Filter über [[Managesieve]] angelegt und z.B. über [[Roundcube - Filter|Webmail konfiguriert]] werden. Procmail sollte nur noch von fortgeschrittenen Nutzern für komplexe Filteraufgaben benutzt werden.

=== Eingehende Emails an Procmail weiterleiten ===

Zur Nutzung von procmail wird im Homedirectory des Users eine Datei .forward angelegt, die nur aus einer Zeile besteht:

"|/usr/bin/procmail"

Damit werden alle Mails an das Programm procmail übergeben und die Auslieferung kann nun über die Datei ~/.procmailrc konfiguriert werden.

=== Procmail konfigurieren ===

Das nachfolgende Beispiel zeigt wie ein [[Spamfilter]] eingebunden werden kann, und Emails automatisch in IMAP-Folder (Verzeichnisse) einsortiert werden können.

==== Verzeichnisse anlegen ====

Die angesprochenen Emailverzeichnisse sollten vorher angelegt worden sein, falls sie noch nicht existieren ist dies z.B. mit dem Befehle maildirmake möglich:

maildirmake Maildir
maildirmake -f Trash Maildir
maildirmake -f Spam Maildir
maildirmake -f Hostsharing Maildir

Alternativ können die Verzeichnisse auch über die Webmail-Oberfläche anlgelegt werden. Es ist übrigens korrekt, dass die Folder beim Anlegen ohne einen führenden Punkt im Namen erstellt werden, in der .procmailrc aber mit Punkt angegeben werden.

==== .procmailrc ====

Eine beispielhafte .procmailrc:
<pre>
## Logging abstellen
COMSAT=no
LOGABSTRACT=no
VERBOSE=no
LOGFILE=procmail.log

## Spamassassin für alle Mails aufrufen...
# Hier wird der systemweite Spamassassin-Daemon benutzt.
:0fw
| /usr/bin/spamc -U /var/run/spamd
## ...und Spam in den Spam Folder aussortieren
:0
* ^X-Spam-Flag: YES
Maildir/.Spam/

## Bsp. Mailinglisten von Hostsharing in eine extra Box
#:0
#* ^TO_(support|technik|website)@hostsharing\.net
#Maildir/.Hostsharing/

# Alle nicht ausgefilterten Mails landen in der normalen Mailbox
</pre>

==== Abwesenheitsbenachrichtigung (vacation) ====

Zunächst im Home-Ordner eine Datei vacation.msg erstellen, deren Text als Nachricht verschickt werden soll.

Dann in die .procmailrc folgende Zeilen einfügen:
<pre>
SHELL=/bin/sh
FORMAIL=/usr/bin/formail
SENDMAIL=/usr/sbin/sendmail
:0 Whc: vacation.lock
* ^TO_myself@example.com
# Nur E-Mails, die an meine Adresse adressiert sind
* !^FROM_DAEMON
# Daemons (Mailinglisten) ausschließen
* !^X-Loop: myself@example.com
# Loop vermeiden: eigene E-Mail ausschließen
| formail -rD 8192 vacation.cache
# Adresse des Senders im Cache speichern
:0 ehc
# e: letztes recipe trifft nicht zu (Adresse noch nicht im Cache vorhanden)
| ($FORMAIL -rA "Precedence: junk" -A "X-Loop: myself@example.com" ; /bin/cat vacation.msg ) | $SENDMAIL -oi -t -f myself@example.com
</pre>

Nun wird eine E-Mail mit dem Inhalt der Datei vacation.msg und dem Absender myself@example.com an die Absender empfangener Emails geschickt. Allerdings nur, wenn die Adresse noch nicht in der vacation.cache-Datei vorhanden war. Damit wird vermieden, dass ein Absender immer wieder die Abwesenheitsnachricht erhält.

=== Links zu weiteren Procmail Beispielen und Tipps ===

http://pm-doc.sourceforge.net/doc/

http://lipas.uwasa.fi/~ts/info/proctips.html (Timo's procmail tips and recipes)

[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Roundcube - Emailhervorhebung

2011-11-16T09:21:08Z

Dfr00-hs.wiki: Wiki-Kategorien

In der Mailbox-Ansicht können Emails nach bestimmten Kriterien farbig hervorgehoben werden um z.B. Mails von bestimmten Absendern oder Maillinglisten schneller zu entdecken oder Emails von bestimmten Absendern farblich herauszustellen.

== Konfiguration ==
[[Bild:Roundcube-message-highlighting-configuration.png‎|right|miniatur|500px|Konfiguration farbige Email-Hervorhebung]]

Unter Einstellungen → Nachrichtenmarkierung können die Einstellungen vorgenommen werden.

Hierzu können Regeln erstellt werden:

* Welche '''Email-Kopfzeile''' durchsucht werden soll: Absender, Betreff, Empfänger, Kopie-Empfänger
* '''Text''', der in dieser Kopzeile enthalten sein soll, z.B. "Hostsharing", "Rechnung", "Peter" etc.
* Auwahl einer '''Farbe''', die für diese Email als Hintergrund benutzt wird.

 
== Beispiel ==
[[Bild:Roundcube-message-highlighting-example.png‎|right|miniatur|650px|Beispiel farbige Email-Hervorhebung]]

Das Beispiel rechts zeigt die farbige Hervorhebung basierend auf den im vorherigen Abschnitt definierten Beispielregeln.

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Roundcube - Adressgruppen

2011-11-16T09:20:47Z

Dfr00-hs.wiki: Wiki-Kategorien

Adressen im [[Roundcube#Kontakte - Adressbuch|Adressbuch]] von [[Roundcube]] können gruppiert werden um beim Verfassen von Emails z.B. Verteilerlisten zu verwenden.

 
[[Bild:Roundcube-addressbook-simple.png‎|miniatur|350px|right|normales Adressbuch]]
== Adressgruppen erstellen und bearbeiten ==

Zum Erstellen einer neuen Gruppe für das Adressbuch auf das "+" unten links klicken (siehe "A" im Bild) und dann im neu erscheinenden Feld ("B") den Namen der Gruppe eintragen.

[[Bild:Roundcube-addressbook-creategroup.png‎|miniatur|350px|right|Gruppe erstellen]]
 
[[Bild:Roundcube-addressbook-addtogroup.png‎|miniatur|350px|right|Adressen zur Gruppe hinzufügen]]
Um eine Adresse einer Gruppe zuzuordnen kann man diese per Drag+Drop mit der Maus in die Gruppe hereinziehen.

Ein Eintrag aus dem Adressbuch kann beliebig vielen Gruppen zugeordnet werden.
 
[[Bild:Roundcube-addressbook-group.png‎|miniatur|350px|right|Adressgruppe anzeigen]]
Durch Klicken auf die Gruppe werden ihre Mitglieder angezeigt.

Löschen von Einträgen: Zu löschende Adresse auswählen und auf das Löschsymbol in der Symbolleiste über dem Adressbuch klicken. Alternativ über das Kontextmenü des Eintrages (rechte Maustaste)

 
[[Bild:Roundcube-addressbook-compose1.png‎|miniatur|260px|right|Neue Email: Gruppe auswählen]]
== Adressgruppen benutzen ==

Beim Verfassen von Emails wird beim Tippen der Anfrangsbuchstaben der Empfänger eine Auswahl der möglichen Treffer aus dem Adressbuch angezeigt.

Hier erscheinen auch die Adressgruppen. Im obigen Beispiel bei Eingabe von "Priv" erscheint in der Auswahl "Privat (3)": Die Klammer zeigt, daß es sich um eine Gruppe handelt, die 3 Einträge enthält.

 
[[Bild:Roundcube-addressbook-compose2.png‎|miniatur|260px|right|Neue Email: Gruppe in Namen auflösen]]
Wird diese Gruppe ausgewählt, wird die Liste aufgelöst und es werden die Email-Adressen, die in der Gruppe enthalten sind angezeigt.

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Roundcube - Threads

2011-11-16T09:20:15Z

Dfr00-hs.wiki: Wiki-Kategorien

== Roundcube - Threads ==

Der Webmailer [[Roundcube]] kann neben der Sortierung nach Datum / Absender / Titel etc. auch Emails nach "Gesprächen" (Threads) gruppieren.

Die Gruppierung erfolgt hierbei je nach IMAP-Server durch Zusammenfassen der Mails mit "gleichem" Subject, bzw. dem Zusammenfassen und hierarchischen Anordnen durch die Nutzung der Message-ID's und References-Header in den Emails.

Dadurch ist es möglich Diskussionen zum Selben Thema mit den zugehörigen Antworten auf einen Blick zu lesen.

=== Beispiel ===
[[Bild:Roundcube-threads-without.png‎|miniatur|400px|left|Posteingang ohne Threads]]
[[Bild:Roundcube-threads-with.png‎|miniatur|none|400px|right|Posteingang mit Threads]]

Das erste Bild zeigt die Standardansicht auf den Posteingang ohne Threads. Mit der Standardsortierung nach Datum erscheinen die neusten Emails oben und die Struktur der Emails zueinander ist nicht erkennbar.

Im zweiten Bild wurden Threads für den Ordner aktiviert und zusammenhängende Emails werden gruppiert.

Standardmäßig werden hierbei Threads mit nur gelesenen Mails "zusammengeklappt" gezeigt und können durch das vorangestellte "+" aufgeklappt werden. Threads, die ungelesene Emails enthalten werden per Standardeinstellung "aufgeklappt" gezeigt um die komplette Diskussion zu sehen.

[[Bild:Roundcube-threads-configuration.png‎|miniatur|300px|right|Thread-Anzeige aktivieren]]
=== Konfiguration ===

==== Einrichten ====

Die Thread-Anzeige muss / kann für jeden Ordner einzeln eingerichtet werden.

Dazu unter Einstellungen → Reiter Ordner gehen und für jeden gewünschten Ordner "Gruppiert" anklicken.

[[Bild:Roundcube-threads-options.png‎|miniatur|300px|right|Thread-Anzeige Aufklapp-Optionen]]
==== Optionen ====

Das automatische Aufklappen von Threads kann unter Einstellungen → Mailbox-Ansicht konfiguriert werden.

Im Menüpunkt "''Konversationen aufklappen''" können folgende Optionen ausgewählt werden:

* '''nie''': Threads werden nie automatisch aufgeklappt und müssen durch das vorangestellte "+" aufgeklappt werden.
* '''immer''': Alle Threads sind immer aufgklappt und können in der Ansicht manuell durch "-" zugeklappt werden.
* '''nur ungelesene''' (Default): Threads mit ungelesenen Emails werden aufgeklappt gezeigt, die anderen zugeklappt.

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Roundcube - Filter

2011-11-16T09:19:37Z

Dfr00-hs.wiki: Kategorien

{{Baustelle}}

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm [[Deliver]] ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]
==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

Roundcube - Filter

2011-11-16T09:18:29Z

Dfr00-hs.wiki: Technisches

{{Baustelle}}

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm [[Deliver]] ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]
==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

 

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|400px|left|Filter abschalten]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|Filterübersicht im inaktivem Filter]]
==== Filter deaktivieren/aktivieren ====

Soll ein Filter temporär deaktivitert werden, kann in der Filterbearbeitung '''Filterregel abschalten''' angeklickt werden. In der Filterübersicht ist der Filter dann als ''"(abgeschaltet)"'' markiert.

 
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|600px|right|Nach dem Filtern]]
==== Nach dem Filtern ====

Die im obigen Beispiel gezeigte Inbox mit über 200 Emails sieht nach Anwendung der Filter wie im nebenstehenden Bild aus.

* Im Posteingang '''(1)''' ist nur noch eine private Email vorhanden
* Die Emails and die Mailinglisten wurden in die jeweiligen Ordner '''(2)''' einsortiert.

=== Technisches ===

==== Speicherort ====

Roundcube speichert die erstellten Regeln unter
~/Maildir/sieve/roundcube.sieve
und verlinkt diese Filterdatei automatisch für die Benutzung mit dovecot:
xyz00@h01:~$ ls -al
drwxr-xr-x 5 xyz00-max xyz00 4096 Nov 16 07:28 .
drwxr-xr-x 28 xyz00-max xyz00 4096 Oct 22 23:06 ..
lrwxrwxrwx 1 xyz00-max xyz00 29 Nov 16 07:28 .dovecot.sieve -> Maildir/sieve/roundcube.sieve

Wurden von anderen Programmen -- oder manuell -- andere Filtersets angelegt, werden diese vom Plugin deaktiviert. Die ursprüngliche Filterdatei bleibt erhalten, aber obiger Symlink verweist dann auf die Roundcube-Filter.

==== Manuelles Editieren ====

Vom manuellen Bearbeiten der Filterdatei <tt>roundcube.sieve</tt> wird abgeraten, da bei erneutem Einlesen durch das Roundcube-Plugin diese Regeln mit großer Wahrscheinlichkeit wieder automatisch umgeschrieben werden.

Für komplexeres Filtern kann eine komplett manuelle Datei angelegt werden und entsprechend verlinkt werden. Siehe auch den Artikel zu [[Managesieve]].

==== Quelle ====

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden. Ein Userforum zum Plugin gibt es im [http://www.roundcubeforum.net/7-third-party-contributions/46-api-based-plugins/4878-sieverules-plugin.html Roundcubeforum].

Roundcube - Filter

2011-11-16T09:02:06Z

Dfr00-hs.wiki: Beispiel Kopie weiterleiten

{{Baustelle}}

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm [[Deliver]] ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|Reihenfolge Filter ändern über Pfeile]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|Nach Änderung der Reihenfolge]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

[[Bild:Sieve-08-kopiesenden.png|miniatur|600px|right|TEXT]]
==== Kopie an anderen Empfänger versenden. ====

Eine erhaltene Email soll an eine andere Email-Adresse (in Kopie) weitergeleitet werden, z.B. von der Privatadresse an die Geschäftsadresse.

* '''Filterregel''': In diesem Beispiel soll der lokale Teil der Absender-Adresse verglichen werden. "Absender" wählen, dann "weitere Optionen" '''(1)''' und unter ''Operatoren'' ''User-Teil gleich''. '''(2)''' Im Beispiel wurde der User-Teil mit ''susanne.musterfrau'' '''(3)''' angegeben. Zur Email-Adresse ''susanne.musterfrau@example.de'' wird ein Match gefunden für ''sara-susanne.musterfrau@example.org'' hingegen nicht, weil der lokale Teil der Email-Adresse nicht übereinstimmt.
* '''Filteraktionen''': "Sende eine Kopie an" wählen '''(4)''' und eine Ziel-Adresse angeben.

=== Technisches ===

[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|300px|right|TEXT]]

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden.

Roundcube - Filter

2011-11-16T06:35:50Z

Dfr00-hs.wiki: Abwesenheitsmeldung - weitere Details

{{Baustelle}}

== Roundcube - Filter ==

Das Webmailprogramm [[Roundcube]] erlaubt Emails automatisch zu Filtern. Dieser Artikel beschreibt, wie mit der Erweiterung sieverules solche Filter definiert werden können.

=== Allgemeines zum Filtern ===

Über das Mailzustellungsprogramm [[Deliver]] ist es mit der Erweiterung [[Managesieve]] möglich Emails beim Eintreffen in der Mailbox zu Filtern. Die Filterung findet hierbei bereits auf dem Server statt, so daß der User nicht mit seinem Mailprogramm oder Webmailer eingeloggt sein muß.

Hierbei ist es möglich u.a. folgende Aktionen durchzuführen

* Mails in einen bestimmten Ordner abzuspeichern
* Mails an einen anderen Empfänger weiterzuleiten
* eine Abwesenheitsmeldung zu verschicken
* den Empfang einer Email abzulehnen
* eine Mail zu löschen

Die Ausführung dieser Filteraktionen kann gesteuert werden z.B. basierend auf

* dem Absender der eintreffenden Email
* des Titels oder Teilen hiervon
* dem Vorhandensein oder Nichtvorhandensein bestimmter Wörter im Text der Nachricht
* die Auswertung von zusätzlichen Mail-Headern.

[[Bild:Sieve-01-einstellungen.png|miniatur|250px|right|Einstellungen]]
Detaillierte Informationen können z.B. der [http://de.wikipedia.org/wiki/Sieve Wikipedia] oder unter [http://www.sieve.info sieve.info] entnommen werden. Im Hostsharing-Wiki unter [[Managesieve]] sind ebenfalls weitere Grundlageninformationen zu finden.

=== Einrichtung ===

Filter können unter <tt>Einstellungen</tt> eingerichtet und verändert werden. Hierzu im Menu Einstellungen den Reiter ganz rechts <tt>Filter</tt> auswählen.

 
[[Bild:Sieve-02-mailuebersicht.png|center|none|frame|Ungefilterter Posteingang]]
Für die folgenden Beispiele wird davon ausgegangen, daß der Nutzer in seinem Posteingang ohne Filter die Situation, wie im Bild oben angezeigt vorfindet: Viele Emails aus (drei) Mailinglisten und eine private Email. Alle Mails sind in einem Ordner und erschweren das Finden der ggf. wichtigen privaten Email.

[[Bild:Sieve-03-neuer-filter.png|miniatur|250px|right|Neuen Filter anlegen]]
Zunächst soll ein neuer Filter angelegt werden, der die Emails der Mailingliste <tt>otrs-de</tt> [http://doc.otrs.org/2.2/de/html/additional-resources-mailinglists.html] in einen eigenen Ordner verschiebt.

Hierzu unter der (leeren) Filterliste auf das <tt>+</tt> zum Anlegen eines Neuen Filters klicken.
 
[[Bild:Sieve-04-OTRS-filter.png|miniatur|600px|right|Anlegen eines Filters für eine Mailingliste]]
Im neu geöffneten Formular kann der neue Filter definiert werden.

* '''Filternamen''' vergeben: zum Beispiel OTRS für die entsprechende Maillingliste (oder zur besseren späteren Erinnerung: "Mailingliste otrs-de"). OTRS
* '''Filterregel''': Hier wird definiert unter welchen Bedingungen der Filter angewandt werden soll. Drei Optionen stehen zur Auswahl
** Irgendeine Bedingung muß erfüllt sein (ODER)
** Alle Bedingungen müssen erfüllt sein (UND) Auswählen
** Die Bedingung ist für alle Emails gültig (keine Bedingung notwendig)
* Die Definition der Filterregel beinhaltet das Auswahl eines Teils der Nachricht (z.B. Absender, Datum, Betreff, Text) und einem Wert, mit dem verglichen werden soll. In unserem Beispiel: BETREFF enthält <nowiki>[otrs-de]</nowiki>
* '''Filteraktion''': Die Aktion, die ausgeführt werden soll. Verschiebe Nachricht nach OTRS 
Bei Aktionen, die Nachrichten in andere Ordner verschieben oder kopieren werden die möglichen Ordner die zum Zeitpunkt der Filteranlage existieren in einem Drop-Down-Menu angezeigt.
* '''Speichern'''

[[Bild:Sieve-05-hostsharing-filter.png|miniatur|600px|right|Filter für Mailingliste über Mail-Header und Ausnahme]]
=== Weitere Beispiele ===

==== Maillinglisten Filter ====

Im Beispiel rechts werden wieder die Emails einer Mailinglliste gefiltert. Hier handelt es sich um die <tt>Technik</tt>-Liste von Hostsharing.

Der Filter erhält folgende Kriterien:
* '''Filterregel''': Der Filter wird '''nicht''' angewandt, wenn der Text der Nachricht das Wort "Festplattencrash" enthält, der Empfänger, solche Emails also in seinem Posteingang behalten möchte. Darüber hinaus wird die Mailingliste identifiziert über den Mail-Header <tt>List-Id</tt>. Solche zusätzlichen Mail-Header können über die Auswahl "Anderer Header" ausgewählt werden. Beide Bedingungen müssen erfüllt sein (UND), also "trifft alle folgenden Regeln" auswählen.
* '''Filteraktion''': Wie im ersten Beispiele wieder das Verschieben in einen Ordner, hier <tt>hostsharing</tt>.

 
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|600px|right|Abwesenheitsmeldung]]
==== Abwesenheitsmeldung ====

Nutzer möchten oft bei längerer Abwesenheit dem Absender einer Email mitteilen, daß sie die empfangene Email z.B. wegen Urlaubs nicht lesen können. Hierzu kann eine Abwesenheitsmeldung definiert werden, die automatisch eine Antwort-Email generiert mit einem vordefinierten Text.

Im Beispiel sollen die Absender "peter.lustig" und "Wickie" keine Abwesenheitsmeldung erhalten, sowie bei Emails, die das Wort "Werbung" im Betreff enthalten auch keine Abwesenheitsmeldung verschickt werden.
* "Absender enthält nicht 'peter.lustig'" - Ein Vergleich mit der Email-''Adresse'' wird durchgeführt. Peter <peter.lustig@example.org> - Hier ist peter.lustig in der Adresse enthalten Peter.Lustig <peter@example.org> - Hier ist peter.lustig ''nicht'' in der ''Adresse'' enthalten.
* "Anderer Header "From" enthält nicht 'Wickie'" - Ein Vergleich mit der ''kompletten Absender-Angabe'' wird durchgeführt ''Susanne <wickie@example.org>'' aber auch ''Wickie <susanne@example.org>'' werden gefunden
* "Betreff enthält nicht 'Werbung' - Das Wort Werbung darf nicht im Betreff enthalten sein.

In den '''Filteraktionen''' wird die Aktion "Abwesenheitsmeldung" ausgewählt.
* '''Absender''': Hat man mehrere Identitäten in Webmail angelegt, kann man hier aussuchen unter welchem Absender die Abwesenheitsmeldung geschickt werden soll.
* '''Alias''': Es können die Identitäten ausgewählt werden, für die eine Abwesenheitsmeldung verschickt wird. Empfängt man Mails auch auf weiteren Email-Adressen erhalten diese keine Abwesenheitsmeldung.
* '''Zeitraum''': Sagt aus, nach wieviel Tagen ein Absender eine erneute Abwesenheitsmeldung erhält. Im Beispiel also z.B. nur einmal alle 3 Tage. Wenn der Absender dazwischen neue Emails versendet, erhält er keine neue Abwesenheitsmeldung. Nach 3 Tagen wird bei erneuten Emails wieder eine Abwesenheitsmeldung verschickt. Hierz speichert sich <tt>deliver</tt> eine Liste der Empfänger.
* '''Betreff''': Der Betreff der Abwesenheitsmeldung, z.B. "Abwesenheit - Urlaub"; der originale Betreff der Email kann zur Identifizierung angehängt werden. Wird also automatisch auf eine Mail "Geburtstagseinladung" geantwortet, wäre der Betreff der Abwesenheitsmeldung "Abwesenheit - Urlaub Geburtstagseinladung".
* '''Nachricht''': Der eigentliche Text der Abwesenheitsmeldung, z.B. Dauer der Abwesenheitsmeldung, Vertretungsregelung, Erreichbarkeit.

[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|left|TEXT]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|TEXT]]
===== Reihenfolge von Filtern =====

Insbesondere bei Abwesenheitsmeldungen ist die Reihenfolge der Filter wichtig. Im Beispiel links wird der Filter "osm" erst nach der Abwesenheitsmeldung angewandt, Mails, die durch diesen Filter nicht schon wegsortiert wurden, erhalten also eine Abwesenheitsmeldung. Wenn dies unerwünscht ist, muß der Filter '''vor''' den Filter der Abwesenheitsmeldung verschoben werden (über die Pfeile rechts neben des Filterliste).

 
In (u.a.) folgenden Fällen werden '''Abwesenheitsmeldungen vom System nicht verschickt''':
* Die Absenderadresse deutet auf eine Mailingliste hin, z.B. beginnt mit: ''mailer-daemon'', ''listserv'', ''majordomo'', ''owner-'' oder enthält ''-request''
* Es existiert ein Header "Precedence" der ''junk'', ''bulk'' oder ''list'' enthält.
* Der Empfänger der Nachricht steht nicht in ''To'' oder ''Cc''.
* Sender und Empfänger haben dieselbe Email-Adresse.

=== Technisches ===

[[Bild:Sieve-08-kopiesenden.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|300px|right|TEXT]]

Das Plugin <tt>sieverules</tt> kann unter [http://www.tehinterweb.co.uk/roundcube/#pisieverules] heruntergeladen werden.

Datei:Sieve-06-abwesenheitsmeldung-filter.png

2011-11-16T06:14:05Z

Dfr00-hs.wiki: hat eine neue Version von „Datei:Sieve-06-abwesenheitsmeldung-filter.png“ hochgeladen: Mit Einstellung des Absenders

Roundcube Sieve-Plugin Abwesenheitsmeldung

Roundcube - Filter

2011-11-15T22:34:19Z

Dfr00-hs.wiki: Schreibfehler

Roundcube - Filter

2011-11-15T22:33:39Z

Dfr00-hs.wiki: Abwesenheitsmeldung

Datei:Sieve-06-abwesenheitsmeldung-filter.png

2011-11-15T22:10:32Z

Dfr00-hs.wiki: hat eine neue Version von „Datei:Sieve-06-abwesenheitsmeldung-filter.png“ hochgeladen: Nochmal Fehler ...

Roundcube Sieve-Plugin Abwesenheitsmeldung

Datei:Sieve-06-abwesenheitsmeldung-filter.png

2011-11-15T22:01:17Z

Dfr00-hs.wiki: hat eine neue Version von „Datei:Sieve-06-abwesenheitsmeldung-filter.png“ hochgeladen: Fehler in Filterdefinition

Roundcube Sieve-Plugin Abwesenheitsmeldung

Roundcube - Filter

2011-11-15T21:58:38Z

Dfr00-hs.wiki: Weiteres Mailinglisten-Beispiel

Roundcube - Filter

2011-11-15T21:49:09Z

Dfr00-hs.wiki: Einleitung und erstes Beispiel

Roundcube - Filter

2011-11-15T19:00:33Z

Dfr00-hs.wiki: Bilder hochgeladen und Referenzen in Datei eingefügt

{{Baustelle}}
'''/** TODO - Seitentext schreiben **/'''

== Roundcube - Filter ==

=== Allgemeines zu Filtern ===

=== Oberfläche ===

=== Beispiele ===

=== Technisches ===

[[Bild:Sieve-01-einstellungen.png|miniatur|300px|right|Einstellungen]]
[[Bild:Sieve-02-mailuebersicht.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-03-neuer-filter.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-04-OTRS-filter.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-05-hostsharing-filter.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-06-abwesenheitsmeldung-filter.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-07-reihenfolge-a.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-07-reihenfolge-b.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-08-kopiesenden.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-09-filter-abschalten-a.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-09-filter-abschalten-b.png|miniatur|300px|right|TEXT]]
[[Bild:Sieve-10-nach-anwendung-filter.png|miniatur|300px|right|TEXT]]

Datei:Sieve-10-nach-anwendung-filter.png

2011-11-15T18:50:08Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Posteingang nach Filteranwendung

Roundcube Sieve-Plugin Posteingang nach Filteranwendung

Datei:Sieve-09-filter-abschalten-b.png

2011-11-15T18:49:49Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filter abschalten 2

Roundcube Sieve-Plugin Filter abschalten 2

Datei:Sieve-09-filter-abschalten-a.png

2011-11-15T18:49:32Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filter Abschalten 1

Roundcube Sieve-Plugin Filter Abschalten 1

Datei:Sieve-08-kopiesenden.png

2011-11-15T18:49:09Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filter mit Match auf lokalem Teil Email und Kopie versenden

Roundcube Sieve-Plugin Filter mit Match auf lokalem Teil Email und Kopie versenden

Datei:Sieve-07-reihenfolge-b.png

2011-11-15T18:48:28Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filterreihenfolge 2

Roundcube Sieve-Plugin Filterreihenfolge 2

Datei:Sieve-07-reihenfolge-a.png

2011-11-15T18:48:08Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filterreihenfolge 1

Roundcube Sieve-Plugin Filterreihenfolge 1

Datei:Sieve-06-abwesenheitsmeldung-filter.png

2011-11-15T18:47:44Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Abwesenheitsmeldung

Roundcube Sieve-Plugin Abwesenheitsmeldung

Datei:Sieve-05-hostsharing-filter.png

2011-11-15T18:47:18Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Filter mit Sonder-Header (hier: List-Id)

Roundcube Sieve-Plugin Filter mit Sonder-Header (hier: List-Id)

Datei:Sieve-04-OTRS-filter.png

2011-11-15T18:46:45Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Einfacher Filter über Betreff

Roundcube Sieve-Plugin Einfacher Filter über Betreff

Datei:Sieve-03-neuer-filter.png

2011-11-15T18:46:01Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Neuen Filter anlegen

Roundcube Sieve-Plugin Neuen Filter anlegen

Datei:Sieve-02-mailuebersicht.png

2011-11-15T18:45:42Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Posteingang vor Filterung

Roundcube Sieve-Plugin Posteingang vor Filterung

Datei:Sieve-01-einstellungen.png

2011-11-15T18:44:58Z

Dfr00-hs.wiki: Roundcube Sieve-Plugin Einstellungen

Roundcube Sieve-Plugin Einstellungen

Roundcube - Filter

2011-11-13T07:01:35Z

Dfr00-hs.wiki: Struktur anlegen

== Roundcube - Filter ==

=== Allgemeines zu Filtern ===

=== Oberfläche ===

=== Beispiele ===

=== Technisches ===

Roundcube

2011-11-13T06:58:12Z

Dfr00-hs.wiki: Linke auf Roundcube-Filter

Für alle Hostsharing-Mitglieder und ihre Kunden gibt es eine zentrale Webmail-Installation, die unter https://webmail.hostsharing.net erreichbar ist.

Diese Dokumentation beschreibt lediglich die wichtigsten Funktionen zum Einstieg. Weitere allgemeine Dokumentation gibt es im Wiki des Roundcube-Projekts [http://trac.roundcube.net/wiki]

== Einrichten - Der erste Aufruf ==
[[Bild:Roundcube-031-login.png‎|miniatur|200px|right|Screenshot Webmail Einloggen]]

Dieser Abschnitt behandelt das erstmalige Einloggen eines neuen Nutzers. Hatte dieser Nutzer bereits vorher die alte Webmail-Installation [[IlohaMail]] benutzt, sind die Grundeinstellungen bereits übernommen.

Auf dem Startbildschirm erscheinen Eingabefelder für Benutzernamen und Passwort. Beides Eingeben und 'Anmelden' klicken oder Return-Taste drücken.

'''Beispiel'''

Benutzer: xyz00-otto
Passwort: ganzgeheimespasswort

=== Maildir anlegen für neu angelegten Nutzer ===
Frisch angelegte Nutzer können sich nur einloggen, wenn in ihrem Account bereits der IMAP-Account durch Anlage des Verzeichnisses ~/Maildir erfolgt ist. Andernfalls findet das System keinen gültigen IMAP-Email-Account. Die Fehlermeldung "Keine Verbindung zum IMAP-Server" erscheint:

[[Bild:Roundcube-errormessage-noconnection.png‎|none]]

Diese Initialisierung kann wahlweise erfolgen durch

# Versand einer Email von anderem Mail-Account an den neu erstellten Account (hierzu eine Email-Adresse mit dem Account verknüpfen)
# Einloggen über die Shell in den Account des neuen Nutzers und dort Aufruf von

maildirmake ~/Maildir

=== Angabe von Namen und Email-Adresse ===

[[Bild:Roundcube-firstlogin-userinfo1.png‎|right|300px|miniatur|Aufforderung Eingabe Name/Email-Adresse]]

Beim erstmaligen Einloggen in Roundcube müssen im Webmail-System der Name des Nutzers und seine Email-Adresse hinterlegt werden. Dazu erscheint beim Einloggen ein Fenster, das zur Eingabe dieser Informationen auffordert.

Die eingegebenen Daten werden beim Versand von Emails als Absendername und Absender-Email-Adresse benutzt. Dies hat keinen Einfluß auf den ''Empfang'' von Emails. Weitere Namen/Adressen zum Versenden können als [[#Identit.C3.A4ten|Identitäten]] angelegt werden.

[[Bild:Roundcube-firstlogin-userinfo2.png‎|right|300px|miniatur|Angabe von Namen und Email-Adresse]]

'''Beispiel für Default-Werte'''

Name: xyz00-otto
Email-Adresse: xyz-otto@h01.hostsharing.net

'''Eingabe der nutzerspezifischen Angaben '''

Name: Otto Musterer
Email-Adresse: otto@example.org

=== Spezialordner ===
[[Bild:Roundcube-special-folders.png‎|right|Ordnerliste]]

Roundcube zeigt die Ordner für Posteingang, Entwürfe, Gesendete Emails, Papierkorb und Spam gesondert am Anfang der Ordnerliste an. Dabei ist die Bezeichnung des Ordners analog der eingestellten Sprache unabhängig vom echten Namen der Ordner.

Die folgende Tabelle zeigt die Funktion der Ordner, ihren deutschen Namen in der Ordnerliste und den Default-Wert für den echten Ordnernamen.

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Text
!Beschreibung
!Ordnername
!Automatisch erstellt
|-
|Posteingang
|Posteingang
|INBOX
| align="center" | X
|-
|Gesendet
|Gesendete Emails
|INBOX.Sent
| align="center" | X
|-
|Entwürfe
|noch nicht versandte Emails im Entwurfsstadium
|INBOX.Drafts
| align="center" | X
|-
|Gelöscht
|Papierkorb - Emails, die zum Löschen in den Papierkorb verschoben wurden
|INBOX.Trash
| align="center" | X
|-
|Spam
|Emails, die als Spam markiert und verschoben wurden
|INBOX.Junk
|  
|}
[[Bild:Roundcube-special-folders-settings.png‎|right|300px|miniatur|Setzen der Spezialordner]]

Sind die Ordner beim ersten Einloggen schon vorhanden, werden sie automatisch mit ihrer Spezialfunktion verknüpft. Sind sie noch nicht vorhanden, werden sie automatisch durch Roundcube erstellt.

Hat man andere Ordnernamen für die Spezialordner, wie z.B. <tt>INBOX.Gesendet</tt> oder <tt>INBOX.sent-mail</tt> für gesendete Email kann die Zuordnung zu den Spezialordnern unter Einstellungen → Spezialordner geändert werden.

Siehe Beispiel rechts: Für die gesendeten Emails wird der Ordner <tt>INBOX.versendet</tt> benutzt. Ein Ordner für Spams ist im Beispiel nicht verknüpft, die anderen Ordner haben ihre Standardwerte. Der Ordner für den Posteingang kann nicht verändert werden.

Für Weiteres zu Ordnern siehe den entsprechenden Abschnitt
'[[#Ordner|Ordner]]'.

== Grundsätzliche Email-Funktionen ==
Nach dem Einloggen erscheint im Hauptfenster eine Liste der Emails im Posteingang. Eine kurze Erklärung der einzelnen Funktionen ist in der Tabelle unterhalb des Screenshots zu sehen.

[[Bild:Roundcube-mainscreen.png|none|700px|miniatur]]

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Feld
!Kurztext
!Beschreibung
|-
| align="center" | A
|Ordnerliste
|Liste der abonnierten Ordner. [[#Spezialordner|Spezialordner]] werden oben gezeigt. Ordner mit ungelesenen Mails erscheinen '''fett''' mit der Anzahl der ungelsenen Mails dahinter. Siehe separaten Abschnitt wie weitere [[#Ordner abonnieren|Ordner abonniert]] werden können.
|-
| align="center" | B
|Email-Liste Sortierungsleiste
|Standardmäßig werden Emails absteigend nach Eingangsdatum sortiert. Durch Klicken auf 'Betreff', 'Absender', 'Datum' oder 'Größe' kann nach diesen sortiert werden und durch nochmaliges Klicken die Sortierreihenfolge geändert werden.

Es ist derzeit nicht möglich die angezeigten Spalten zu verändern oder zu verschieben. Auch ist eine Thread-Darstellung nicht möglich. Beides wird ggf. mit späteren Versionen von Roundcube implementiert.
|-
| align="center" | C
|Emails Listenansicht
|Wichtigste Infos zu Emails wie Absender, Subject, Datum. Ungelesene Emails sind '''fett''' dargestellt und sind am Anfang der Zeile durch einen blauen Stern markiert. Durch anklicken einer Email erscheint diese im Vorschaufenster
|-
| align="center" | D
|Vorschaufenster
|Im unteren Teil des Bildschirms werden ausgewählte Emails angezeigt. Innerhalb des Fensters kann gescrollt werden. Auch bei Text-Emails werden rudimentäre Formatierungen angezeigt, wie beispielsweise farbiges Hervorheben von Zitierungen
|-
| align="center" | E
|Email-Header
|Anzeige der wichtigsten Email-Header. Zusätzliche Header können angezeigt werden, in dem auf den Pfeil am unteren Ende der Header geklickt wird. Durch Klicken auf die Figur neben Namen/Email-Adresse, kann diese in das Adressbuch übernommen werden.
|-
| align="center" | F
|Neues Fenster
|Öffnen der Email in einem neuen Fenster
|-
| align="center" | G
|Seitenauswahl
|Standardmäßig werden bis zu 40 Emails in der Übersicht je Seite angezeigt. In diesem Bereich kann durch die Seiten gescrollt werden. Die maximale Anzahl der Emails in der Listenansicht kann über die Einstellungen verändert werden, ist systemseitig allerdings auf 80 beschränkt.
|-
| align="center" | H
| Email-Auswahl
|Buttons zur Auwahl von Emails in der Listenansicht. Von links nach rechts: a) alle Auswählen b) ungelesene Mails auswählen c) Auswahl invertieren d) keine Mails auswählen.

Diese Auswahl kann dann auf andere Funktionen (wie z.B. Löschen) angewandt werden.
|-
|-
| align="center" | a
|Auf neue Nachrichten überprüfen
|Ausgewählter Ordner wird neu gelesen
|-
| align="center" | b
|Neue Nachricht schreiben
|
|-
| align="center" | c
|Antwort verfassen
|Nur an Sender antworten
|-
| align="center" | d
|Antwort an Versender und alle Empfänger verfassen
|
|-
| align="center" | e
|Nachricht weiterleiten
|Original-Nachricht wird in der neuen Email als Text eingefügt. Anhänge der Original-Nachricht werden als Anhang weitergeleitet.
|-
| align="center" | f
|Als Anhang weiterleiten
|Original-Nachricht wird als Anhang weitergeleitet
|-
| align="center" | g
|Nachricht in den Papierkorb verschieben
|Nachricht wird zunächst nicht gelöscht sondern nur verschoben. Je nach Einstellung wird der Papierkorb beim Ausloggen geleert oder bleibt erhalten (Default: kein Löschen)
|-
| align="center" | h
|Mark as Junk
|Email wird in den Spam-Ordner verschoben, sofern ein solcher in den Einstellungen als Spezialornder markiert wurde. Andernfalls keine Funktion.
|-
| align="center" | i
|Nachrichten markieren
|Ausgewählte Nachrichten können als gelesen/ungelesen markiert werden, oder zur Hervorhebung mit einem Stern markiert werden.
|-
| align="center" | j
|Weiter Aktionen...
|Ausgewählte Nachricht drucken, speichern, Quelltext anzeigen, in neuem Fenster öffnen.
|-
| align="center" | k
|Filter
|Im Textfeld kann eine Zeichenkette eingegeben werden nach der im Subject gesucht wird. Nur diese Emails werden in der Liste angezeigt. Über die Drop-Down-Box links vom Textfeld kann die Suche eingeschränkt werden auf alle / ungelesene / unbeantwortete / markierte / gelöschte Emails. (Gelöschte nur, sofern diese nicht im Papierkorb sind, sondern mit dem IMAP-Status gelöscht versehen werden. Diese werden aber standardmäßig nicht angezeigt.)
|-
|}

== Einstellungen ==

Jeder Nutzer kann gewisse Einstellungen vornehmen, die das Aussehen oder Verhalten von Roundcube verändern:

Einstellungen, die auf der linken Seite des Einstellungsmenu zu erreichen sind:

* Benutzeroberfläche: Sprache, Datumsanzeige, Zeitzone, Listenansicht
* Mailbox-Ansicht: Nachrichtenvorschau, Lesebestätigung, Prüfen auf neue Nachrichten, ...
* Nachrichtenerstellung: HTML-Nachrichten verfassen, Speichern von Entwürfen, ...
* Nachrichtendarstellung: Anzeige von HTML und externen Bildern festlegen, ...
* Spezialordner: Zuordnung von Ordnernamen zu Spezialordnern, siehe [[#Spezialordner|Spezialordner]]
* Server-Einstellungen: Löschverhalten
* Konto-Einstellungen: (keine Einstellungen)

Einstellungen über separate Reiter:

* Ordner: siehe gesonderte Dokumentation im Abschnitt [[#Ordner|Ordner]]
* Identitäten: siehe gesonderte Dokumentation im Abschnitt [[#Identit.C3.A4ten|Identitäten]]

[[Bild:Roundcube-addressbook.png‎|right|miniatur|350px|Adressbuchansicht]]
== Kontakte - Adressbuch ==

Das Adressbuch kann lediglich folgende Felder Speichern

* Angezeigter Name: Freitext, kann aus Vor- und Nachnamen bestehen, aber auch andere Angaben wie Firma. Dieser Text erscheint in der Liste der Adressbuch-Einträge.
* Vorname
* Nachname
* Email-Adresse.

[[Bild:Roundcube-compose-selectaddress.png‎|right|miniatur|350px|Erstellen von Mails: Auswahl aus Adressbuch]]
Beim Verfassen von Emails wird bei der Eingabe von Adressen in den Feldern 'An' und 'Kopie' das Adressbuch nach Einträgen durchsucht, die die getippten Buchstaben enthalten. Beim Tippen von 'ing' wird gefunden: 'Ingo' aber auch 'Hostsharing'.

 
Beim Empfang von Emails können VCards des Senders in das Adressbuch übernommen werden, allerdings gibt es noch keine Funktion in Roundcube um diese auszulesen oder zu benutzen.

 
== Identitäten ==

Jeder Nutzer kann die Absenderangaben von zu versendenden Emails mit verschiedenen Identitäten variabel gestalten, z.B.:

[[Bild:Roundcube-identities-newmail.png‎|right]]
* verschiedene Absendernamen für die einzelnen Familienmitglieder
* verschiedene Email-Adressen, die dem selben Account zugeordnet sind (Privat/Büro)
* verschiedene Signaturen
* ....

Die Identitäten können beim Schreiben von neuen Emails über ein Drop-Down-Menü ausgewählt werden (siehe nebenstehendes Bild). Bei der Beantwortung von Emails versucht Roundcube die am besten passende Identität anhand des ursprünglichen Empfängernamens herauszufinden.

 
[[Bild:Roundcube-identities-list.png‎|right]]
Unter Einstellungen → Identitäten (Reiter) wird im linken Teil eine Liste der erstellten Identitäten angezeigt, die sich per Klick zum Verändern auswählen lassen.

 
[[Bild:Roundcube-identities-edit-text.png‎|right]]
Je Identität können angegeben werden:

* Der angezeigte Name
* Die Email-Adresse des Absenders
* Das Feld Organisation (wird wenig benutzt)
* Eine Adresse, an die geantwortet werden soll, sofern verschieden von der Absender-Email-Adresse
* Eine Email-Adresse an die standardmäßig beim Versand eine Blindkopie (Bcc) mitverschickt wird.
* Eine Signatur, die automatisch angehängt wird. Bei Emails im Textformat wird der Signaturtrenner <tt>--</tt> automatisch von Roundcube eingefügt.
* Eine Angabe, ob die Signatur in HTML verfasst werden soll (siehe Beipiel unten)
* Ein Häkchen, das festsetzt, ob diese Signatur die Standardsignatur ist und bei neuen Emails benutzt wird (sofern keine andere vom Nutzer ausgewählt wird.)

[[Bild:Roundcube-identities-edit-html.png‎|left|miniatur|350px|HTML-Signatur]]
 
== Ordner ==

[[Bild:Roundcube-folders.png‎|right]]

Roundcube zeigt in der Ordnerliste nur die abonnierten Ordner an. In diesem Menu kann ausgewählt werden, welche Ordner abonniert werden sollen. Auch können neue Ordner angelegt oder vorhandene gelöscht werden. Die Abonnements, die durch andere Email-Programme (z.B. Thunderbird) vorgenommen wurden, werden automatisch berücksichtigt, wenn das Email-Programm, diese auf dem Email-Server ablegt.

{| border="1" cellpadding="4" cellspacing="0"
|+ align="bottom" style="color:#e76700;"|
|-
!Feld
!Kurztext
!Beschreibung
|-
| align="center" | A
|Spezialordner
|Spezialordner können nicht aus dem Abo genommen werden oder gelöscht werden, solange sie als Spezialordner zugewiesen sind. (siehe [[#Spezialordner|Spezialordner].
|-
| align="center" | B
|Normale Ordner
|Es werden alle weiteren Ordner für dieses Email-Konto angezeigt. Diese können abonniert, umbenannt oder gelöscht werden. Außerdem wird für jeden Ordner die Zahl der enthaltenen Emails angezeigt.
|-
| align="center" | C
|Abonnement
|Durch Setzen eines Hakens wird der Ordner für künftige Benutzung abonniert.
|-
| align="center" | D
|Umbenennen/Löschen
|Ausgewählte Ordner können gelöscht oder umbenannt werden.
|-
|}

==== Anlegen neuer Ordner ====
Am unteren Ende des Ordnerfensters können über ein Textfeld neue Ordner angelegt werden. Diese werden automatisch abonniert.

== Nutzung weiterer Features ==

Die Dokumentation zu weiteren ggf. weniger häufig benutzten Funktionen sind auf separaten Wiki-Seiten dokumentiert:

* [[Roundcube - Filter|Filter]]: Automatisches Filtern von E-Mails mit Managesieve, z.B. Verschieben in andere Ordner, Abwesenheitsmeldung etc.
* [[Roundcube - Threads|Thread-Anzeige]]: Gruppieren von Emails nach Themen
* [[Roundcube - Adressgruppen|Adressgruppen]]: Erstellen von Verteilerlisten im Adressbuch
* [[Roundcube - Emailhervorhebung|Hervorhebung von Emails]]: Markieren von Emails durch Farben abhängig vom Versender, Subject, etc.

== Sicherheit und Datenschutz ==

Zugriff auf das Webmail-Programm erfolgt ausschließlich SSL-verschlüsselt über <tt><nowiki>https://</nowiki></tt>.

Nutzerdaten wie Kontakte oder Identitäten werden in einer PostgreSQL-Datenbank abgespeichert. Das Passwort des Users wird temporär verschlüsselt zwischengespeichert. Außerdem werden von den Emails in den Ordner die Kopfzeilen - Absender, Empfänger, Thema, Datum, ... - für die schnellere Bearbeitung zwischengespeichert. Passwort und Kopfzeilen werden nach dem Ausloggen gelöscht.

Auf die Datenbank können nur Hostmaster und Maintainer zugreifen, die jeweils eine Datenschutzerklärung unterschrieben haben müssen.

== Weiteres ==

Die für den Webmailer benutzte Software ist [http://roundcube.net Roundcube]

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]
[[Kategorie:Glossar]]

DAViCal installieren

2011-04-17T12:00:22Z

Dfr00-hs.wiki: Client-Konfiguration

{{HSDoku-Links}}

== Allgemein ==
=== Beschreibung ===
[http://www.davical.org/ DAViCal] ist ein Server für die Verwaltung von Kalendern über das [http://caldav.calconnect.org/ CalDAV-Protokoll]. Die Kalenderdaten können mit allen CalDAV-fähigen CLient-Programmen gelesen und geschrieben werden, z.B. Thunderbird mit [http://www.mozilla.org/projects/calendar/lightning/ Lightning], Evolution, Mulberry oder iCal / iPhone.

Das CalDAV-Protokoll wird im Wesentlichen breiter unterstützt, als es die Clients bisher unterstützen. Serien, Erinnerungen, Einladungen, Ressourcen, Arbeitsgruppen etc. sind alle Bestandteil der Features.

Die Software ist in PHP geschrieben, lizensiert unter GPL.

Es werden auch Kalender über das WebDAV-Protokoll untersützt, hier wird aber eine Nur-Lesemodus empfohlen.

=== Voraussetzungen ===

DAViCal setzt technisch voraus:
* PostgreSQL
* Webserver mit PHP5
* Perl für den Installationsvorgang

Die Installations-Anleitung auf der Projekt-Homepage geht davon aus, daß mal als Administrator auf den Server zugreifen kann. Die Anleitung hier beschreibt, wie man konkret DAViCal in der Shared Hosting Umgebung bei Hostsharing installiert und betreibt.

== Installation ==

=== Design ===

Diese Installationsanleitung beschreibt, wie DAViCal in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. Installation in einer Subdomain im <tt>sub</tt>-Verzeichnis müssen kleine Anpassungen vorgenommen werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von den übrigen Domaininhalten isoliert werden kann, z.B. php-Konfiguration oder auch anderen Domain-Admin.

=== Subdomain aufschalten ===

Wie in [[Verwalten_der_Zonendaten]] beschrieben das Zonefile der Domain anpassen um die Subdomain explizit den DNS-Servern zu delegieren und dann über [[Hsadmin]] die Subdomain anzulegen und einem Domain-Admin zuzuordnen.

Für diese Anleitung werden folgende Daten als Konvention angenommen

{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| (Sub)-Domain || <tt>cal.example.org</tt> || Die Sub-Domain unter der der DAViCal-Server betrieben wird
|-
| Domain-Admin || <tt>xyz00-hans</tt> || Der User, dem die Sub-Domain delegiert wurde
|}

=== Quellen ===

Für DAViCal werden neben dem eigentlichen Sourcecode des Projekts noch die PHP-Library [http://andrew.mcmillan.net.nz/projects/awl ''Andrew's Web Libraries''] benötigt. Beides findet sich auf derselben Webseite.

Die jeweils neuste Versionen befinden sich unter
* DAViCal: http://debian.mcmillan.net.nz/packages/davical/
* AWL: http://debian.mcmillan.net.nz/packages/awl/

Hier jeweils die Source-Dateien *.tar.gz benutzen

==== Download ====

<pre><nowiki>
$ cd /home/doms/cal.example.org/var
$ wget http://debian.mcmillan.net.nz/packages/awl/awl-0.46.tar.gz
$ wget http://debian.mcmillan.net.nz/packages/davical/davical-0.9.9.4.tar.gz
</nowiki></pre>

==== Auspacken ====
Um die Dateien für den Betrieb in der Serverumgebung lesbar zu machen wird die Dateierzeungsmaske temporär auf 022 gesetzt.

Symbolische Links erzeugen generische Verzeichnise <tt>davical</tt> und <tt>awl</tt>, die auf die jeweils installierte Version zeigen. Dies erleichtert spätere Versionswechsel.
<pre><nowiki>
$ umask 022
$ tar xfvz awl-0.46.tar.gz
$ tar xfvz davical-0.9.9.4.tar.gz
$ ln -s awl-0.46 awl
$ ln -s davical-0.9.9.4 davical
$ umask 077
</nowiki></pre>

=== PostgreSQL vorbereiten ===

Es wird eine eigene PostgreSQL-Datenbank benötigt, sowie 2 Datenbanknutzer.

==== Datenbank und -Nutzer anlegen ====
{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| DB-Admin || <tt>xyz00_davical_dba</tt> || Der PostgreSQL-Nutzer, dem die Datenbank gehört und administrative Tätigkeiten durchführt
|-
| DB-Nutzer || <tt>xyz00_davical_app</tt> || Der PostgreSQL-Nutzer, der über DAViCal auf die Datenbank lesen/schreibend zugreift
|-
| Datenbank || <tt>xyz00_davical</tt> || Die Datenbank, die alle Daten für den DAViCal-Server enthält
|}

==== Umgebungsvariablen und <tt>.pgpass</tt> ====
Die Nutzer und die Datenbank können über [[Hsadmin]] angelegt werden. Dabei wird <tt>xyz00_davical_dba</tt> als Datenbank-Besitzer angegeben. Als Zeichensatz <tt>UTF-8</tt> (Default) auswählen.

Sowohl für die weitere Installation, als auch für den Betrieb des Servers ist es am besten die Passwörter in die <tt>[http://www.postgresql.org/docs/9.0/interactive/libpq-pgpass.html .pgpass]</tt>-Datei zu schreiben, dann müssen sie nicht innerhalb der PHP-Dateien angebenen werden, bzw. während der Installation manuell eingegeben werden.

<pre><nowiki>
$ echo "localhost:5432:*:xyz00_davical_dba:geheimes_passwort" >> ~/.pgpass
$ echo "localhost:5432:*:xyz00_davical_app:geheimes_passwort" >> ~/.pgpass
$ chmod 0600 ~/.pgpass
</nowiki></pre>

Darüberhinaus werden noch Umgebungsvariablen gesetzt, so daß beim Aufruf von <tt>psql</tt> über die Kommandozeile Datenbankname/Nutzer nicht eingegeben werden müssen. Diese Angaben sind nach Beenden der Shell-Sitzung automatisch zurückgesetzt.

<pre><nowiki>
$ PGHOST=localhost
$ PGUSER=xyz00_davical_dba
$ PGDATABASE=xyz00_davical
$ export PGHOST PGUSER PGDATABASE
</nowiki></pre>

==== PL/pgSQL installieren ====

In der Datenbank wird die prozedurale Sprache PL/pgSQL benötigt. Diese kann folgendermaßen angelegt werden:

<pre><nowiki>
$ psql -A -c "CREATE LANGUAGE plpgsql;"
</nowiki></pre>

=== Datenbank-Tabellen anlegen und initialisieren ===

DAViCal enthält ein eigenes Installations-Skript, das die PostgreSQL-Tabellen anlegt und initialisiert. Dies liegt unter <tt>davical/dba/create-database.sh</tt>. Hier wird aber davon ausgegegangen, daß man Adminrechte hat, was in der Shared-Hosting-Umgebung nicht der Fall ist.

Das Anlegen der Datenbank, der -Nuter und kreieren von PL/pgSQL wurde bereits oben beschrieben. Darüberhinaus sind noch folgende Befehle auszuführen. Diese können in dieser Form einfach nacheinander ausgeführt werden, wenn wie oben beschrieben die <tt>PG*</tt> Umgebungsvariablen gesetzt wurden und die <tt>.pgpass</tt>-Datei gefüllt wurde.

<pre><nowiki>
$ psql -A -f awl/dba/awl-tables.sql
$ psql -A -f awl/dba/schema-management.sql
$ psql -A -f davical/dba/davical.sql
$ ./davical/dba/update-davical-database –dbhost=${PGHOST} –dbuser=${PGUSER} –dbname=${PGDATABASE} --appuser=${PGDATABASE}_app
The database is version 8.4 currently at revision 1.2.9.
No patches were applied.
Supported locales updated.
Updated view: dav_principal.sql applied.
CalDAV functions updated.
RRULE functions updated.
Database permissions updated.
$ psql -A -f davical/dba/base-data.sql
</nowiki></pre>

Für den DAViCal-Admin muß noch ein Passwort gesetzt werden – '<tt>**</tt>' vor dem Passwort ist hier wichtig.

<pre><nowiki>
$ psql -A -c "UPDATE usr SET password = '**geheim' WHERE user_no = 1;"
</nowiki></pre>

=== Konfiguration ===

DAViCal kann über eine <tt>config.php</tt> konfigriert werden. Eine Beispiel-Datei ist unten abgebildet. Details sind im [http://wiki.davical.org/w/Configuration DAViCal-Wiki] zu finden.

<pre><nowiki>
$ cat > davical/config/config.php
$c->pg_connect[] = "dbname=xyz00_davical user=xyz00_davical_app host=localhost";
$c->use_persistent = true;
$c->sysabbr = 'cal@example.org';
$c->admin_email = 'admin@cal.example.org';
$c->system_name = 'CalDAV Server example.org';
$c->default_locale = 'de_DE';
$c->template_usr = array( 'active' => true,
'locale' => 'de_DE',
'date_format_type' => 'E',
'email_ok' => date('Y-m-d')
);
^D
</nowiki></pre>

=== Fast-CGI Patch ===

Bei der Benutzung von Fast-CGI werden die HTTP_AUTHORIZATION Header normalerweise nicht weitergeleitet. Dieses Problem wird auch im DAViCal-Wiki in einem entsprechenden [http://wiki.davical.org/w/FastCGI FAQ-Eintrag] behandelt, aber dort unter der Annahme gelöst, daß man Adminrechte hat.

In der Shared-Hosting-Umgebung von Hostsharing kann dies auch über ein Redirect in der <tt>.htaccess</tt>-Datei gemacht gelöst werden:

<pre><nowiki>
$ cd /home/doms/cal.example.org/htdocs-ssl
$ cat >> .htaccess
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
^D
</nowiki></pre>

Diese Regel muß die letzte in der <tt>.htaccess</tt> sein. Die Datei muß für alle lesbar sein:

<pre><nowiki>
$ chmod 0644 .htaccess
</nowiki></pre>

Darüberhinaus muß noch die Datei <tt>davical/inc/HTTPAuthSession.php</tt> angepasst werden. Hier ist die Variable <tt>$_SERVER["AUTHORIZATION"]</tt> ersetzt werden durch <tt>$_SERVER["REDIRECT_HTTP_AUTHORIZATION"]</tt>. Außerdem gibt es noch einen Bug: Es wird an einer Stelle <tt>split()</tt> statt <tt>explode</tt> benutzt. <tt>split()</tt> ist seit PHP 5.3.0 ''deprecated''.

@@ -87,8 +87,8 @@
/**
* Get HTTP Auth to work with PHP+FastCGI
*/
- if (isset($_SERVER["AUTHORIZATION"]) && !empty($_SERVER["AUTHORIZATION"])) {
- list ($type, $cred) = split (" ", $_SERVER['AUTHORIZATION']);
+ if (isset($_SERVER["REDIRECT_HTTP_AUTHORIZATION"]) && !empty($_SERVER["REDIRECT_HTTP_AUTHORIZATION"])) {
+ list ($type, $cred) = explode (" ", $_SERVER['REDIRECT_HTTP_AUTHORIZATION']);
if ($type == 'Basic') {
list ($user, $pass) = explode (":", base64_decode($cred));
$_SERVER['PHP_AUTH_USER'] = $user; }

[[Bild:DAViCAl-home.png‎|miniatur|400px|right|Screenshot DAViCal Einloggen]]
=== Webspace aktivieren ===

Schließlich muß die Installation noch mit dem Webspace verknüpft werden.
<pre><nowiki>
$ cd /home/doms/cal.example.org
$ rm htdocs-ssl
$ ln -s var/davical/htdocs htdocs-ssl
</nowiki></pre>

Die URL des User-Interfaces lautet: '''<tt><nowiki>https://cal.example.org</nowiki></tt>'''

Wenn alles richtig gemacht wurde, erscheint der Login-Screen.

== Nutzung ==

=== User anlegen und konfigurieren ===

Im User-Interface muß man sich als Admin (oder Nutzer mit Adminrechten) einloggen um neue Nutzer anzulegen.

Um einen neuen Nutzer anzulegen: '''Menu''' → '''User Functions''' → '''Create Principal'''

{| class="wikitable"
|- class="hintergrundfarbe5"
! Feld !! Wert !! Beschreibung
|-
| Principal ID || ''New Principal'' || Bei neuen Nutzern wird das Feld automatisch beim Anlegen gefüllt
|-
| Username || hans || Nutzername für den Kalender. Der Username ist Bestandteil der Kalender-URL
|-
| Change Password || geheimespasswort ||
|-
| Confirm Password || geheimespasswort ||
|-
| Fullname || Hans Meier || Der Name des Nutzers
|-
| Email Address || hans@example.org || Über die Email-Adresse ist der Nutzer für andere Nutzer im System zu finden, z.B. für Einladungen
|-
| Locale || Deutsch ||
|-
| Date Format Style || European ||
|-
| Principal Type || Person || Üblicherweise Person für einen natürlichen Nutzer (hier können auch Ressourcen und Gruppen angelegt werden)
|-
| Administrator || – || Falls der User Adminrechte bekommen soll
|-
| Active || X || Soll der Nutzer aktiv geführt werden?
|}

Beim Anlegen des '''ersten''' Nutzers erscheint eine Fehlermeldung:

ERROR: SQL error "23505" - ERROR: duplicate key value violates unique constraint "principal_pkey""
Home calendar added. 

Dies ist ein Bug. Siehe auch [http://lists.morphoss.com/pipermail/davical-dev/2011/000117.html Thread in Dev-Mailingliste].

Zum Umgehen des Bugs einfach den Nutzer nochmal anlegen und dann funktioniert alles ;-)

=== Zugriff über Client-Programme ===

Der Zugriff auf den Kalender erfolgt über die URL: '''<tt><nowiki>https://cal.example.org/caldav.php/user/home</nowiki></tt>'''

* user = Name des angelegte Nutzers, also z.B. '''<tt>hans</tt>'''
* home = Name des angelegten Kalenders; dies ist standardmäßig '''<tt>home</tt>'''. Andere Kalender (''collection'') können im User-Interface vom Nutzer angelegt werden, oder durch einen Client, der MKCALENDAR implementiert hat, so z.B. iCal oder Mulberry

==== Beispiel Thunderbird ====

Ist in Thunderbird die Lightning-Erweiterung installiert, dann kann der Kalender folgendermaßen eingerichtet werden:

'''Menu''' → '''Datei''' → '''Neu''' → '''Kalender'''

Auf den Folgenden Seiten ist auszuwählen:
* ''Im Netzwerk''
* ''CalDAV''
* Spezifische Angaben
** Name, z.B. ''hans@example''
** Farbe: auswählen in welcher Farbe der Kalender angezeigt werden soll
** Alarm: ja
** Email: Email auswählen

Zusätzlich wird es wahrscheinlich noch eine Wahrnung geben, daß das SSL-Zertifikat ungültig ist, da in der Standard Hostsharing Konfiguration das hostsharing-Zertifikat ausgeliefert wird. Dieses muß dann noch importiert und akzeptiert werden.

Thunderbird fragt dann noch nach Nuternamen und Passwort und wenn man erlaubt diese im Programm zu speichern, dann loggt sich Thunderbird zukünfitg selbständig ein.

===== Mehrere Kalender auf gleichem Server =====

Hat man mehrere Kalender auf dem gleichen Server – also z.B. mehrere User oder für einen User mehrere ''collections'', dann kann Thunderbird diese nicht unterscheiden. Der Passwort-Manager arbeitet auf Grundlage der Domain. Siehe auch [https://bugzilla.mozilla.org/show_bug.cgi?id=247486 Bugzilla].

Diesen Bug kann man relativ einfach umgehen, indem man weitere Subdomains anlegt, die auf die gleiche Installation verweisen, also z.B.

<pre><nowiki>
$ cd /home/doms/example.org/subs-ssl
$ mkdir cal1
$ mkdir cal2
</nowiki></pre>

und jeweils eine <tt>.htaccess</tt> in die neuen Verzeichnis mit folgendem Inhalt schreibt:

<pre><nowiki>
RewriteEngine on
RewriteRule ^.htaccess$ - [F]
RewriteRule ^(.*)$ https://cal.example.org/$1 [P]
</nowiki></pre>

Nicht vergessen:

<pre><nowiki>
chmod 0644 cal1/.htaccess
chmod 0644 cal2/.htaccess
</nowiki></pre>

Hat man z.B. für User <tt>hans</tt> die Kalender <tt>home</tt> und <tt>work</tt> und für User <tt>maria</tt> den Kalender <tt>home</tt> und möchte diese aus derselben Thunderbird-Instanz benutzen, können folgende URL's in Thundebrird konfiguriert werden:

* '''<tt><nowiki>https://cal.example.org/caldav.php/hans/home</nowiki></tt>'''
* '''<tt><nowiki>https://cal1.example.org/caldav.php/hans/work</nowiki></tt>'''
* '''<tt><nowiki>https://cal2.example.org/caldav.php/maria/home</nowiki></tt>'''

== URL Rewriting für kürzere URL's ==

TODO: .htaccess Beispiel

== Weiterführende Links ==

* WIKI von DAViCal: http://wiki.davical.org
** [http://wiki.davical.org/w/CalDAV_Clients CalDAV Clients]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:DAViCal]]

DAViCal installieren

2011-04-17T11:24:06Z

Dfr00-hs.wiki: Kapitelnumerierung

{{HSDoku-Links}}

== Allgemein ==
=== Beschreibung ===
[http://www.davical.org/ DAViCal] ist ein Server für die Verwaltung von Kalendern über das [http://caldav.calconnect.org/ CalDAV-Protokoll]. Die Kalenderdaten können mit allen CalDAV-fähigen CLient-Programmen gelesen und geschrieben werden, z.B. Thunderbird mit [http://www.mozilla.org/projects/calendar/lightning/ Lightning], Evolution, Mulberry oder iCal / iPhone.

Das CalDAV-Protokoll wird im Wesentlichen breiter unterstützt, als es die Clients bisher unterstützen. Serien, Erinnerungen, Einladungen, Ressourcen, Arbeitsgruppen etc. sind alle Bestandteil der Features.

Die Software ist in PHP geschrieben, lizensiert unter GPL.

Es werden auch Kalender über das WebDAV-Protokoll untersützt, hier wird aber eine Nur-Lesemodus empfohlen.

=== Voraussetzungen ===

DAViCal setzt technisch voraus:
* PostgreSQL
* Webserver mit PHP5
* Perl für den Installationsvorgang

Die Installations-Anleitung auf der Projekt-Homepage geht davon aus, daß mal als Administrator auf den Server zugreifen kann. Die Anleitung hier beschreibt, wie man konkret DAViCal in der Shared Hosting Umgebung bei Hostsharing installiert und betreibt.

== Installation ==

=== Design ===

Diese Installationsanleitung beschreibt, wie DAViCal in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. Installation in einer Subdomain im <tt>sub</tt>-Verzeichnis müssen kleine Anpassungen vorgenommen werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von den übrigen Domaininhalten isoliert werden kann, z.B. php-Konfiguration oder auch anderen Domain-Admin.

=== Subdomain aufschalten ===

Wie in [[Verwalten_der_Zonendaten]] beschrieben das Zonefile der Domain anpassen um die Subdomain explizit den DNS-Servern zu delegieren und dann über [[Hsadmin]] die Subdomain anzulegen und einem Domain-Admin zuzuordnen.

Für diese Anleitung werden folgende Daten als Konvention angenommen

{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| (Sub)-Domain || <tt>cal.example.org</tt> || Die Sub-Domain unter der der DAViCal-Server betrieben wird
|-
| Domain-Admin || <tt>xyz00-hans</tt> || Der User, dem die Sub-Domain delegiert wurde
|}

=== Quellen ===

Für DAViCal werden neben dem eigentlichen Sourcecode des Projekts noch die PHP-Library [http://andrew.mcmillan.net.nz/projects/awl ''Andrew's Web Libraries''] benötigt. Beides findet sich auf derselben Webseite.

Die jeweils neuste Versionen befinden sich unter
* DAViCal: http://debian.mcmillan.net.nz/packages/davical/
* AWL: http://debian.mcmillan.net.nz/packages/awl/

Hier jeweils die Source-Dateien *.tar.gz benutzen

==== Download ====

<pre><nowiki>
$ cd /home/doms/cal.example.org/var
$ wget http://debian.mcmillan.net.nz/packages/awl/awl-0.46.tar.gz
$ wget http://debian.mcmillan.net.nz/packages/davical/davical-0.9.9.4.tar.gz
</nowiki></pre>

==== Auspacken ====
Um die Dateien für den Betrieb in der Serverumgebung lesbar zu machen wird die Dateierzeungsmaske temporär auf 022 gesetzt.

Symbolische Links erzeugen generische Verzeichnise <tt>davical</tt> und <tt>awl</tt>, die auf die jeweils installierte Version zeigen. Dies erleichtert spätere Versionswechsel.
<pre><nowiki>
$ umask 022
$ tar xfvz awl-0.46.tar.gz
$ tar xfvz davical-0.9.9.4.tar.gz
$ ln -s awl-0.46 awl
$ ln -s davical-0.9.9.4 davical
$ umask 077
</nowiki></pre>

=== PostgreSQL vorbereiten ===

Es wird eine eigene PostgreSQL-Datenbank benötigt, sowie 2 Datenbanknutzer.

==== Datenbank und -Nutzer anlegen ====
{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| DB-Admin || <tt>xyz00_davical_dba</tt> || Der PostgreSQL-Nutzer, dem die Datenbank gehört und administrative Tätigkeiten durchführt
|-
| DB-Nutzer || <tt>xyz00_davical_app</tt> || Der PostgreSQL-Nutzer, der über DAViCal auf die Datenbank lesen/schreibend zugreift
|-
| Datenbank || <tt>xyz00_davical</tt> || Die Datenbank, die alle Daten für den DAViCal-Server enthält
|}

==== Umgebungsvariablen und <tt>.pgpass</tt> ====
Die Nutzer und die Datenbank können über [[Hsadmin]] angelegt werden. Dabei wird <tt>xyz00_davical_dba</tt> als Datenbank-Besitzer angegeben. Als Zeichensatz <tt>UTF-8</tt> (Default) auswählen.

Sowohl für die weitere Installation, als auch für den Betrieb des Servers ist es am besten die Passwörter in die <tt>[http://www.postgresql.org/docs/9.0/interactive/libpq-pgpass.html .pgpass]</tt>-Datei zu schreiben, dann müssen sie nicht innerhalb der PHP-Dateien angebenen werden, bzw. während der Installation manuell eingegeben werden.

<pre><nowiki>
$ echo "localhost:5432:*:xyz00_davical_dba:geheimes_passwort" >> ~/.pgpass
$ echo "localhost:5432:*:xyz00_davical_app:geheimes_passwort" >> ~/.pgpass
$ chmod 0600 ~/.pgpass
</nowiki></pre>

Darüberhinaus werden noch Umgebungsvariablen gesetzt, so daß beim Aufruf von <tt>psql</tt> über die Kommandozeile Datenbankname/Nutzer nicht eingegeben werden müssen. Diese Angaben sind nach Beenden der Shell-Sitzung automatisch zurückgesetzt.

<pre><nowiki>
$ PGHOST=localhost
$ PGUSER=xyz00_davical_dba
$ PGDATABASE=xyz00_davical
$ export PGHOST PGUSER PGDATABASE
</nowiki></pre>

==== PL/pgSQL installieren ====

In der Datenbank wird die prozedurale Sprache PL/pgSQL benötigt. Diese kann folgendermaßen angelegt werden:

<pre><nowiki>
$ psql -A -c "CREATE LANGUAGE plpgsql;"
</nowiki></pre>

=== Datenbank-Tabellen anlegen und initialisieren ===

DAViCal enthält ein eigenes Installations-Skript, das die PostgreSQL-Tabellen anlegt und initialisiert. Dies liegt unter <tt>davical/dba/create-database.sh</tt>. Hier wird aber davon ausgegegangen, daß man Adminrechte hat, was in der Shared-Hosting-Umgebung nicht der Fall ist.

Das Anlegen der Datenbank, der -Nuter und kreieren von PL/pgSQL wurde bereits oben beschrieben. Darüberhinaus sind noch folgende Befehle auszuführen. Diese können in dieser Form einfach nacheinander ausgeführt werden, wenn wie oben beschrieben die <tt>PG*</tt> Umgebungsvariablen gesetzt wurden und die <tt>.pgpass</tt>-Datei gefüllt wurde.

<pre><nowiki>
$ psql -A -f awl/dba/awl-tables.sql
$ psql -A -f awl/dba/schema-management.sql
$ psql -A -f davical/dba/davical.sql
$ ./davical/dba/update-davical-database –dbhost=${PGHOST} –dbuser=${PGUSER} –dbname=${PGDATABASE} --appuser=${PGDATABASE}_app
The database is version 8.4 currently at revision 1.2.9.
No patches were applied.
Supported locales updated.
Updated view: dav_principal.sql applied.
CalDAV functions updated.
RRULE functions updated.
Database permissions updated.
$ psql -A -f davical/dba/base-data.sql
</nowiki></pre>

Für den DAViCal-Admin muß noch ein Passwort gesetzt werden – '<tt>**</tt>' vor dem Passwort ist hier wichtig.

<pre><nowiki>
$ psql -A -c "UPDATE usr SET password = '**geheim' WHERE user_no = 1;"
</nowiki></pre>

=== Konfiguration ===

DAViCal kann über eine <tt>config.php</tt> konfigriert werden. Eine Beispiel-Datei ist unten abgebildet. Details sind im [http://wiki.davical.org/w/Configuration DAViCal-Wiki] zu finden.

<pre><nowiki>
$ cat > davical/config/config.php
$c->pg_connect[] = "dbname=xyz00_davical user=xyz00_davical_app host=localhost";
$c->use_persistent = true;
$c->sysabbr = 'cal@example.org';
$c->admin_email = 'admin@cal.example.org';
$c->system_name = 'CalDAV Server example.org';
$c->default_locale = 'de_DE';
$c->template_usr = array( 'active' => true,
'locale' => 'de_DE',
'date_format_type' => 'E',
'email_ok' => date('Y-m-d')
);
^D
</nowiki></pre>

=== Fast-CGI Patch ===

Bei der Benutzung von Fast-CGI werden die HTTP_AUTHORIZATION Header normalerweise nicht weitergeleitet. Dieses Problem wird auch im DAViCal-Wiki in einem entsprechenden [http://wiki.davical.org/w/FastCGI FAQ-Eintrag] behandelt, aber dort unter der Annahme gelöst, daß man Adminrechte hat.

In der Shared-Hosting-Umgebung von Hostsharing kann dies auch über ein Redirect in der <tt>.htaccess</tt>-Datei gemacht gelöst werden:

<pre><nowiki>
$ cd /home/doms/cal.example.org/htdocs-ssl
$ cat >> .htaccess
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
^D
</nowiki></pre>

Diese Regel muß die letzte in der <tt>.htaccess</tt> sein. Die Datei muß für alle lesbar sein:

<pre><nowiki>
$ chmod 0644 .htaccess
</nowiki></pre>

Darüberhinaus muß noch die Datei <tt>davical/inc/HTTPAuthSession.php</tt> angepasst werden. Hier ist die Variable <tt>$_SERVER["AUTHORIZATION"]</tt> ersetzt werden durch <tt>$_SERVER["REDIRECT_HTTP_AUTHORIZATION"]</tt>. Außerdem gibt es noch einen Bug: Es wird an einer Stelle <tt>split()</tt> statt <tt>explode</tt> benutzt. <tt>split()</tt> ist seit PHP 5.3.0 ''deprecated''.

@@ -87,8 +87,8 @@
/**
* Get HTTP Auth to work with PHP+FastCGI
*/
- if (isset($_SERVER["AUTHORIZATION"]) && !empty($_SERVER["AUTHORIZATION"])) {
- list ($type, $cred) = split (" ", $_SERVER['AUTHORIZATION']);
+ if (isset($_SERVER["REDIRECT_HTTP_AUTHORIZATION"]) && !empty($_SERVER["REDIRECT_HTTP_AUTHORIZATION"])) {
+ list ($type, $cred) = explode (" ", $_SERVER['REDIRECT_HTTP_AUTHORIZATION']);
if ($type == 'Basic') {
list ($user, $pass) = explode (":", base64_decode($cred));
$_SERVER['PHP_AUTH_USER'] = $user; }

[[Bild:DAViCAl-home.png‎|miniatur|400px|right|Screenshot DAViCal Einloggen]]
=== Webspace aktivieren ===

Schließlich muß die Installation noch mit dem Webspace verknüpft werden.
<pre><nowiki>
$ cd /home/doms/cal.example.org
$ rm htdocs-ssl
$ ln -s var/davical/htdocs htdocs-ssl
</nowiki></pre>

Wenn alles richtig gemacht wurde, erscheint der Login-Screen.

== Nutzung ==

=== User anlegen und konfigurieren ===

Im User-Interface muß man sich als Admin (oder Nutzer mit Adminrechten) einloggen um neue Nutzer anzulegen.

Um einen neuen Nutzer anzulegen: '''Menu''' → '''User Functions''' → '''Create Principal'''

{| class="wikitable"
|- class="hintergrundfarbe5"
! Feld !! Wert !! Beschreibung
|-
| Principal ID || ''New Principal'' || Bei neuen Nutzern wird das Feld automatisch beim Anlegen gefüllt
|-
| Username || hans || Nutzername für den Kalender. Der Username ist Bestandteil der Kalender-URL
|-
| Change Password || geheimespasswort ||
|-
| Confirm Password || geheimespasswort ||
|-
| Fullname || Hans Meier || Der Name des Nutzers
|-
| Email Address || hans@example.org || Über die Email-Adresse ist der Nutzer für andere Nutzer im System zu finden, z.B. für Einladungen
|-
| Locale || Deutsch ||
|-
| Date Format Style || European ||
|-
| Principal Type || Person || Üblicherweise Person für einen natürlichen Nutzer (hier können auch Ressourcen und Gruppen angelegt werden)
|-
| Administrator || – || Falls der User Adminrechte bekommen soll
|-
| Active || X || Soll der Nutzer aktiv geführt werden?
|}

Beim Anlegen des '''ersten''' Nutzers erscheint eine Fehlermeldung:

ERROR: SQL error "23505" - ERROR: duplicate key value violates unique constraint "principal_pkey""
Home calendar added. 

Dies ist ein Bug. Siehe auch [http://lists.morphoss.com/pipermail/davical-dev/2011/000117.html Thread in Dev-Mailingliste].

Zum Umgehen des Bugs einfach den Nutzer nochmal anlegen und dann funktioniert alles ;-)

=== Zugriff über Client-Programme ===

TODO: Beispiel Thunderbird

== URL Rewriting für kürzere URL's ==

TODO: .htaccess Beispiel

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:DAViCal]]

DAViCal installieren

2011-04-17T10:01:21Z

Dfr00-hs.wiki: User anlegen und konfigurieren

{{HSDoku-Links}}

== DAViCal ==
=== Allgemein ===
==== Beschreibung ====
[http://www.davical.org/ DAViCal] ist ein Server für die Verwaltung von Kalendern über das [http://caldav.calconnect.org/ CalDAV-Protokoll]. Die Kalenderdaten können mit allen CalDAV-fähigen CLient-Programmen gelesen und geschrieben werden, z.B. Thunderbird mit [http://www.mozilla.org/projects/calendar/lightning/ Lightning], Evolution, Mulberry oder iCal / iPhone.

Das CalDAV-Protokoll wird im Wesentlichen breiter unterstützt, als es die Clients bisher unterstützen. Serien, Erinnerungen, Einladungen, Ressourcen, Arbeitsgruppen etc. sind alle Bestandteil der Features.

Die Software ist in PHP geschrieben, lizensiert unter GPL.

Es werden auch Kalender über das WebDAV-Protokoll untersützt, hier wird aber eine Nur-Lesemodus empfohlen.

==== Voraussetzungen ====

DAViCal setzt technisch voraus:
* PostgreSQL
* Webserver mit PHP5
* Perl für den Installationsvorgang

Die Installations-Anleitung auf der Projekt-Homepage geht davon aus, daß mal als Administrator auf den Server zugreifen kann. Die Anleitung hier beschreibt, wie man konkret DAViCal in der Shared Hosting Umgebung bei Hostsharing installiert und betreibt.

=== Installation ===

==== Design ====

Diese Installationsanleitung beschreibt, wie DAViCal in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. Installation in einer Subdomain im <tt>sub</tt>-Verzeichnis müssen kleine Anpassungen vorgenommen werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von den übrigen Domaininhalten isoliert werden kann, z.B. php-Konfiguration oder auch anderen Domain-Admin.

==== Subdomain aufschalten ====

Wie in [[Verwalten_der_Zonendaten]] beschrieben das Zonefile der Domain anpassen um die Subdomain explizit den DNS-Servern zu delegieren und dann über [[Hsadmin]] die Subdomain anzulegen und einem Domain-Admin zuzuordnen.

Für diese Anleitung werden folgende Daten als Konvention angenommen

{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| (Sub)-Domain || <tt>cal.example.org</tt> || Die Sub-Domain unter der der DAViCal-Server betrieben wird
|-
| Domain-Admin || <tt>xyz00-hans</tt> || Der User, dem die Sub-Domain delegiert wurde
|}

==== Quellen ====

Für DAViCal werden neben dem eigentlichen Sourcecode des Projekts noch die PHP-Library [http://andrew.mcmillan.net.nz/projects/awl ''Andrew's Web Libraries''] benötigt. Beides findet sich auf derselben Webseite.

Die jeweils neuste Versionen befinden sich unter
* DAViCal: http://debian.mcmillan.net.nz/packages/davical/
* AWL: http://debian.mcmillan.net.nz/packages/awl/

Hier jeweils die Source-Dateien *.tar.gz benutzen

===== Download =====
<pre><nowiki>
$ cd /home/doms/cal.example.org/var
$ wget http://debian.mcmillan.net.nz/packages/awl/awl-0.46.tar.gz
$ wget http://debian.mcmillan.net.nz/packages/davical/davical-0.9.9.4.tar.gz
</nowiki></pre>

===== Auspacken =====
Um die Dateien für den Betrieb in der Serverumgebung lesbar zu machen wird die Dateierzeungsmaske temporär auf 022 gesetzt.

Symbolische Links erzeugen generische Verzeichnise <tt>davical</tt> und <tt>awl</tt>, die auf die jeweils installierte Version zeigen. Dies erleichtert spätere Versionswechsel.
<pre><nowiki>
$ umask 022
$ tar xfvz awl-0.46.tar.gz
$ tar xfvz davical-0.9.9.4.tar.gz
$ ln -s awl-0.46 awl
$ ln -s davical-0.9.9.4 davical
$ umask 077
</nowiki></pre>

==== PostgreSQL vorbereiten ====

Es wird eine eigene PostgreSQL-Datenbank benötigt, sowie 2 Datenbanknutzer.

===== Datenbank und -Nutzer anlegen =====
{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| DB-Admin || <tt>xyz00_davical_dba</tt> || Der PostgreSQL-Nutzer, dem die Datenbank gehört und administrative Tätigkeiten durchführt
|-
| DB-Nutzer || <tt>xyz00_davical_app</tt> || Der PostgreSQL-Nutzer, der über DAViCal auf die Datenbank lesen/schreibend zugreift
|-
| Datenbank || <tt>xyz00_davical</tt> || Die Datenbank, die alle Daten für den DAViCal-Server enthält
|}

===== Umgebungsvariablen und <tt>.pgpass</tt> =====
Die Nutzer und die Datenbank können über [[Hsadmin]] angelegt werden. Dabei wird <tt>xyz00_davical_dba</tt> als Datenbank-Besitzer angegeben. Als Zeichensatz <tt>UTF-8</tt> (Default) auswählen.

Sowohl für die weitere Installation, als auch für den Betrieb des Servers ist es am besten die Passwörter in die <tt>[http://www.postgresql.org/docs/9.0/interactive/libpq-pgpass.html .pgpass]</tt>-Datei zu schreiben, dann müssen sie nicht innerhalb der PHP-Dateien angebenen werden, bzw. während der Installation manuell eingegeben werden.

<pre><nowiki>
$ echo "localhost:5432:*:xyz00_davical_dba:geheimes_passwort" >> ~/.pgpass
$ echo "localhost:5432:*:xyz00_davical_app:geheimes_passwort" >> ~/.pgpass
$ chmod 0600 ~/.pgpass
</nowiki></pre>

Darüberhinaus werden noch Umgebungsvariablen gesetzt, so daß beim Aufruf von <tt>psql</tt> über die Kommandozeile Datenbankname/Nutzer nicht eingegeben werden müssen. Diese Angaben sind nach Beenden der Shell-Sitzung automatisch zurückgesetzt.

<pre><nowiki>
$ PGHOST=localhost
$ PGUSER=xyz00_davical_dba
$ PGDATABASE=xyz00_davical
$ export PGHOST PGUSER PGDATABASE
</nowiki></pre>

===== PL/pgSQL installieren =====

In der Datenbank wird die prozedurale Sprache PL/pgSQL benötigt. Diese kann folgendermaßen angelegt werden:

<pre><nowiki>
$ psql -A -c "CREATE LANGUAGE plpgsql;"
</nowiki></pre>

==== Datenbank-Tabellen anlegen und initialisieren ====

DAViCal enthält ein eigenes Installations-Skript, das die PostgreSQL-Tabellen anlegt und initialisiert. Dies liegt unter <tt>davical/dba/create-database.sh</tt>. Hier wird aber davon ausgegegangen, daß man Adminrechte hat, was in der Shared-Hosting-Umgebung nicht der Fall ist.

Das Anlegen der Datenbank, der -Nuter und kreieren von PL/pgSQL wurde bereits oben beschrieben. Darüberhinaus sind noch folgende Befehle auszuführen. Diese können in dieser Form einfach nacheinander ausgeführt werden, wenn wie oben beschrieben die <tt>PG*</tt> Umgebungsvariablen gesetzt wurden und die <tt>.pgpass</tt>-Datei gefüllt wurde.

<pre><nowiki>
$ psql -A -f awl/dba/awl-tables.sql
$ psql -A -f awl/dba/schema-management.sql
$ psql -A -f davical/dba/davical.sql
$ ./davical/dba/update-davical-database –dbhost=${PGHOST} –dbuser=${PGUSER} –dbname=${PGDATABASE} --appuser=${PGDATABASE}_app
The database is version 8.4 currently at revision 1.2.9.
No patches were applied.
Supported locales updated.
Updated view: dav_principal.sql applied.
CalDAV functions updated.
RRULE functions updated.
Database permissions updated.
$ psql -A -f davical/dba/base-data.sql
</nowiki></pre>

Für den DAViCal-Admin muß noch ein Passwort gesetzt werden – '<tt>**</tt>' vor dem Passwort ist hier wichtig.

<pre><nowiki>
$ psql -A -c "UPDATE usr SET password = '**geheim' WHERE user_no = 1;"
</nowiki></pre>

==== Konfiguration ====

DAViCal kann über eine <tt>config.php</tt> konfigriert werden. Eine Beispiel-Datei ist unten abgebildet. Details sind im [http://wiki.davical.org/w/Configuration DAViCal-Wiki] zu finden.

<pre><nowiki>
$ cat > davical/config/config.php
$c->pg_connect[] = "dbname=xyz00_davical user=xyz00_davical_app host=localhost";
$c->use_persistent = true;
$c->sysabbr = 'cal@example.org';
$c->admin_email = 'admin@cal.example.org';
$c->system_name = 'CalDAV Server example.org';
$c->default_locale = 'de_DE';
$c->template_usr = array( 'active' => true,
'locale' => 'de_DE',
'date_format_type' => 'E',
'email_ok' => date('Y-m-d')
);
^D
</nowiki></pre>

==== Fast-CGI Patch ====

Bei der Benutzung von Fast-CGI werden die HTTP_AUTHORIZATION Header normalerweise nicht weitergeleitet. Dieses Problem wird auch im DAViCal-Wiki in einem entsprechenden [http://wiki.davical.org/w/FastCGI FAQ-Eintrag] behandelt, aber dort unter der Annahme gelöst, daß man Adminrechte hat.

In der Shared-Hosting-Umgebung von Hostsharing kann dies auch über ein Redirect in der <tt>.htaccess</tt>-Datei gemacht gelöst werden:

<pre><nowiki>
$ cd /home/doms/cal.example.org/htdocs-ssl
$ cat >> .htaccess
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
^D
</nowiki></pre>

Diese Regel muß die letzte in der <tt>.htaccess</tt> sein. Die Datei muß für alle lesbar sein:

<pre><nowiki>
$ chmod 0644 .htaccess
</nowiki></pre>

Darüberhinaus muß noch die Datei <tt>davical/inc/HTTPAuthSession.php</tt> angepasst werden. Hier ist die Variable <tt>$_SERVER["AUTHORIZATION"]</tt> ersetzt werden durch <tt>$_SERVER["REDIRECT_HTTP_AUTHORIZATION"]</tt>. Außerdem gibt es noch einen Bug: Es wird an einer Stelle <tt>split()</tt> statt <tt>explode</tt> benutzt. <tt>split()</tt> ist seit PHP 5.3.0 ''deprecated''.

@@ -87,8 +87,8 @@
/**
* Get HTTP Auth to work with PHP+FastCGI
*/
- if (isset($_SERVER["AUTHORIZATION"]) && !empty($_SERVER["AUTHORIZATION"])) {
- list ($type, $cred) = split (" ", $_SERVER['AUTHORIZATION']);
+ if (isset($_SERVER["REDIRECT_HTTP_AUTHORIZATION"]) && !empty($_SERVER["REDIRECT_HTTP_AUTHORIZATION"])) {
+ list ($type, $cred) = explode (" ", $_SERVER['REDIRECT_HTTP_AUTHORIZATION']);
if ($type == 'Basic') {
list ($user, $pass) = explode (":", base64_decode($cred));
$_SERVER['PHP_AUTH_USER'] = $user; }

[[Bild:DAViCAl-home.png‎|miniatur|400px|right|Screenshot DAViCal Einloggen]]
==== Webspace aktivieren ====

Schließlich muß die Installation noch mit dem Webspace verknüpft werden.
<pre><nowiki>
$ cd /home/doms/cal.example.org
$ rm htdocs-ssl
$ ln -s var/davical/htdocs htdocs-ssl
</nowiki></pre>

Wenn alles richtig gemacht wurde, erscheint der Login-Screen.

=== Nutzung ===

==== User anlegen und konfigurieren ====

Im User-Interface muß man sich als Admin (oder Nutzer mit Adminrechten) einloggen um neue Nutzer anzulegen.

Um einen neuen Nutzer anzulegen: '''Menu''' → '''User Functions''' → '''Create Principal'''

{| class="wikitable"
|- class="hintergrundfarbe5"
! Feld !! Wert !! Beschreibung
|-
| Principal ID || ''New Principal'' || Bei neuen Nutzern wird das Feld automatisch beim Anlegen gefüllt
|-
| Username || hans || Nutzername für den Kalender. Der Username ist Bestandteil der Kalender-URL
|-
| Change Password || geheimespasswort ||
|-
| Confirm Password || geheimespasswort ||
|-
| Fullname || Hans Meier || Der Name des Nutzers
|-
| Email Address || hans@example.org || Über die Email-Adresse ist der Nutzer für andere Nutzer im System zu finden, z.B. für Einladungen
|-
| Locale || Deutsch ||
|-
| Date Format Style || European ||
|-
| Principal Type || Person || Üblicherweise Person für einen natürlichen Nutzer (hier können auch Ressourcen und Gruppen angelegt werden)
|-
| Administrator || – || Falls der User Adminrechte bekommen soll
|-
| Active || X || Soll der Nutzer aktiv geführt werden?
|}

Beim Anlegen des '''ersten''' Nutzers erscheint eine Fehlermeldung:

ERROR: SQL error "23505" - ERROR: duplicate key value violates unique constraint "principal_pkey""
Home calendar added. 

Dies ist ein Bug. Siehe auch [http://lists.morphoss.com/pipermail/davical-dev/2011/000117.html Thread in Dev-Mailingliste].

Zum Umgehen des Bugs einfach den Nutzer nochmal anlegen und dann funktioniert alles ;-)

==== Zugriff über Client-Programme ====

TODO: Beispiel Thunderbird

=== URL Rewriting für kürzere URL's ===

TODO: .htaccess Beispiel

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:DAViCal]]

DAViCal installieren

2011-04-17T09:38:29Z

Dfr00-hs.wiki: Screenshot hinzugefügt

{{HSDoku-Links}}

== DAViCal ==
=== Allgemein ===
==== Beschreibung ====
[http://www.davical.org/ DAViCal] ist ein Server für die Verwaltung von Kalendern über das [http://caldav.calconnect.org/ CalDAV-Protokoll]. Die Kalenderdaten können mit allen CalDAV-fähigen CLient-Programmen gelesen und geschrieben werden, z.B. Thunderbird mit [http://www.mozilla.org/projects/calendar/lightning/ Lightning], Evolution, Mulberry oder iCal / iPhone.

Das CalDAV-Protokoll wird im Wesentlichen breiter unterstützt, als es die Clients bisher unterstützen. Serien, Erinnerungen, Einladungen, Ressourcen, Arbeitsgruppen etc. sind alle Bestandteil der Features.

Die Software ist in PHP geschrieben, lizensiert unter GPL.

Es werden auch Kalender über das WebDAV-Protokoll untersützt, hier wird aber eine Nur-Lesemodus empfohlen.

==== Voraussetzungen ====

DAViCal setzt technisch voraus:
* PostgreSQL
* Webserver mit PHP5
* Perl für den Installationsvorgang

Die Installations-Anleitung auf der Projekt-Homepage geht davon aus, daß mal als Administrator auf den Server zugreifen kann. Die Anleitung hier beschreibt, wie man konkret DAViCal in der Shared Hosting Umgebung bei Hostsharing installiert und betreibt.

=== Installation ===

==== Design ====

Diese Installationsanleitung beschreibt, wie DAViCal in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. Installation in einer Subdomain im <tt>sub</tt>-Verzeichnis müssen kleine Anpassungen vorgenommen werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von den übrigen Domaininhalten isoliert werden kann, z.B. php-Konfiguration oder auch anderen Domain-Admin.

==== Subdomain aufschalten ====

Wie in [[Verwalten_der_Zonendaten]] beschrieben das Zonefile der Domain anpassen um die Subdomain explizit den DNS-Servern zu delegieren und dann über [[Hsadmin]] die Subdomain anzulegen und einem Domain-Admin zuzuordnen.

Für diese Anleitung werden folgende Daten als Konvention angenommen

{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| (Sub)-Domain || <tt>cal.example.org</tt> || Die Sub-Domain unter der der DAViCal-Server betrieben wird
|-
| Domain-Admin || <tt>xyz00-hans</tt> || Der User, dem die Sub-Domain delegiert wurde
|}

==== Quellen ====

Für DAViCal werden neben dem eigentlichen Sourcecode des Projekts noch die PHP-Library [http://andrew.mcmillan.net.nz/projects/awl ''Andrew's Web Libraries''] benötigt. Beides findet sich auf derselben Webseite.

Die jeweils neuste Versionen befinden sich unter
* DAViCal: http://debian.mcmillan.net.nz/packages/davical/
* AWL: http://debian.mcmillan.net.nz/packages/awl/

Hier jeweils die Source-Dateien *.tar.gz benutzen

===== Download =====
<pre><nowiki>
$ cd /home/doms/cal.example.org/var
$ wget http://debian.mcmillan.net.nz/packages/awl/awl-0.46.tar.gz
$ wget http://debian.mcmillan.net.nz/packages/davical/davical-0.9.9.4.tar.gz
</nowiki></pre>

===== Auspacken =====
Um die Dateien für den Betrieb in der Serverumgebung lesbar zu machen wird die Dateierzeungsmaske temporär auf 022 gesetzt.

Symbolische Links erzeugen generische Verzeichnise <tt>davical</tt> und <tt>awl</tt>, die auf die jeweils installierte Version zeigen. Dies erleichtert spätere Versionswechsel.
<pre><nowiki>
$ umask 022
$ tar xfvz awl-0.46.tar.gz
$ tar xfvz davical-0.9.9.4.tar.gz
$ ln -s awl-0.46 awl
$ ln -s davical-0.9.9.4 davical
$ umask 077
</nowiki></pre>

==== PostgreSQL vorbereiten ====

Es wird eine eigene PostgreSQL-Datenbank benötigt, sowie 2 Datenbanknutzer.

===== Datenbank und -Nutzer anlegen =====
{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| DB-Admin || <tt>xyz00_davical_dba</tt> || Der PostgreSQL-Nutzer, dem die Datenbank gehört und administrative Tätigkeiten durchführt
|-
| DB-Nutzer || <tt>xyz00_davical_app</tt> || Der PostgreSQL-Nutzer, der über DAViCal auf die Datenbank lesen/schreibend zugreift
|-
| Datenbank || <tt>xyz00_davical</tt> || Die Datenbank, die alle Daten für den DAViCal-Server enthält
|}

===== Umgebungsvariablen und <tt>.pgpass</tt> =====
Die Nutzer und die Datenbank können über [[Hsadmin]] angelegt werden. Dabei wird <tt>xyz00_davical_dba</tt> als Datenbank-Besitzer angegeben. Als Zeichensatz <tt>UTF-8</tt> (Default) auswählen.

Sowohl für die weitere Installation, als auch für den Betrieb des Servers ist es am besten die Passwörter in die <tt>[http://www.postgresql.org/docs/9.0/interactive/libpq-pgpass.html .pgpass]</tt>-Datei zu schreiben, dann müssen sie nicht innerhalb der PHP-Dateien angebenen werden, bzw. während der Installation manuell eingegeben werden.

<pre><nowiki>
$ echo "localhost:5432:*:xyz00_davical_dba:geheimes_passwort" >> ~/.pgpass
$ echo "localhost:5432:*:xyz00_davical_app:geheimes_passwort" >> ~/.pgpass
$ chmod 0600 ~/.pgpass
</nowiki></pre>

Darüberhinaus werden noch Umgebungsvariablen gesetzt, so daß beim Aufruf von <tt>psql</tt> über die Kommandozeile Datenbankname/Nutzer nicht eingegeben werden müssen. Diese Angaben sind nach Beenden der Shell-Sitzung automatisch zurückgesetzt.

<pre><nowiki>
$ PGHOST=localhost
$ PGUSER=xyz00_davical_dba
$ PGDATABASE=xyz00_davical
$ export PGHOST PGUSER PGDATABASE
</nowiki></pre>

===== PL/pgSQL installieren =====

In der Datenbank wird die prozedurale Sprache PL/pgSQL benötigt. Diese kann folgendermaßen angelegt werden:

<pre><nowiki>
$ psql -A -c "CREATE LANGUAGE plpgsql;"
</nowiki></pre>

==== Datenbank-Tabellen anlegen und initialisieren ====

DAViCal enthält ein eigenes Installations-Skript, das die PostgreSQL-Tabellen anlegt und initialisiert. Dies liegt unter <tt>davical/dba/create-database.sh</tt>. Hier wird aber davon ausgegegangen, daß man Adminrechte hat, was in der Shared-Hosting-Umgebung nicht der Fall ist.

Das Anlegen der Datenbank, der -Nuter und kreieren von PL/pgSQL wurde bereits oben beschrieben. Darüberhinaus sind noch folgende Befehle auszuführen. Diese können in dieser Form einfach nacheinander ausgeführt werden, wenn wie oben beschrieben die <tt>PG*</tt> Umgebungsvariablen gesetzt wurden und die <tt>.pgpass</tt>-Datei gefüllt wurde.

<pre><nowiki>
$ psql -A -f awl/dba/awl-tables.sql
$ psql -A -f awl/dba/schema-management.sql
$ psql -A -f davical/dba/davical.sql
$ ./davical/dba/update-davical-database –dbhost=${PGHOST} –dbuser=${PGUSER} –dbname=${PGDATABASE} --appuser=${PGDATABASE}_app
The database is version 8.4 currently at revision 1.2.9.
No patches were applied.
Supported locales updated.
Updated view: dav_principal.sql applied.
CalDAV functions updated.
RRULE functions updated.
Database permissions updated.
$ psql -A -f davical/dba/base-data.sql
</nowiki></pre>

Für den DAViCal-Admin muß noch ein Passwort gesetzt werden – '<tt>**</tt>' vor dem Passwort ist hier wichtig.

<pre><nowiki>
$ psql -A -c "UPDATE usr SET password = '**geheim' WHERE user_no = 1;"
</nowiki></pre>

==== Konfiguration ====

DAViCal kann über eine <tt>config.php</tt> konfigriert werden. Eine Beispiel-Datei ist unten abgebildet. Details sind im [http://wiki.davical.org/w/Configuration DAViCal-Wiki] zu finden.

<pre><nowiki>
$ cat > davical/config/config.php
$c->pg_connect[] = "dbname=xyz00_davical user=xyz00_davical_app host=localhost";
$c->use_persistent = true;
$c->sysabbr = 'cal@example.org';
$c->admin_email = 'admin@cal.example.org';
$c->system_name = 'CalDAV Server example.org';
$c->default_locale = 'de_DE';
$c->template_usr = array( 'active' => true,
'locale' => 'de_DE',
'date_format_type' => 'E',
'email_ok' => date('Y-m-d')
);
^D
</nowiki></pre>

==== Fast-CGI Patch ====

Bei der Benutzung von Fast-CGI werden die HTTP_AUTHORIZATION Header normalerweise nicht weitergeleitet. Dieses Problem wird auch im DAViCal-Wiki in einem entsprechenden [http://wiki.davical.org/w/FastCGI FAQ-Eintrag] behandelt, aber dort unter der Annahme gelöst, daß man Adminrechte hat.

In der Shared-Hosting-Umgebung von Hostsharing kann dies auch über ein Redirect in der <tt>.htaccess</tt>-Datei gemacht gelöst werden:

<pre><nowiki>
$ cd /home/doms/cal.example.org/htdocs-ssl
$ cat >> .htaccess
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
^D
</nowiki></pre>

Diese Regel muß die letzte in der <tt>.htaccess</tt> sein. Die Datei muß für alle lesbar sein:

<pre><nowiki>
$ chmod 0644 .htaccess
</nowiki></pre>

Darüberhinaus muß noch die Datei <tt>davical/inc/HTTPAuthSession.php</tt> angepasst werden. Hier ist die Variable <tt>$_SERVER["AUTHORIZATION"]</tt> ersetzt werden durch <tt>$_SERVER["REDIRECT_HTTP_AUTHORIZATION"]</tt>. Außerdem gibt es noch einen Bug: Es wird an einer Stelle <tt>split()</tt> statt <tt>explode</tt> benutzt. <tt>split()</tt> ist seit PHP 5.3.0 ''deprecated''.

@@ -87,8 +87,8 @@
/**
* Get HTTP Auth to work with PHP+FastCGI
*/
- if (isset($_SERVER["AUTHORIZATION"]) && !empty($_SERVER["AUTHORIZATION"])) {
- list ($type, $cred) = split (" ", $_SERVER['AUTHORIZATION']);
+ if (isset($_SERVER["REDIRECT_HTTP_AUTHORIZATION"]) && !empty($_SERVER["REDIRECT_HTTP_AUTHORIZATION"])) {
+ list ($type, $cred) = explode (" ", $_SERVER['REDIRECT_HTTP_AUTHORIZATION']);
if ($type == 'Basic') {
list ($user, $pass) = explode (":", base64_decode($cred));
$_SERVER['PHP_AUTH_USER'] = $user; }

[[Bild:DAViCAl-home.png‎|miniatur|400px|right|Screenshot DAViCal Einloggen]]
==== Webspace aktivieren ====

Schließlich muß die Installation noch mit dem Webspace verknüpft werden.
<pre><nowiki>
$ cd /home/doms/cal.example.org
$ rm htdocs-ssl
$ ln -s var/davical/htdocs htdocs-ssl
</nowiki></pre>

Wenn alles richtig gemacht wurde, erscheint der Login-Screen.

=== Nutzung ===

==== User anlegen und konfigurieren ====

TODO: UI einloggen

TODO: User anlegen

==== Zugriff über Client-Programme ====

TODO: Beispiel Thunderbird

=== URL Rewriting für kürzere URL's ===

TODO: .htaccess Beispiel

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:DAViCal]]

Datei:DAViCAl-home.png

2011-04-17T09:36:57Z

Dfr00-hs.wiki: hat eine neue Version von „Datei:DAViCAl-home.png“ hochgeladen: weiße Fläche verringert

DAViCal Login Screen

Datei:DAViCAl-home.png

2011-04-17T09:09:13Z

Dfr00-hs.wiki: DAViCal Login Screen

DAViCal Login Screen