Ecartis Installieren

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen

Mailinglisten mit ecartis

Es ist möglich, in seinem Paket Mailinglisten mit dem Listenmanager ecartis zu benutzen. Einmalige Einrichtung wahlweise zentral für das Paket bzw. einzelne Domains

ecartis

Einrichten

Initial muss dafür das Skript add-mailinglist aufgerufen werden, welches im Paketverzeichnis ein neues Verzeichnis mailinglist erstellt, in dem sich dann alle Dateien für die Mailinglisten befinden.

Aufruf:

add-mailinglist

Damit ist der Listenmanager zentral für das Paket vorbereitet, d.h. benötigte Dateien wurden in das Verzeichnis ~/mailinglist kopiert. Außerdem wurden Aliase zur Ansteuerung des Listenmanagers in die ~/etc/aliases eingefügt.

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis des Listenmanagers befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

Konfiguration

ecartis.cfg

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

virtusertable

Entsprechend des Eintrages ecartis-address fügt man in der virtusertable der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

mehrere Listenmanager

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der ~/etc/aliases eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

Test

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann. Einrichten einer Mailingliste

Mailinglisten

Einrichten

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man in seine ~/etc/aliases mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

~/etc/aliases

Wir tragen jetzt in unsere ~/etc/aliases folgendes ein:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

example.com/etc/virtusertable

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die virtusertable der Domain (Bsp: example.com/etc/virtusertable für die Domain example.com:

testmailingliste@example.com xyz00-testmailingliste testmailingliste-request@example.com xyz00-testmailingliste-request testmailingliste-repost@example.com xyz00-testmailingliste-repost testmailingliste-admins@example.com xyz00-testmailingliste-admins testmailingliste-moderators@example.com xyz00-testmailingliste-moderators testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann. Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.


Konfiguration

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

  • list-owner = der Eigentümer der Liste
  • subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
  • description = eine Beschreibung der Liste
  • reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
  • administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
  • humanize-mime = false
  • humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.
  • mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
  • subscribe-mode = hier gibt es 3 mögliche Einstellungen:

1. open Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen 2. confirm Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen 3. closed Die Anmeldung muss vom Listenadmin erlaubt werden

  • unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:

1. open Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen 2. confirm Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen 3. closed Die Abmeldung muss vom Listenadmin erlaubt werden

Unterschiedliche Mailinglistentypen

offene Liste

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net). Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

geschlossene Liste

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

moderierte Liste

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

  • moderated = yes
  • moderate-include-queue = true
  • moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

Autorisierung

Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

post-password = geheimesPasswort

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.