Benutzer-Werkzeuge

Webseiten-Werkzeuge


konfiguration

Dies ist eine alte Version des Dokuments!


Konfiguration

Die Konfiguration der Archivierung (benno-archive) wird in der Datei /etc/benno/benno.xml vorgenommen, während die Einstellungen für das Web-Interface (benno-web) in der Datei /etc/benno-web/benno.conf erfolgt.

Basis-Konfiguration

Für ein lauffähiges System muss nach der Installation ausschließlich das Passwort für die Kommunikation zwischen Benno REST und Benno Web gesetzt werden. In der Date /etc/benno/benno.xml erfolgt dieses im Abschnitt

 <bennoRest>
   <jettyConfig>/etc/benno/jetty.xml</jettyConfig>
   <sharedSecret>nichtzuerratendeslaengerespasswort</sharedSecret>
   <indexCacheTTL>300000</indexCacheTTL>
 </bennoRest>

Das Passwort wird im Tag sharedSecret / festgelegt. Parallel dazu wird dieser Wert in der Datei /etc/benno-web/benno.conf im Parameter

SHARED_SECRET = nichtzuerratendeslaengerespasswort

im Kopf der Datei eingestellt. Bei beiden Dateien sollte darauf geachtet werden, dass diese im Falle der /etc/benno/benno.xml ausschließlich für den Benutzer „benno“ und im Falle der /etc/benno-web/benno.conf nur für den Benutzer des Webservers (z.B. „www-data“ oder „wwwrun“) lesbar ist.

Spezielle Einstellungen

E-Mail Adressen filtern

In einigen Fällen ist es notwendig, dass E-Mails an spezielle Adressen (z.B. die E-Mail Adressen des Betriebsrats) nicht in die Archivierung aufgenommen werden. Hierfür wird in der /etc/benno/benno.xml ein entsprechender Filter definiert.

<conditions>
  <not> 
    <or>  
      <address sender="true" recipient="true" from="true" to="true" cc="true">betriebsrat@lw-systems.net</address>
      <address sender="true" recipient="true" from="true" to="true" cc="true">betriebsrat@lw-systems.com</address>
    </or>
  </not>
</conditions>

Hier werden E-Mails von oder an die Adressen betriebstrat@lw-systems.net oder betriebsrat@lw-systems.com nicht in die Archivierung aufgenommen.

Falls nur einzelne Adressen archiviert werden sollen, werden die „<not />“ Tags weggelassen.

<conditions>
  <or>
    <address sender="true" recipient="true" from="true" to="true" cc="true">buchhaltung@lw-systems.net</address>
    <address sender="true" recipient="true" from="true" to="true" cc="true">buchhaltung@lw-systems.com</address>
  </or>
</conditions>

Die Bedingungen innerhalb des address /-Tags sind per OR verknüpft.

Neben der Möglichkeit auf einzelne Adressen zu filtern, kann dieses auch auf Basis der Domain erfolgen. Hier sind die folgenden Kriterien möglich:

  • <address />
  • <domain />

Die einzelnen Tags können mit den Verknüpfungsoperatoren <and />, <or /> und <not /> verbunden werden.

Envelope-Header

Eine E-Mail kann unter Umständen nicht alle Informationen über die E-Mail enthalten. Die BCC-Empfänger einer E-Maill werden unter Umständen nur im SMTP Protokoll durch die Envelope-Informationen übermittelt.

Falls die Informationen mit Hilfe eines Headers in der E-Mail gespeichert sind, kann Benno MailArchiv diese Informationen auswerten. Die Konfiguration erfolgt in der benno.xml.

             <mailfile>
               <senderheaders>
                  <name>X-REAL-MAILFROM</name>
                  <name>RECIPIENT-FROM</name>
                  <name>From</name>
               </senderheaders>
               <recipientheaders>
                  <name>X-REAL-RCPTTO</name>
                  <name>RECIPIENT-TO</name>
                  <name>BCC</name>
                  <name>To</name>
                  <name>Cc</name>
               </recipientheaders>
               <secretheaders>
                  <name>X-REAL-MAILFROM</name>
                  <name>RECIPIENT-FROM</name>
                  <name>X-REAL-RCPTTO</name>
                  <name>RECIPIENT-TO</name>
                  <name>BCC</name>
                  <name>SIMPLE-Test-header</name>
               </secretheaders>
            </mailfile>

Die Zuordnung von Sender- und Empfängerdaten erfolgt innerhalb der Tags <senderheaders /> bzw. <recipientheaders />.

Alle Header, die im Tag <secretheaders /> aufgeführt sind, werden vor dem Speichern aus der E-Mail entfernt. Diese Informationen sind ausschließlich im Index und im Header der Datei im Repository vorhanden.

konfiguration.1484061185.txt.gz · Zuletzt geändert: 2017/01/10 15:13 von lwsystems